Konfiguration

Anpassade webbplatsinställningar

Efter metadataimport, gå till BM > Merchant Tools > Site Preferences > Custom Preferences.

Screenshot — Custom Preferences menu

Välj Kleep:

Screenshot — Kleep preferences group

Inställning	Beskrivning
`kleepRetailerUUID`	Obligatorisk. Unik identifierare för din återförsäljare på Kleep-plattformen, tillhandahållen av din Kleep Account Manager. Måste anges manuellt — den skickas i varje Kleep API-anrop och används som `domain`-parametern i Recommendation-iframen för att lösa ditt konto. Ingen automatisk reservlösning: om den lämnas tom kommer spårning, rekommendationsfunktionen och iframen inte att fungera (ett konfigurationsfel uppstår).
`isKleepRecommendationEnabled`	Aktivera/inaktivera Kleep-knappen på PDP. Påverkar inte spårning eller jobbexporter.
`kleepButtonColor`	Knappfärg (svart eller vit). Åsidosätt via CSS för anpassad stil.
`kleepFontFamily`	Typsnittsfamilj för Kleep-knappen och iFrame.
`kleepCountryCode`	Marknad / Landskod (ISO 3166 A-2).

Tjänster

Finns under Administration > Operations > Services:

Screenshot — Services list

kleep.sftp — Skickar exportfiler från SFCC WebDAV till Kleep SFTP. Ersätt användaren med den som tillhandahålls av Kleep, tillsammans med .p12-certifikatet. Ange inget lösenord.

Screenshot — kleep.sftp service details

kleep — Används för alla andra funktioner. Ingen användare/lösenord behövs — begäran autentiseras av webbplatsinställningen kleepRetailerUUID, som skickas i nyttolasten för varje Kleep API-anrop för att lösa ditt konto.

Privat nyckel och certifikat

Gå till Administration > Operations > Private Keys and Certificates:

Klicka på Import
Klicka på Select och välj .p12-filen som tillhandahålls av Kleep
Använd kleep som alias
Klicka på Save

Screenshot — Import certificate

Resultatet ska se ut så här — det måste vara giltigt och heta kleep:

Screenshot — Imported certificate

Exportjobb

Gå till Administration > Operations > Jobs. Två jobb är förkonfigurerade:

KleepExportProductsCSV — exporterar din webbplats produkter
KleepExportOrdersCSV — exporterar dina kunders orderhistorik

Screenshot — Export jobs list

Båda är inaktiverade som standard. Aktivera dem för att köras en gång per dag:

Screenshot — Enabling an export job

Gemensamma inställningar (båda jobben)

Gå till fliken Job Steps → klicka på RefArch för att välja de webbplatser där du använder Kleep.

Timeout — sekunder innan exporten stoppas
OrdersMaxToExport — maximalt antal beställningar att exportera (endast beställningsjobb)

Screenshot — GenerateOrdersCSV step parameters

Inställningar för KleepExportProductsCSV

Screenshot — KleepExportProductsCSV job steps

Parameter	Beskrivning	Standard
`SkipMaster`	Ignorera export av masterprodukter	Inaktiverad
`OnlineOnly`	Exportera enbart onlineprodukter	Inaktiverad
`ExportType`	Delta (enbart uppdaterade sedan senaste exporten) eller Full	Delta
`MainViewType`	Bildvisningstyp för produktbilder. Använd samma som din PDP.	`large`
`Locale`	Specifik locale för export. Använder standard om tomt.	—

Antalet exporterade produkter kan överstiga antalet behandlade. Detta inträffar när okategoriserade produkter inkluderas via sin koppling till en kategoriserad VariationGroup.

Se till att parametern MainViewType matchar din butikskonfiguration. En felaktig visningstyp leder till att produktbilder saknas, vilket krävs för AI-analys.

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 (verktygsjobb)

Ett tredje jobb, KleepResetLastExported, tillhandahålls för att tvinga fram en fullständig omexport av beställningar. Steget ResetKleepExportAttributes rensar exportspårningsattributen på varje beställning (kleepLastExported → tomt, isKleepExported → false) så att de hämtas upp igen vid nästa körning av KleepExportOrdersCSV. Det är inaktiverat som standard och är avsett att köras manuellt, på begäran (t.ex. efter en dataåterställning på Kleep-sidan). Det tar inga parametrar.

Lagerkontroller i realtid

Kleep kontrollerar lager i realtid för att undvika att rekommendera storlekar som är slut i lager. Konfigurera åtkomst med en av de två metoderna nedan.

Osäker på vilket alternativ du ska välja? OCAPI är det traditionella tillvägagångssättet med Business Manager Data API. SCAPI (IAS) är det nyare Salesforce Commerce API med Inventory Availability Service. Fråga din Salesforce-administratör om du är osäker.

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

Använd detta om din instans förlitar sig på OCAPI för lagerhantering.Steg 1 — Öppna OCAPI-inställningarNavigera till Administration > Site Development > Open Commerce API Settings och redigera sedan Data API-inställningarna.Steg 2 — Konfigurera klient-IDFör testning:

"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

För produktion, generera ett nytt klient-ID enligt Salesforce-dokumentationen. Videogenomgång.Steg 3 — Konfigurera resursåtkomstLägg till detta i dina OCAPI Data API-konfigurationer:

Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*

Steg 4 — Skicka uppgifter till Kleep

Client ID
Client Secret
Inventory IDs (ett per marknad — ange din mappning)
Production SBX URL (lagerkontroller aktiveras endast i produktion)

Använd detta om din instans använder SCAPI med Inventory Availability Service (IAS) / Omnichannel Inventory (OCI).Steg 1 — Skapa en API-klient

Logga in på Salesforce Account Manager.
Klicka på API Client → Add API Client.
Visningsnamn: t.ex. Kleep Inventory.
Token Endpoint Auth Method: client_secret_post.
Access Token Format: JWT.
Allowed Scopes: sfcc.inventory.availability
Tilldela till din organisation.
Spara. Kopiera Client ID och Client Secret — hemligheten visas bara en gång.

SCAPI- och OCAPI-klienter kan inte delas. Varje API-ramverk kräver sin egen klient.

Steg 2 — Samla instansidentifierare

Identifierare	Var hittar du det	Exempel
Short Code	BM > Administration > Site Development > Salesforce Commerce API Settings	`kv7kzm78`
Organization ID	Samma sida, eller 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`

Steg 3 — Skicka uppgifter till Kleep

Client ID & Client Secret
Short Code
Organization ID
Tenant ID
Location Group(s) (ett per marknad — ange din mappning)

Välkommen

CMS

Mobil

Data

Integritet

Anpassade webbplatsinställningar

Tjänster

Privat nyckel och certifikat