> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Historia zmian

> Historia wydań kartridża SFRA

## 26.04.0 — 2026-04-28

**Przełomowe zmiany:**

* Identyfikacja sprzedawcy opiera się teraz na nowej **obowiązkowej** preferencji witryny `kleepRetailerUUID` zamiast hosta żądania. Po aktualizacji ustaw ją w **BM > Site Preferences > Kleep** — w przeciwnym razie śledzenie, funkcja rekomendacji i iframe nie będą działać.

**Ulepszenia:**

* Dodano kontekst rynku/języka do ładunku `/recommend` w celu personalizacji rekomendacji per rynek.
* Usunięto preferencję `isKleepSessionEnabled` — logika UUID sesji jest teraz zawsze aktywna.

**Poprawki:**

* Usunięto dane osobowe klientów z eksportu CSV zamówień.
* Usunięto dodatkową pustą kolumnę z eksportu CSV produktów i dostosowano format eksportu do specyfikacji struktury danych SFTP.

## 25.09.0 — 2025-09-22

* Nowa logika sesji z unikalnym UUID sesji na sesję dla KPI opartych na sesjach. Współdzielone z iFrame'ami w celu uzgodnienia śledzenia wewnętrznego/zewnętrznego.
* Obsługa wielu kategorii: Buty, Dzieci, Bielizna.
* Zunifikowana obsługa domen.
* 2 nowe niestandardowe preferencje: rynek witryny (KPI per rynek / personalizacje przepływu) i włącznik logiki sesji.
* Ulepszona niezawodność śledzenia z wyzwalaczami opartymi na postMessage.

## 24.11.2 — 2024-11-12

**Poprawki:**

* Nowy atrybut boolean `isKleepExported` w celu naprawienia niespójności zapytań o status eksportu.
* Naprawiono stringifikowany pusty obiekt w atrybutach niestandardowych (teraz pusty ciąg).

**Ulepszenia:**

* Niestandardowy parametr limitu czasu zadania (domyślnie: 900 s).
* Parametr maksymalnego limitu zamówień (domyślnie: 1000/wykonanie).
* Nowe zadanie resetowania zamówień do ponownych eksportów.
* Zamówienia są teraz zawsze eksportowane w trybie delta; pozostałe zamówienia są kontynuowane przy następnym uruchomieniu.

## 24.11.1 — 2024-11-08

* Zlokalizowany CTA PDP: FR, JA, ES, PT (PT/BR), IT, KO, DE (DE/BE), NL.
* Usunięto logo CTA PDP.

## 24.11.0 — 2024-11-06

**Poprawki:**

* Naprawiono brakujące dane kolumny `SFCC_custom_attributes` w eksportach.
* Naprawiono opcję pełnego eksportu KleepExportOrdersCSV.

**Ulepszenia:**

* Usunięto limit eksportu 1000 zamówień.
* Ulepszone rejestrowanie dla obu zadań eksportu.
* Funkcja ponawiania prób w KleepExportOrdersCSV dla nieudanych zamówień.

## 24.10.2 — 2024-10-23

* Zaktualizowano adres URL modalu rekomendacji.

## 24.10.1 — 2024-10-21

**Ulepszenia:**

* Eksport zawiera wszystkie warianty/grupy wariantów, gdy co najmniej jeden jest skatalogowany. Limit: 20 000 produktów głównych.
* Nowa kolumna CSV `SFCC_Product_VariationGroups_ID`.
* Usunięto nieużywany config `[BRAND]` w krokach zadania.
* Eksport zamówień filtrowany tylko do statusu "Exported".
* Obsługiwane wiele CTA Kleep w dowolnym miejscu na PDP. Usunięto spinner ładowania CTA.
* Sprawdzanie zapasów w czasie rzeczywistym przed zaproponowaniem produktu. Nowe zdarzenie `button_clicked`.

**Poprawki:**

* Naprawiono błąd KleepExportOrdersCSV na zamówieniach z notatkami.

## 24.10.0 — 2024-10-07

**Ulepszenia:**

* Kompatybilność API 21.2 dla adresu URL modalu rekomendacji.
* Rozmiar fragmentu eksportu 1000→100, oczyszczone puste/zduplikowane wiersze, lepsze logi, automatyczne przycinanie `MainViewType`.

**Nowe funkcje:**

* Parametr `ExportType` (Delta/Full) bez usuwania CustomObject.
* Nazwy/identyfikatory kategorii w eksporcie produktów.

**Poprawki:**

* Status zadania pokazujący "OK" w BM podczas gdy w backendzie "ERROR".
* Błąd tworzenia `KleepExportDateTracker` przy błędach zadania.
* Eksport zawiera warianty z grup wariantów, gdy produkty główne nie są skatalogowane.

## 24.9.0 — 2024-09-25

**Poprawki:** AddToCart z okna wyskakującego; brakujący `kleepLastExported` w metadanych.

**Ulepszenia:** Kompatybilność KleepExportProductsCSV z SFCC API 21.2.

## 24.8.0 — 2024-08-30

**Poprawki:** Rozwiązano błędy konsoli PDP.

**Ulepszenia:** Funkcja rekomendacji używa VariationGroups zamiast Masters.

## 24.7.0 — 2024-07-03

**Ulepszenia:** Eksport delta według daty `lastModified`. Absolutne adresy URL obrazów w śledzeniu. Zoptymalizowane wywołania API.

**Nowe funkcje:** Śledzenie zdarzeń: `product_added_to_cart`, `checkout_completed`, `checkout_validated`.

**Poprawki:** Kompilacja frontendu. Błąd eksportu zadania przy brakującym obiekcie niestandardowym.

## 24.6.0 — 2024-06-10

Pierwsze wydanie.