26.04.0 — 2026-04-28
重大变更：- 零售商识别现在依赖新的必填
kleepRetailerUUID站点偏好设置，而非请求主机名。升级后，请在 BM > Site Preferences > Kleep 中进行设置——否则追踪功能、推荐功能和 iframe 将无法正常工作。
- 在
/recommendpayload 中添加了市场/语言区域上下文，用于按市场个性化推荐。 - 移除了
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_IDCSV 列。 - 移除了任务步骤中未使用的
[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。
修复： 前端编译问题。自定义对象缺失时任务导出崩溃的问题。