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

> Cronologia delle versioni del Cartridge SFRA

## 26.04.0 — 2026-04-28

**Modifiche incompatibili:**

* L'identificazione del retailer ora si basa su una nuova preferenza del sito **obbligatoria** `kleepRetailerUUID` invece dell'host della richiesta. Dopo l'aggiornamento, impostala in **BM > Site Preferences > Kleep** — altrimenti il tracciamento, la funzionalità di Raccomandazione e l'iframe non funzioneranno.

**Miglioramenti:**

* Aggiunto contesto mercato/locale al payload `/recommend` per la personalizzazione delle raccomandazioni per mercato.
* Rimossa la preferenza `isKleepSessionEnabled` — la logica UUID di sessione è ora sempre attiva.

**Correzioni:**

* Rimossi i dati PII dei clienti dall'esportazione CSV degli ordini.
* Rimossa una colonna vuota extra nell'esportazione CSV dei prodotti e allineato il formato di esportazione con la specifica della struttura dati SFTP.

## 25.09.0 — 2025-09-22

* Nuova logica di sessione con UUID di sessione univoco per sessione per KPI basati sulla sessione. Condiviso con gli iFrame per la riconciliazione del tracciamento interno/esterno.
* Supporto per più categorie: Scarpe, Bambini, Lingerie.
* Gestore domini armonizzato.
* 2 nuove preferenze personalizzate: mercato del sito (KPI per mercato / personalizzazioni del flusso) e abilitatore della logica di sessione.
* Affidabilità del tracciamento migliorata con trigger basati su postMessage.

## 24.11.2 — 2024-11-12

**Correzioni:**

* Nuovo attributo booleano `isKleepExported` per correggere le inconsistenze nelle query dello stato di esportazione.
* Corretto oggetto vuoto stringificato negli attributi personalizzati (ora stringa vuota).

**Miglioramenti:**

* Parametro di timeout del job personalizzato (predefinito: 900s).
* Parametro limite massimo ordini (predefinito: 1000/esecuzione).
* Nuovo job di reset ordini per le ri-esportazioni.
* Gli ordini vengono ora sempre esportati in modalità delta; gli ordini rimanenti continuano alla prossima esecuzione.

## 24.11.1 — 2024-11-08

* CTA PDP localizzata: FR, JA, ES, PT (PT/BR), IT, KO, DE (DE/BE), NL.
* Rimosso il logo CTA PDP.

## 24.11.0 — 2024-11-06

**Correzioni:**

* Corretti i dati mancanti della colonna `SFCC_custom_attributes` nelle esportazioni.
* Corretta l'opzione di esportazione Full di KleepExportOrdersCSV.

**Miglioramenti:**

* Rimosso il limite di 1000 ordini per l'esportazione.
* Logging migliorato per entrambi i job di esportazione.
* Funzionalità di retry in KleepExportOrdersCSV per gli ordini falliti.

## 24.10.2 — 2024-10-23

* Aggiornato l'URL del modal di raccomandazione.

## 24.10.1 — 2024-10-21

**Miglioramenti:**

* L'esportazione include tutte le varianti/gruppi di variazione quando almeno una è categorizzata. Quota: 20.000 master.
* Nuova colonna CSV `SFCC_Product_VariationGroups_ID`.
* Rimossa la configurazione `[BRAND]` non utilizzata nei passi del job.
* Esportazione ordini filtrata solo allo stato "Exported".
* Supporto per CTA Kleep multiple ovunque nella PDP. Rimosso lo spinner di caricamento del CTA.
* Controllo inventario in tempo reale prima di suggerire un prodotto. Nuovo evento `button_clicked`.

**Correzioni:**

* Corretto il crash di KleepExportOrdersCSV sugli ordini con note.

## 24.10.0 — 2024-10-07

**Miglioramenti:**

* Compatibilità API 21.2 per l'URL del modal di raccomandazione.
* Dimensione chunk esportazione 1000→100, pulizia righe vuote/duplicate, log migliorati, auto-trim `MainViewType`.

**Nuove Funzionalità:**

* Parametro `ExportType` (Delta/Full) senza eliminare il CustomObject.
* Nomi/ID categorie nell'esportazione prodotti.

**Correzioni:**

* Stato job che mostrava "OK" in BM mentre "ERROR" nel backend.
* Bug di creazione `KleepExportDateTracker` sugli errori del job.
* L'esportazione include le varianti dei gruppi di variazione quando i master non sono categorizzati.

## 24.9.0 — 2024-09-25

**Correzioni:** AddToCart dal pop-up; `kleepLastExported` mancante nei metadati.

**Miglioramenti:** Compatibilità KleepExportProductsCSV con SFCC API 21.2.

## 24.8.0 — 2024-08-30

**Correzioni:** Risolti errori della console PDP.

**Miglioramenti:** La funzionalità di Raccomandazione utilizza i VariationGroups invece dei Master.

## 24.7.0 — 2024-07-03

**Miglioramenti:** Esportazione delta per data `lastModified`. URL immagini assoluti nel tracciamento. Chiamate API ottimizzate.

**Nuove Funzionalità:** Tracciamento eventi: `product_added_to_cart`, `checkout_completed`, `checkout_validated`.

**Correzioni:** Compilazione frontend. Crash del job di esportazione su oggetto personalizzato mancante.

## 24.6.0 — 2024-06-10

Versione iniziale.