Przejdź do głównej treści

​
Niestandardowe preferencje witryny

Po zaimportowaniu metadanych przejdź do BM > Merchant Tools > Site Preferences > Custom Preferences. image.png Wybierz Kleep: image.png
PreferencjaOpis
kleepRetailerUUIDObowiązkowe. Unikalny identyfikator Twojego sprzedawcy na platformie Kleep, dostarczony przez Twojego Account Managera Kleep. Należy go wprowadzić ręcznie — jest wysyłany w każdym wywołaniu API Kleep i używany jako parametr domain elementu iframe rekomendacji w celu rozwiązania Twojego konta. Brak automatycznego fallbacku: jeśli pozostanie pusty, śledzenie, funkcja rekomendacji i iframe nie będą działać (zostanie zgłoszony błąd konfiguracji).
isKleepRecommendationEnabledWłącz/wyłącz przycisk Kleep na PDP. Nie wpływa na śledzenie ani eksport zadań.
kleepButtonColorKolor przycisku (czarny lub biały). Zastąp za pomocą CSS dla niestandardowej stylizacji.
kleepFontFamilyRodzina czcionek dla przycisku Kleep i iFrame.
kleepCountryCodeKod rynku / kraju (ISO 3166 A-2).

​
Usługi

Dostępne w Administration > Operations > Services: image.png kleep.sftp — Wysyła pliki eksportu z SFCC WebDAV do Kleep SFTP. Zastąp użytkownika tym dostarczonym przez Kleep, wraz z certyfikatem .p12. Nie ustawiaj żadnego hasła. image.png kleep — Używane do wszystkich pozostałych funkcji. Nie jest wymagany żaden użytkownik/hasło — żądanie jest uwierzytelniane przez preferencję witryny kleepRetailerUUID, wysyłaną w ładunku każdego wywołania API Kleep w celu rozwiązania Twojego konta.

​
Klucz prywatny i certyfikat

Przejdź do Administration > Operations > Private Keys and Certificates:
  1. Kliknij Import
  2. Kliknij Select i wybierz plik .p12 dostarczony przez Kleep
  3. Użyj kleep jako aliasu
  4. Kliknij Save
image.png Wynik powinien wyglądać tak — musi być ważny i nazwany kleep: image.png

​
Zadania eksportu

Przejdź do Administration > Operations > Jobs. Dwa zadania są wstępnie skonfigurowane:
  • KleepExportProductsCSV — eksportuje produkty Twojej witryny
  • KleepExportOrdersCSV — eksportuje historię zamówień Twoich klientów
image.png Oba są domyślnie wyłączone. Włącz je, aby uruchamiały się raz dziennie: image.png

​
Wspólne ustawienia (oba zadania)

Przejdź do zakładki Job Steps → kliknij RefArch, aby wybrać witryny, w których używasz Kleep.
  • Timeout — sekundy przed zatrzymaniem eksportu
  • OrdersMaxToExport — maksymalna liczba zamówień do eksportu (tylko zadanie zamówień)
image.png

​
Ustawienia KleepExportProductsCSV

image.png
ParametrOpisDomyślne
SkipMasterIgnoruj eksport produktów głównychWyłączone
OnlineOnlyEksportuj tylko produkty dostępne onlineWyłączone
ExportTypeDelta (tylko zaktualizowane od ostatniego eksportu) lub PełnyDelta
MainViewTypeTyp widoku obrazu dla obrazów produktów. Użyj tego samego co na Twoim PDP.large
LocaleOkreślony język eksportu. Używa domyślnego, jeśli puste.—
Liczba eksportowanych produktów może przekraczać liczbę przetworzonych. Dzieje się tak, gdy nieskatalogowane produkty są uwzględniane poprzez ich powiązanie ze skatalogowaną VariationGroup.
Upewnij się, że parametr MainViewType pasuje do konfiguracji Twojego sklepu. Niedopasowany typ widoku prowadzi do brakujących obrazów produktów, które są wymagane do analizy AI.
image.png

​
KleepResetLastExported (zadanie pomocnicze)

Trzecie zadanie, KleepResetLastExported, jest dostarczane, aby wymusić pełny ponowny eksport zamówień. Jego krok ResetKleepExportAttributes czyści atrybuty śledzenia eksportu na każdym zamówieniu (kleepLastExported → puste, isKleepExported → false), dzięki czemu zostaną one ponownie uwzględnione przy następnym uruchomieniu KleepExportOrdersCSV. Jest domyślnie wyłączone i przeznaczone do ręcznego uruchamiania na żądanie (np. po resetowaniu danych po stronie Kleep). Nie przyjmuje żadnych parametrów.

​
Sprawdzanie stanów magazynowych na żywo

Kleep sprawdza stany magazynowe na żywo, aby uniknąć rekomendowania rozmiarów niedostępnych w magazynie. Skonfiguruj dostęp przy użyciu jednej z dwóch poniższych metod.
Nie wiesz, którą wybrać? OCAPI to tradycyjne podejście korzystające z Business Manager Data API. SCAPI (IAS) to nowszy Salesforce Commerce API z usługą dostępności zapasów (Inventory Availability Service). Zapytaj swojego administratora Salesforce, jeśli nie jesteś pewien.
Użyj tego, jeśli Twoja instancja korzysta z OCAPI do zarządzania zapasami.Krok 1 — Otwórz ustawienia OCAPIPrzejdź do Administration > Site Development > Open Commerce API Settings, a następnie edytuj ustawienia API Data.Krok 2 — Skonfiguruj Client IDDo testów:
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
Do produkcji wygeneruj nowy client ID zgodnie z dokumentacją Salesforce. Instrukcja wideo.Krok 3 — Skonfiguruj dostęp do zasobówDodaj to do konfiguracji Data API w OCAPI:
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
Krok 4 — Wyślij dane uwierzytelniające do Kleep
  • Client ID
  • Client Secret
  • Identyfikatory zapasów (jeden na rynek — podaj swoje mapowanie)
  • Produkcyjny adres URL SBX (sprawdzanie stanów magazynowych jest włączone tylko na produkcji)