Konfiguraatio

Mukautetut sivuasetukset

Metatietojen tuonnin jälkeen siirry kohtaan BM > Merchant Tools > Site Preferences > Custom Preferences.

Screenshot — Custom Preferences menu

Valitse Kleep:

Screenshot — Kleep preferences group

Asetus	Kuvaus
`kleepRetailerUUID`	Pakollinen. Jälleenmyyjäsi yksilöllinen tunniste Kleep-alustalla, jonka Kleep-tilinhallintajasi toimittaa. On syötettävä manuaalisesti — se lähetetään jokaisessa Kleep API -kutsussa ja sitä käytetään Suositus-iframen `domain`-parametrina tilisi selvittämiseen. Ei automaattista varavaihtoehtoa: jos jätetään tyhjäksi, seuranta, Suositus-ominaisuus ja iframe eivät toimi (konfigurointivirhe ilmoitetaan).
`isKleepRecommendationEnabled`	Ota käyttöön/poista käytöstä Kleep-painike PDP:ssä. Ei vaikuta seurantaan tai työvienteihin.
`kleepButtonColor`	Painikkeen väri (musta tai valkoinen). Ohita CSS:llä mukautettua tyyliä varten.
`kleepFontFamily`	Fonttiperhe Kleep-painikkeelle ja iFramelle.
`kleepCountryCode`	Markkina / Maakoodi (ISO 3166 A-2).

Palvelut

Löytyy kohdasta Administration > Operations > Services:

Screenshot — Services list

kleep.sftp — Lähettää vientitiedostot SFCC WebDAVista Kleep SFTP:hen. Korvaa käyttäjä Kleepin toimittamalla käyttäjällä sekä .p12-sertifikaatilla. Älä aseta salasanaa.

Screenshot — kleep.sftp service details

kleep — Käytetään kaikkiin muihin ominaisuuksiin. Ei tarvita käyttäjää/salasanaa — pyyntö todennetaan kleepRetailerUUID-sivuasetuksella, joka lähetetään jokaisen Kleep API -kutsun kuormassa tilisi selvittämiseksi.

Yksityinen avain ja sertifikaatti

Siirry kohtaan Administration > Operations > Private Keys and Certificates:

Napsauta Import
Napsauta Select ja valitse Kleepin toimittama .p12-tiedosto
Käytä kleep aliaksena
Napsauta Save

Screenshot — Import certificate

Tuloksen pitäisi näyttää tältä — sen on oltava voimassa ja nimettynä kleep:

Screenshot — Imported certificate

Vientityöt

Siirry kohtaan Administration > Operations > Jobs. Kaksi työtä on esikonfiguroitu:

KleepExportProductsCSV — vie sivustosi tuotteet
KleepExportOrdersCSV — vie asiakkaidesi tilaushistorian

Screenshot — Export jobs list

Molemmat ovat oletuksena poissa käytöstä. Ota ne käyttöön ajamaan kerran päivässä:

Screenshot — Enabling an export job

Yhteiset asetukset (molemmat työt)

Siirry Job Steps -välilehdelle → napsauta RefArch valitaksesi sivustot, joissa käytät Kleepiä.

Timeout — sekuntia ennen viennin pysäyttämistä
OrdersMaxToExport — vietävien tilausten enimmäismäärä (vain tilaustyö)

Screenshot — GenerateOrdersCSV step parameters

KleepExportProductsCSV-asetukset

Screenshot — KleepExportProductsCSV job steps

Parametri	Kuvaus	Oletus
`SkipMaster`	Ohita päätuotteiden vienti	Pois käytöstä
`OnlineOnly`	Vie vain verkkotuotteet	Pois käytöstä
`ExportType`	Delta (vain päivitetty edellisen viennin jälkeen) tai Full	Delta
`MainViewType`	Tuotekuvien kuvanäkymätyyppi. Käytä samaa kuin PDP:ssä.	`large`
`Locale`	Viennin tietty kielialue. Käyttää oletusta, jos tyhjä.	—

Vietyjen tuotteiden määrä voi ylittää käsiteltyjen määrän. Tämä tapahtuu, kun luokittelemattomat tuotteet sisällytetään luokitellun VariationGroupin kautta.

Varmista, että MainViewType-parametri vastaa kauppasi konfiguraatiota. Väärä näkymätyyppi johtaa puuttuviin tuotekuviin, joita tarvitaan tekoälyanalyysiä varten.

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 (apuohjelmatyö)

Kolmas työ, KleepResetLastExported, on tarjolla pakottamaan tilausten täydellinen uudelleenvienti. Sen ResetKleepExportAttributes-vaihe tyhjentää viennin seurantaattribuutit jokaisesta tilauksesta (kleepLastExported → tyhjä, isKleepExported → false), jotta ne noudetaan uudelleen seuraavalla KleepExportOrdersCSV-ajokerralla. Se on oletuksena poissa käytöstä ja tarkoitettu ajettavaksi manuaalisesti tarpeen mukaan (esim. Kleep-puolen tietojen nollauksen jälkeen). Se ei ota parametreja.

Reaaliaikaiset varastotarkistukset

Kleep kyselee varastoja reaaliaikaisesti välttääkseen loppuunmyytyjen kokojen suosittelemisen. Konfiguroi pääsy käyttämällä yhtä alla olevista kahdesta menetelmästä.

Epävarma kumpi valita? OCAPI on perinteinen lähestymistapa Business Manager Data API:lla. SCAPI (IAS) on uudempi Salesforce Commerce API Inventory Availability Servicellä. Kysy Salesforce-järjestelmänvalvojaltasi, jos et ole varma.

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

Käytä tätä, jos esiintymäsi perustuu OCAPI:in varastonhallinnassa.Vaihe 1 — Avaa OCAPI-asetuksetSiirry kohtaan Administration > Site Development > Open Commerce API Settings ja muokkaa Data API -asetuksia.Vaihe 2 — Määritä asiakastunnusTestausta varten:

"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

Tuotantoa varten luo uusi asiakastunnus Salesforce-dokumentaation mukaan. Videoläpikäynti.Vaihe 3 — Konfiguroi resurssien käyttöoikeusLisää tämä OCAPI Data API -konfiguraatioihisi:

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

Vaihe 4 — Lähetä tunnistetiedot Kleepille

Asiakastunnus
Asiakassalaisuus
Varastotunnukset (yksi per markkina — toimita kartoituksesi)
Tuotannon SBX-URL (varastotarkistukset ovat käytössä vain tuotannossa)

Käytä tätä, jos esiintymäsi käyttää SCAPI:a Inventory Availability Servicen (IAS) / Omnichannel Inventoryn (OCI) kanssa.Vaihe 1 — Luo API-asiakas

Kirjaudu sisään Salesforce Account Manageriin.
Napsauta API Client → Add API Client.
Näyttönimi: esim. Kleep Inventory.
Token Endpoint Auth Method: client_secret_post.
Access Token Format: JWT.
Allowed Scopes: sfcc.inventory.availability
Määritä organisaatiollesi.
Tallenna. Kopioi asiakastunnus ja asiakassalaisuus — salaisuus näytetään vain kerran.

SCAPI- ja OCAPI-asiakkaita ei voi jakaa. Jokainen API-kehys vaatii oman asiakkaansa.

Vaihe 2 — Kerää esiintymätunnisteet

Tunniste	Mistä löytää	Esimerkki
Short Code	BM > Administration > Site Development > Salesforce Commerce API Settings	`kv7kzm78`
Organization ID	Sama sivu tai 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`

Vaihe 3 — Lähetä tunnistetiedot Kleepille

Asiakastunnus ja asiakassalaisuus
Short Code
Organization ID
Tenant ID
Location Group(s) (yksi per markkina — toimita kartoituksesi)

Tervetuloa

CMS

Mobiili

Tiedot

Tietosuoja

Mukautetut sivuasetukset

Palvelut

Yksityinen avain ja sertifikaatti