Konfiguration

Benutzerdefinierte Site-Preferences

Gehen Sie nach dem Metadaten-Import zu BM > Merchant Tools > Site Preferences > Benutzerdefinierte Preferences.

Screenshot — Custom Preferences menu

Wählen Sie Kleep:

Screenshot — Kleep preferences group

Preference	Beschreibung
`kleepRetailerUUID`	Obligatorisch. 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).
`isKleepRecommendationEnabled`	Kleep-Schaltfläche im PDP aktivieren/deaktivieren. Hat keinen Einfluss auf Tracking oder Job-Exporte.
`kleepButtonColor`	Schaltflächenfarbe (Schwarz oder Weiß). Über CSS für benutzerdefiniertes Styling überschreiben.
`kleepFontFamily`	Schriftfamilie für die Kleep-Schaltfläche und den iFrame.
`kleepCountryCode`	Markt / Ländercode (ISO 3166 A-2).

Services

Zu finden unter Administration > Operations > Services:

Screenshot — Services list

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.

Screenshot — kleep.sftp service details

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:

Klicken Sie auf Import
Klicken Sie auf Select und wählen Sie die von Kleep bereitgestellte .p12-Datei
Verwenden Sie kleep als Alias
Klicken Sie auf Save

Screenshot — Import certificate

Das Ergebnis sollte so aussehen — es muss gültig sein und kleep heißen:

Screenshot — Imported certificate

Export-Jobs

Gehen Sie zu Administration > Operations > Jobs. Zwei Jobs sind vorkonfiguriert:

KleepExportProductsCSV — exportiert die Produkte Ihrer Site
KleepExportOrdersCSV — exportiert die Bestellhistorie Ihrer Kunden

Screenshot — Export jobs list

Beide sind standardmäßig deaktiviert. Aktivieren Sie sie für einen täglichen Lauf:

Screenshot — Enabling an export job

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)

Screenshot — GenerateOrdersCSV step parameters

KleepExportProductsCSV-Einstellungen

Screenshot — KleepExportProductsCSV job steps

Parameter	Beschreibung	Standard
`SkipMaster`	Master-Produktexporte ignorieren	Deaktiviert
`OnlineOnly`	Nur Online-Produkte exportieren	Deaktiviert
`ExportType`	Delta (nur seit letztem Export aktualisiert) oder Full	Delta
`MainViewType`	Bildansichtstyp für Produktbilder. Verwenden Sie denselben wie auf Ihrem PDP.	`large`
`Locale`	Spezifische 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.

Screenshot — SFTPUpload step parameters (products)

The TargetFolder parameter of each SFTP upload step must match the folder structure expected by Kleep’s ingestion pipeline. For example, a dev store might use dev/products instead of products. See the SFTP Data Structure documentation for the complete directory layout.

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.

OCAPI (Open Commerce API)
SCAPI — Inventory Availability Service (IAS)

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)

Verwenden Sie diese Option, wenn Ihre Instanz SCAPI mit dem Inventory Availability Service (IAS) / Omnichannel Inventory (OCI) verwendet.Schritt 1 — API-Client erstellen

Melden Sie sich beim Salesforce Account Manager an.
Klicken Sie auf API Client → API-Client hinzufügen.
Anzeigename: z. B. Kleep Inventory.
Token Endpoint Auth Method: client_secret_post.
Access Token Format: JWT.
Allowed Scopes: sfcc.inventory.availability
Ihrer Organisation zuweisen.
Speichern. Kopieren Sie Client-ID und Client-Secret — das Secret wird nur einmal angezeigt.

SCAPI- und OCAPI-Clients können nicht geteilt werden. Jedes API-Framework benötigt seinen eigenen Client.

Schritt 2 — Instanz-Identifikatoren sammeln

Identifikator	Wo zu finden	Beispiel
Short Code	BM > Administration > Site Development > Salesforce Commerce API Settings	`kv7kzm78`
Organization ID	Gleiche Seite oder Account Manager	`f_ecom_zzzz_prd`
Tenant ID	Account Manager > Organizations	`zzzz_prd`
Location Group(s)	BM > Merchant Tools > Inventory > Inventory Availability	`WAREHOUSE_FR`, `WAREHOUSE_US`

Schritt 3 — Zugangsdaten an Kleep senden

Client-ID & Client-Secret
Short Code
Organization ID
Tenant ID
Location Group(s) (eine pro Markt — stellen Sie Ihr Mapping bereit)

Willkommen

CMS

Mobil

Daten

Datenschutz

Benutzerdefinierte Site-Preferences

Services

Privater Schlüssel & Zertifikat