Passer au contenu principal

​
Préférences de site personnalisées

Après l’import des métadonnées, accédez à BM > Merchant Tools > Site Preferences > Custom Preferences. image.png Sélectionnez Kleep : image.png
PréférenceDescription
kleepRetailerUUIDObligatoire. Identifiant unique de votre revendeur sur la plateforme Kleep, fourni par votre Account Manager Kleep. Doit être saisi manuellement — il est envoyé dans chaque appel API Kleep et utilisé comme paramètre domain de l’iframe de Recommandation pour résoudre votre compte. Aucun fallback automatique : s’il est vide, le tracking, la fonctionnalité de Recommandation et l’iframe ne fonctionneront pas (une erreur de configuration est déclenchée).
isKleepRecommendationEnabledActiver/désactiver le bouton Kleep sur la PDP. N’affecte pas le tracking ni les exports des jobs.
kleepButtonColorCouleur du bouton (Noir ou Blanc). Remplacez via CSS pour un style personnalisé.
kleepFontFamilyFamille de police pour le bouton Kleep et l’iFrame.
kleepCountryCodeCode marché / pays (ISO 3166 A-2).

​
Services

Disponibles dans Administration > Operations > Services : image.png kleep.sftp — Envoie les fichiers d’export depuis le WebDAV SFCC vers le SFTP Kleep. Remplacez l’utilisateur par celui fourni par Kleep, ainsi que le certificat .p12. Ne définissez aucun mot de passe. image.png kleep — Utilisé pour toutes les autres fonctionnalités. Aucun identifiant nécessaire — la requête est authentifiée par la préférence de site kleepRetailerUUID, envoyée dans le payload de chaque appel API Kleep pour résoudre votre compte.

​
Clé privée et certificat

Accédez à Administration > Operations > Private Keys and Certificates :
  1. Cliquez sur Import
  2. Cliquez sur Select et choisissez le fichier .p12 fourni par Kleep
  3. Utilisez kleep comme alias
  4. Cliquez sur Save
image.png Le résultat doit ressembler à ceci — il doit être valide et nommé kleep : image.png

​
Jobs d’export

Accédez à Administration > Operations > Jobs. Deux jobs sont préconfigurés :
  • KleepExportProductsCSV — exporte les produits de votre site
  • KleepExportOrdersCSV — exporte l’historique des commandes de vos clients
image.png Les deux sont désactivés par défaut. Activez-les pour qu’ils s’exécutent une fois par jour : image.png

​
Paramètres communs (les deux jobs)

Accédez à l’onglet Job Steps → cliquez sur RefArch pour sélectionner les sites où vous utilisez Kleep.
  • Timeout — secondes avant l’arrêt de l’export
  • OrdersMaxToExport — nombre maximum de commandes à exporter (job commandes uniquement)
image.png

​
Paramètres de KleepExportProductsCSV

image.png
ParamètreDescriptionDéfaut
SkipMasterIgnorer les exports de produits masterDésactivé
OnlineOnlyExporter uniquement les produits en ligneDésactivé
ExportTypeDelta (uniquement mis à jour depuis le dernier export) ou FullDelta
MainViewTypeType de vue d’image pour les images produits. Utilisez le même que sur votre PDP.large
LocaleLocale spécifique pour l’export. Utilise la valeur par défaut si vide.—
Le nombre de produits exportés peut dépasser le nombre traité. Cela se produit lorsque des produits non catégorisés sont inclus via leur association avec un VariationGroup catégorisé.
Assurez-vous que le paramètre MainViewType correspond à la configuration de votre boutique. Un type de vue incorrect entraîne des images produits manquantes, qui sont nécessaires pour l’analyse IA.
image.png

​
KleepResetLastExported (job utilitaire)

Un troisième job, KleepResetLastExported, est fourni pour forcer un re-export complet des commandes. Son étape ResetKleepExportAttributes efface les attributs de suivi d’export sur chaque commande (kleepLastExported → vide, isKleepExported → false) afin qu’ils soient repris lors de la prochaine exécution de KleepExportOrdersCSV. Il est désactivé par défaut et destiné à être exécuté manuellement, à la demande (par exemple, après une réinitialisation des données côté Kleep). Il ne prend aucun paramètre.

​
Vérifications de stock en temps réel

Kleep interroge les stocks en temps réel pour éviter de recommander des tailles en rupture de stock. Configurez l’accès en utilisant l’une des deux méthodes ci-dessous.
Vous ne savez pas laquelle choisir ? OCAPI est l’approche traditionnelle utilisant l’API Data du Business Manager. SCAPI (IAS) est la nouvelle Salesforce Commerce API avec le service de disponibilité des stocks (Inventory Availability Service). Demandez à votre administrateur Salesforce en cas de doute.
Utilisez cette méthode si votre instance s’appuie sur OCAPI pour la gestion des stocks.Étape 1 — Ouvrir les paramètres OCAPIAccédez à Administration > Site Development > Open Commerce API Settings, puis modifiez les paramètres de l’API Data.Étape 2 — Configurer le Client IDPour les tests :
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
Pour la production, générez un nouveau client ID conformément à la documentation Salesforce. Tutoriel vidéo.Étape 3 — Configurer l’accès aux ressourcesAjoutez ceci à vos configurations de l’API OCAPI Data :
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
Étape 4 — Envoyer les identifiants à Kleep
  • Client ID
  • Client Secret
  • IDs d’inventaire (un par marché — fournissez votre mapping)
  • URL SBX de production (les vérifications de stock ne sont activées qu’en production)