Zum Hauptinhalt springen

​
Benutzerdefinierte Site-Preferences

Gehen Sie nach dem Metadaten-Import zu BM > Merchant Tools > Site Preferences > Benutzerdefinierte Preferences. image.png Wählen Sie Kleep: image.png
PreferenceBeschreibung
kleepRetailerUUIDObligatorisch. Eindeutiger Identifikator für Ihren Händler auf der Kleep-Plattform, bereitgestellt von Ihrem Kleep Account Manager. Muss manuell eingegeben werden — er wird in jedem Kleep-API-Aufruf gesendet und als domain-Parameter des Empfehlungs-iFrames verwendet, um Ihr Konto aufzulösen. Kein automatischer Fallback: Wenn leer gelassen, funktionieren Tracking, die Empfehlungsfunktion und der iFrame nicht (ein Konfigurationsfehler wird ausgelöst).
isKleepRecommendationEnabledKleep-Schaltfläche im PDP aktivieren/deaktivieren. Hat keinen Einfluss auf Tracking oder Job-Exporte.
kleepButtonColorSchaltflächenfarbe (Schwarz oder Weiß). Über CSS für benutzerdefiniertes Styling überschreiben.
kleepFontFamilySchriftfamilie für die Kleep-Schaltfläche und den iFrame.
kleepCountryCodeMarkt / Ländercode (ISO 3166 A-2).

​
Services

Zu finden unter Administration > Operations > Services: image.png kleep.sftp — Sendet Exportdateien von SFCC WebDAV an Kleep SFTP. Ersetzen Sie den Benutzer durch den von Kleep bereitgestellten, zusammen mit dem .p12-Zertifikat. Legen Sie kein Passwort fest. image.png kleep — Wird für alle anderen Funktionen verwendet. Kein Benutzer/Passwort erforderlich — die Anfrage wird durch die Site-Preference kleepRetailerUUID authentifiziert, die im Payload jedes Kleep-API-Aufrufs gesendet wird, um Ihr Konto aufzulösen.

​
Privater Schlüssel & Zertifikat

Gehen Sie zu Administration > Operations > Private Keys and Certificates:
  1. Klicken Sie auf Import
  2. Klicken Sie auf Select und wählen Sie die von Kleep bereitgestellte .p12-Datei
  3. Verwenden Sie kleep als Alias
  4. Klicken Sie auf Save
image.png Das Ergebnis sollte so aussehen — es muss gültig sein und kleep heißen: image.png

​
Export-Jobs

Gehen Sie zu Administration > Operations > Jobs. Zwei Jobs sind vorkonfiguriert:
  • KleepExportProductsCSV — exportiert die Produkte Ihrer Site
  • KleepExportOrdersCSV — exportiert die Bestellhistorie Ihrer Kunden
image.png Beide sind standardmäßig deaktiviert. Aktivieren Sie sie für einen täglichen Lauf: image.png

​
Gemeinsame Einstellungen (beide Jobs)

Gehen Sie zum Tab Job Steps → klicken Sie auf RefArch, um die Sites auszuwählen, auf denen Sie Kleep verwenden.
  • Timeout — Sekunden vor dem Stopp des Exports
  • OrdersMaxToExport — maximale Anzahl zu exportierender Bestellungen (nur Bestellungs-Job)
image.png

​
KleepExportProductsCSV-Einstellungen

image.png
ParameterBeschreibungStandard
SkipMasterMaster-Produktexporte ignorierenDeaktiviert
OnlineOnlyNur Online-Produkte exportierenDeaktiviert
ExportTypeDelta (nur seit letztem Export aktualisiert) oder FullDelta
MainViewTypeBildansichtstyp für Produktbilder. Verwenden Sie denselben wie auf Ihrem PDP.large
LocaleSpezifische Locale für den Export. Verwendet Standard, wenn leer.—
Die Anzahl der exportierten Produkte kann die Anzahl der verarbeiteten übersteigen. Dies tritt auf, wenn nicht kategorisierte Produkte durch ihre Zugehörigkeit zu einer kategorisierten VariationGroup einbezogen werden.
Stellen Sie sicher, dass der Parameter MainViewType mit der Konfiguration Ihres Shops übereinstimmt. Ein falscher Ansichtstyp führt zu fehlenden Produktbildern, die für die KI-Analyse erforderlich sind.
image.png

​
KleepResetLastExported (Hilfsjob)

Ein dritter Job, KleepResetLastExported, wird bereitgestellt, um einen vollständigen Re-Export von Bestellungen zu erzwingen. Sein Schritt ResetKleepExportAttributes löscht die Export-Tracking-Attribute bei jeder Bestellung (kleepLastExported → leer, isKleepExported → false), sodass sie beim nächsten KleepExportOrdersCSV-Lauf erneut erfasst werden. Er ist standardmäßig deaktiviert und ist für den manuellen Betrieb auf Anfrage vorgesehen (z. B. nach einem datenseitigen Reset bei Kleep). Er benötigt keine Parameter.

​
Live-Bestandsprüfungen

Kleep fragt Bestände live ab, um das Empfehlen nicht vorrätiger Größen zu vermeiden. Konfigurieren Sie den Zugang mit einer der beiden folgenden Methoden.
Nicht sicher, welche Sie wählen sollen? OCAPI ist der traditionelle Ansatz mit der Business Manager Data API. SCAPI (IAS) ist die neuere Salesforce Commerce API mit dem Inventory Availability Service. Fragen Sie Ihren Salesforce-Administrator, falls Sie unsicher sind.
Verwenden Sie diese Option, wenn Ihre Instanz OCAPI für die Bestandsverwaltung nutzt.Schritt 1 — OCAPI-Einstellungen öffnenNavigieren Sie zu Administration > Site Development > Open Commerce API Settings und bearbeiten Sie dann die Data-API-Einstellungen.Schritt 2 — Client-ID einrichtenZum Testen:
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
Für die Produktion generieren Sie eine neue Client-ID gemäß der Salesforce-Dokumentation. Video-Walkthrough.Schritt 3 — Ressourcenzugriff konfigurierenFügen Sie dies zu Ihren OCAPI Data-API-Konfigurationen hinzu:
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
Schritt 4 — Zugangsdaten an Kleep senden
  • Client-ID
  • Client-Secret
  • Inventar-IDs (eine pro Markt — stellen Sie Ihr Mapping bereit)
  • Produktions-SBX-URL (Bestandsprüfungen sind nur in der Produktion aktiviert)