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

# WooCommerce

## 第一阶段：后端配置（REST API）

*此步骤允许 Kleep 获取您的产品目录、订单历史及退货/退款数据，以校准算法。*

### 1. 创建 REST API 密钥

1. 登录您的 **WordPress 管理面板**。
2. 导航至 **WooCommerce > 设置 > 高级 > REST API**。
3. 点击 **"添加密钥"**。
4. 填写以下字段：
   * **描述：** 输入名称（例如："Kleep Integration"）
   * **用户：** 选择管理员用户
   * **权限：** 选择 **Read**
5. 点击 **"生成 API 密钥"**。

### 2. 获取并保存凭据

生成后，WooCommerce 将显示两项凭据：

* **Consumer Key**（以 `ck_` 开头）
* **Consumer Secret**（以 `cs_` 开头）

**⚠️ 重要提示：** Consumer Secret 仅显示一次。请立即复制两项值并安全存储。

### 3. 要求

* 您的 WooCommerce 商店**必须使用 HTTPS**，API 密钥才能安全工作。
* 需要 WooCommerce REST API **v3** 版本（WooCommerce 3.5+）。
* 如果您使用**自定义退货/RMA 插件**（例如 YITH WooCommerce RMA、ReturnGO），请告知我们，以便协调合适的集成方案。

### 4. 防火墙配置

If your store is behind a firewall or uses IP-based access restrictions, please whitelist the following Kleep IP addresses to ensure uninterrupted API access:

* `34.1.4.3`
* `82.66.252.201`
* `176.148.67.162`

### 5. 将凭据发送给 Kleep

请通过电子邮件将以下信息发送给您的 Kleep 联系人：

1. **您的商店 URL**（例如：`https://yourstore.com`）
2. **Consumer Key**（`ck_...`）
3. **Consumer Secret**（`cs_...`）

***

## 第二阶段：前端集成（Widget）

*此步骤涉及将 Kleep 脚本添加到您的产品页面（PDP），兼容所有版本的 WooCommerce。*

请参阅我们的 [**JS Library Widget 指南**](/zh/cms/js-library)，在您的产品页面上安装和配置前端 CTA。

***

## 第三阶段：缺失数据管理（SFTP）

*当数据无法通过标准 API 端点获取时，本节适用。*

如果您的 WooCommerce 商店使用的第三方退货/RMA 插件未通过标准 WooCommerce REST API 提供退货数据，我们将通过 CSV 文件交换方式进行处理。

请参阅以下文档，该指南将逐步引导您完成缺失数据的传输流程。请重点关注退货数据部分。

***

## Cookie 与数据隐私

Kleep 完全受访客同意控制：脚本仅在通过您的 CMP 收集到同意**之后**才会加载，您必须相应地对其加载进行条件限制。有关追踪器完整列表、处理的数据、目的与法律依据、托管、分包处理方及安全信息，请参阅 [Cookie、CMP 与数据隐私](/zh/cookie-consent)。