> ## 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.

# Changelog

> Versionshistorie des SFRA-Cartridges

## 26.04.0 — 2026-04-28

**Breaking Changes:**

* Die Händler-Identifikation basiert nun auf der neuen **obligatorischen** Site-Preference `kleepRetailerUUID` anstelle des Request-Hosts. Setzen Sie diese nach dem Upgrade unter **BM > Site-Preferences > Kleep** — andernfalls funktionieren Tracking, die Empfehlungsfunktion und der iFrame nicht.

**Verbesserungen:**

* Markt-/Locale-Kontext zum `/recommend`-Payload für marktspezifische Empfehlungspersonalisierung hinzugefügt.
* Die Preference `isKleepSessionEnabled` wurde entfernt — die Sitzungs-UUID-Logik ist jetzt immer aktiv.

**Korrekturen:**

* Kunden-PII aus dem Bestellungs-CSV-Export entfernt.
* Eine zusätzliche leere Spalte im Produkt-CSV-Export entfernt und das Exportformat mit der SFTP-Datenstruktur-Spezifikation abgestimmt.

## 25.09.0 — 2025-09-22

* Neue Sitzungslogik mit eindeutiger Sitzungs-UUID pro Sitzung für sitzungsbasierte KPIs. Wird mit iFrames für die interne/externe Tracking-Abstimmung geteilt.
* Unterstützung für mehrere Kategorien: Schuhe, Kinder, Dessous.
* Harmonisierter Domains-Handler.
* 2 neue benutzerdefinierte Preferences: Site-Markt (marktspezifische KPIs / Flow-Personalisierungen) und Sitzungslogik-Aktivierer.
* Verbesserte Tracking-Zuverlässigkeit mit postMessage-basierten Auslösern.

## 24.11.2 — 2024-11-12

**Korrekturen:**

* Neues boolesches Attribut `isKleepExported` zur Behebung von Inkonsistenzen bei der Exportstatus-Abfrage.
* Behobenes stringifiziertes leeres Objekt in benutzerdefinierten Attributen (jetzt leerer String).

**Verbesserungen:**

* Benutzerdefinierter Job-Timeout-Parameter (Standard: 900 s).
* Maximaler Bestellungs-Limit-Parameter (Standard: 1000/Ausführung).
* Neuer Bestellungs-Reset-Job für Re-Exporte.
* Bestellungen werden jetzt immer im Delta-Modus exportiert; verbleibende Bestellungen werden beim nächsten Lauf fortgesetzt.

## 24.11.1 — 2024-11-08

* Lokalisierter PDP-CTA: FR, JA, ES, PT (PT/BR), IT, KO, DE (DE/BE), NL.
* PDP-CTA-Logo entfernt.

## 24.11.0 — 2024-11-06

**Korrekturen:**

* Fehlende `SFCC_custom_attributes`-Spaltendaten in Exporten behoben.
* Vollständige Export-Option von KleepExportOrdersCSV behoben.

**Verbesserungen:**

* 1000-Bestellungs-Exportlimit entfernt.
* Erweiterte Protokollierung für beide Export-Jobs.
* Wiederholungsfunktion in KleepExportOrdersCSV für fehlgeschlagene Bestellungen.

## 24.10.2 — 2024-10-23

* Empfehlungs-Modal-URL aktualisiert.

## 24.10.1 — 2024-10-21

**Verbesserungen:**

* Export enthält alle Varianten/Variationsgruppen, wenn mindestens eine kategorisiert ist. Kontingent: 20.000 Master.
* Neue CSV-Spalte `SFCC_Product_VariationGroups_ID`.
* Ungenutzte `[BRAND]`-Konfiguration in Job-Steps entfernt.
* Bestellungsexport auf Status „Exportiert" gefiltert.
* Mehrere Kleep-CTAs werden überall im PDP unterstützt. CTA-Ladespinner entfernt.
* Echtzeit-Bestandsprüfung vor Produktvorschlag. Neues Ereignis `button_clicked`.

**Korrekturen:**

* Absturz von KleepExportOrdersCSV bei Bestellungen mit Notizen behoben.

## 24.10.0 — 2024-10-07

**Verbesserungen:**

* API 21.2-Kompatibilität für Empfehlungs-Modal-URL.
* Export-Chunk-Größe 1000→100, leere/doppelte Zeilen bereinigt, bessere Logs, automatisches Trimmen von `MainViewType`.

**Neue Funktionen:**

* Parameter `ExportType` (Delta/Full) ohne Löschen des CustomObject.
* Kategorienamen/-IDs im Produktexport.

**Korrekturen:**

* Job-Status zeigte „OK" in BM, während Backend „ERROR" anzeigte.
* Erstellungsfehler von `KleepExportDateTracker` bei Job-Fehlern.
* Export enthält Varianten aus Variationsgruppen, wenn Master nicht kategorisiert sind.

## 24.9.0 — 2024-09-25

**Korrekturen:** AddToCart aus Pop-up; fehlendes `kleepLastExported` in Metadaten.

**Verbesserungen:** Kompatibilität von KleepExportProductsCSV mit SFCC-API 21.2.

## 24.8.0 — 2024-08-30

**Korrekturen:** PDP-Konsolenfehler behoben.

**Verbesserungen:** Empfehlungsfunktion verwendet VariationGroups anstelle von Masters.

## 24.7.0 — 2024-07-03

**Verbesserungen:** Delta-Export nach `lastModified`-Datum. Absolute Bild-URLs im Tracking. Optimierte API-Aufrufe.

**Neue Funktionen:** Ereignis-Tracking: `product_added_to_cart`, `checkout_completed`, `checkout_validated`.

**Korrekturen:** Frontend-Kompilierung. Job-Export-Absturz bei fehlendem Custom Object.

## 24.6.0 — 2024-06-10

Erstveröffentlichung.