Vai al contenuto principale

​
Preferenze del Sito Personalizzate

Dopo l’importazione dei metadati, vai su BM > Merchant Tools > Site Preferences > Custom Preferences. image.png Seleziona Kleep: image.png
PreferenzaDescrizione
kleepRetailerUUIDObbligatorio. Identificatore univoco per il tuo retailer sulla piattaforma Kleep, fornito dal tuo Account Manager Kleep. Deve essere inserito manualmente — viene inviato in ogni chiamata API Kleep e utilizzato come parametro domain dell’iframe di Raccomandazione per risolvere il tuo account. Nessun fallback automatico: se lasciato vuoto, il tracciamento, la funzionalità di Raccomandazione e l’iframe non funzioneranno (viene generato un errore di configurazione).
isKleepRecommendationEnabledAbilita/disabilita il pulsante Kleep nella PDP. Non influisce sul tracciamento o sull’esportazione dei job.
kleepButtonColorColore del pulsante (Nero o Bianco). Sovrascrivibile tramite CSS per uno stile personalizzato.
kleepFontFamilyFont family per il pulsante Kleep e l’iFrame.
kleepCountryCodeMercato / Codice Paese (ISO 3166 A-2).

​
Servizi

Disponibili in Administration > Operations > Services: image.png kleep.sftp — Invia i file di esportazione da SFCC WebDAV all’SFTP Kleep. Sostituisci l’utente con quello fornito da Kleep, insieme al certificato .p12. Non impostare alcuna password. image.png kleep — Utilizzato per tutte le altre funzionalità. Non è necessario utente/password — la richiesta viene autenticata dalla preferenza del sito kleepRetailerUUID, inviata nel payload di ogni chiamata API Kleep per risolvere il tuo account.

​
Chiave Privata e Certificato

Vai su Administration > Operations > Private Keys and Certificates:
  1. Clicca su Import
  2. Clicca su Select e scegli il file .p12 fornito da Kleep
  3. Usa kleep come alias
  4. Clicca su Save
image.png Il risultato dovrebbe apparire così — deve essere valido e denominato kleep: image.png

​
Job di Esportazione

Vai su Administration > Operations > Jobs. Sono preconfigurati due job:
  • KleepExportProductsCSV — esporta i prodotti del tuo sito
  • KleepExportOrdersCSV — esporta la cronologia degli ordini dei tuoi clienti
image.png Entrambi sono disabilitati per impostazione predefinita. Abilitali per l’esecuzione una volta al giorno: image.png

​
Impostazioni comuni (entrambi i job)

Vai alla scheda Job Steps → clicca su RefArch per selezionare i siti dove utilizzi Kleep.
  • Timeout — secondi prima di interrompere l’esportazione
  • OrdersMaxToExport — numero massimo di ordini da esportare (solo per il job degli ordini)
image.png

​
Impostazioni KleepExportProductsCSV

image.png
ParametroDescrizionePredefinito
SkipMasterIgnora le esportazioni dei prodotti masterDisabilitato
OnlineOnlyEsporta solo i prodotti onlineDisabilitato
ExportTypeDelta (solo aggiornati dall’ultima esportazione) o FullDelta
MainViewTypeTipo di vista immagine per le immagini dei prodotti. Usa lo stesso della tua PDP.large
LocaleLocale specifico per l’esportazione. Usa il predefinito se vuoto.—
Il numero di prodotti esportati può superare il numero di prodotti elaborati. Ciò accade quando i prodotti non categorizzati vengono inclusi tramite la loro associazione con un VariationGroup categorizzato.
Assicurati che il parametro MainViewType corrisponda alla configurazione del tuo negozio. Un tipo di vista non corrispondente porta a immagini di prodotto mancanti, richieste per l’analisi AI.
image.png

​
KleepResetLastExported (job di utilità)

Un terzo job, KleepResetLastExported, viene fornito per forzare una ri-esportazione completa degli ordini. Il suo step ResetKleepExportAttributes cancella gli attributi di tracciamento dell’esportazione su ogni ordine (kleepLastExported → vuoto, isKleepExported → false) in modo che vengano acquisiti nuovamente alla prossima esecuzione di KleepExportOrdersCSV. È disabilitato per impostazione predefinita e pensato per essere eseguito manualmente, su richiesta (es. dopo un reset dei dati lato Kleep). Non richiede parametri.

​
Controlli Stock in Tempo Reale

Kleep interroga gli stock in tempo reale per evitare di raccomandare taglie esaurite. Configura l’accesso utilizzando uno dei due metodi seguenti.
Non sai quale scegliere? OCAPI è l’approccio tradizionale che utilizza la Data API di Business Manager. SCAPI (IAS) è la nuova Salesforce Commerce API con l’Inventory Availability Service. Chiedi al tuo amministratore Salesforce in caso di dubbi.
Usa questa opzione se la tua istanza si basa su OCAPI per la gestione dell’inventario.Passaggio 1 — Apri le Impostazioni OCAPIVai su Administration > Site Development > Open Commerce API Settings, poi modifica le impostazioni dell’API Data.Passaggio 2 — Configura il Client IDPer i test:
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
Per la produzione, genera un nuovo client ID secondo la documentazione Salesforce. Guida video.Passaggio 3 — Configura l’Accesso alle RisorseAggiungi questo alle tue configurazioni dell’API Data OCAPI:
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
Passaggio 4 — Invia le credenziali a Kleep
  • Client ID
  • Client Secret
  • ID inventario (uno per mercato — fornisci la tua mappatura)
  • URL SBX di produzione (i controlli stock sono abilitati solo in produzione)