跳转到主要内容

​
自定义站点偏好设置

元数据导入完成后，前往 BM > Merchant Tools > Site Preferences > Custom Preferences。 image.png 选择 Kleep： image.png
偏好设置说明
kleepRetailerUUID必填。 您在 Kleep 平台上的零售商唯一标识符，由您的 Kleep 客户经理提供。需手动输入——它会在每次 Kleep API 调用中发送，并作为推荐 iframe 的 domain 参数用于解析您的账户。无自动回退：若留空，追踪功能、推荐功能和 iframe 将无法正常工作（会触发配置错误）。
isKleepRecommendationEnabled启用/禁用 PDP 中的 Kleep 按钮。不影响追踪或任务导出。
kleepButtonColor按钮颜色（黑色或白色）。可通过 CSS 覆盖以进行自定义样式设置。
kleepFontFamilyKleep 按钮和 iFrame 使用的字体系列。
kleepCountryCode市场 / 国家代码（ISO 3166 A-2）。

​
服务

在 Administration > Operations > Services 中可找到： image.png kleep.sftp — 将导出文件从 SFCC WebDAV 发送到 Kleep SFTP。请将用户替换为 Kleep 提供的用户名，同时替换 .p12 证书。无需设置密码。 image.png kleep — 用于所有其他功能。无需用户名/密码——请求通过 kleepRetailerUUID 站点偏好设置进行身份验证，该值会在每次 Kleep API 调用的 payload 中发送，用于解析您的账户。

​
私钥与证书

前往 Administration > Operations > Private Keys and Certificates：
  1. 点击 Import
  2. 点击 Select，选择 Kleep 提供的 .p12 文件
  3. 使用 kleep 作为别名
  4. 点击 Save
image.png 结果应如下所示——证书必须有效且命名为 kleep： image.png

​
导出任务

前往 Administration > Operations > Jobs。已预配置两个任务：
  • KleepExportProductsCSV — 导出您站点的商品
  • KleepExportOrdersCSV — 导出客户的订单历史
image.png 两个任务默认禁用。请启用它们以每天运行一次： image.png

​
通用设置（两个任务）

前往 Job Steps 标签页 → 点击 RefArch 以选择您使用 Kleep 的站点。
  • Timeout — 停止导出前的等待秒数
  • OrdersMaxToExport — 最大导出订单数 （仅限订单任务）
image.png

​
KleepExportProductsCSV 设置

image.png
参数说明默认值
SkipMaster忽略主商品导出禁用
OnlineOnly仅导出上线商品禁用
ExportType增量（仅自上次导出后更新的内容）或完整导出Delta
MainViewType商品图片的图像视图类型。请使用与您 PDP 相同的类型。large
Locale导出使用的特定语言区域。为空时使用默认值。—
导出的商品数量可能超过实际处理的数量。这是因为未分类商品通过其与已分类 VariationGroup 的关联被包含在内。
请确保 MainViewType 参数与您店铺的配置一致。视图类型不匹配将导致商品图片缺失，而商品图片是 AI 分析所必需的。
image.png

​
KleepResetLastExported（工具任务）

第三个任务 KleepResetLastExported 用于强制完整重新导出订单。其 ResetKleepExportAttributes 步骤会清除每个订单上的导出追踪属性（kleepLastExported → 空，isKleepExported → false），使其在下次运行 KleepExportOrdersCSV 时被重新处理。 该任务默认禁用，适合手动按需运行（例如在 Kleep 端数据重置后）。无需任何参数。

​
实时库存检查

Kleep 实时查询库存，以避免推荐已缺货的尺码。请使用以下两种方法之一配置访问权限。
不确定选哪种？OCAPI 是使用 Business Manager Data API 的传统方法。SCAPI (IAS) 是配备库存可用性服务的新版 Salesforce Commerce API。如有疑问，请咨询您的 Salesforce 管理员。
如果您的实例依赖 OCAPI 进行库存管理，请使用此方法。第 1 步 — 打开 OCAPI 设置前往 Administration > Site Development > Open Commerce API Settings，然后编辑 Data API 设置。第 2 步 — 设置 Client ID测试用：
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
生产环境请参考 Salesforce 文档 生成新的 Client ID。视频演示。第 3 步 — 配置资源访问权限将以下内容添加到您的 OCAPI Data API 配置中：
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
第 4 步 — 将凭证发送给 Kleep
  • Client ID
  • Client Secret
  • Inventory IDs（每个市场一个——请提供您的映射关系）
  • 生产 SBX URL（库存检查仅在生产环境启用）