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

# 更新日志

> SFRA Cartridge 发布历史

## 26.04.0 — 2026-04-28

**重大变更：**

* 零售商识别现在依赖新的**必填** `kleepRetailerUUID` 站点偏好设置，而非请求主机名。升级后，请在 **BM > Site Preferences > Kleep** 中进行设置——否则追踪功能、推荐功能和 iframe 将无法正常工作。

**增强：**

* 在 `/recommend` payload 中添加了市场/语言区域上下文，用于按市场个性化推荐。
* 移除了 `isKleepSessionEnabled` 偏好设置——会话 UUID 逻辑现在始终激活。

**修复：**

* 从订单 CSV 导出中移除了客户个人信息（PII）。
* 移除了商品 CSV 导出中多余的空列，并将导出格式与 SFTP 数据结构规范对齐。

## 25.09.0 — 2025-09-22

* 新增会话逻辑，每个会话具有唯一的会话 UUID，用于基于会话的 KPI。与 iFrame 共享，用于内部/外部追踪对账。
* 支持多个品类：鞋类、童装、内衣。
* 统一了域名处理器。
* 2 个新的自定义偏好设置：站点市场（按市场 KPI / 流程个性化）和会话逻辑启用开关。
* 通过基于 postMessage 的触发器增强了追踪可靠性。

## 24.11.2 — 2024-11-12

**修复：**

* 新增 `isKleepExported` 布尔属性，修复导出状态查询不一致问题。
* 修复了自定义属性中字符串化空对象的问题（现在改为空字符串）。

**增强：**

* 自定义任务超时参数（默认：900s）。
* 最大订单数量限制参数（默认：每次执行 1000 条）。
* 新增订单重置任务，用于重新导出。
* 订单现在始终以增量模式导出；剩余订单在下次运行时继续处理。

## 24.11.1 — 2024-11-08

* PDP CTA 本地化支持：FR、JA、ES、PT（PT/BR）、IT、KO、DE（DE/BE）、NL。
* 移除了 PDP CTA 徽标。

## 24.11.0 — 2024-11-06

**修复：**

* 修复了导出中 `SFCC_custom_attributes` 列数据缺失的问题。
* 修复了 KleepExportOrdersCSV 完整导出选项。

**增强：**

* 移除了 1000 条订单的导出限制。
* 增强了两个导出任务的日志记录。
* 为 KleepExportOrdersCSV 中失败的订单添加了重试功能。

## 24.10.2 — 2024-10-23

* 更新了推荐弹窗 URL。

## 24.10.1 — 2024-10-21

**增强：**

* 当至少一个变体已分类时，导出包含所有变体/变体组。配额：20,000 个主商品。
* 新增 `SFCC_Product_VariationGroups_ID` CSV 列。
* 移除了任务步骤中未使用的 `[BRAND]` 配置。
* 订单导出仅过滤"已导出"状态的订单。
* 支持在 PDP 任意位置放置多个 Kleep CTA。移除了 CTA 加载动画。
* 在推荐商品前进行实时库存检查。新增 `button_clicked` 事件。

**修复：**

* 修复了 KleepExportOrdersCSV 在处理含备注订单时崩溃的问题。

## 24.10.0 — 2024-10-07

**增强：**

* 兼容 API 21.2 的推荐弹窗 URL。
* 导出块大小从 1000 改为 100，清除空行/重复行，改进日志，自动修剪 `MainViewType`。

**新功能：**

* `ExportType` 参数（Delta/Full），无需删除 CustomObject。
* 商品导出中包含品类名称/ID。

**修复：**

* 修复了 BM 中任务状态显示"OK"但后端为"ERROR"的问题。
* 修复了任务出错时 `KleepExportDateTracker` 的创建错误。
* 当主商品未分类时，导出包含来自变体组的变体。

## 24.9.0 — 2024-09-25

**修复：** 修复了从弹窗加入购物车的问题；修复了元数据中 `kleepLastExported` 缺失的问题。

**增强：** KleepExportProductsCSV 兼容 SFCC API 21.2。

## 24.8.0 — 2024-08-30

**修复：** 修复了 PDP 控制台错误。

**增强：** 推荐功能改为使用 VariationGroups 而非 Masters。

## 24.7.0 — 2024-07-03

**增强：** 按 `lastModified` 日期进行增量导出。追踪中使用绝对图片 URL。优化了 API 调用。

**新功能：** 事件追踪：`product_added_to_cart`、`checkout_completed`、`checkout_validated`。

**修复：** 前端编译问题。自定义对象缺失时任务导出崩溃的问题。

## 24.6.0 — 2024-06-10

初始版本发布。