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

## フェーズ1：バックエンド設定（REST API）

*このステップにより、Kleep はお客様の商品カタログ、注文履歴、返品/返金データを取得してアルゴリズムを調整できます。*

### 1. REST API キーの作成

1. **WordPress 管理パネル**にログインします。
2. **WooCommerce > Settings > Advanced > REST API** に移動します。
3. **「Add key」** をクリックします。
4. 以下のフィールドを入力します：
   * **Description：** 名前を入力します（例：「Kleep Integration」）
   * **User：** 管理者ユーザーを選択します
   * **Permissions：** **Read** を選択します
5. **「Generate API key」** をクリックします。

### 2. 資格情報の取得と保存

生成後、WooCommerce に 2 つの資格情報が表示されます：

* **Consumer Key**（`ck_` で始まります）
* **Consumer Secret**（`cs_` で始まります）

**⚠️ 重要：** Consumer Secret は一度しか表示されません。両方の値をすぐにコピーして安全に保管してください。

### 3. 要件

* WooCommerce ストアは、API キーを安全に機能させるために **HTTPS を使用する必要があります**。
* 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_...`）

***

## フェーズ2：フロントエンドインテグレーション（ウィジェット）

*このステップでは、商品ページ（PDP）に Kleep スクリプトを追加します。WooCommerce の全バージョンに対応しています。*

[**JS ライブラリ ウィジェットガイド**](/ja/cms/js-library)に従って、商品ページのフロントエンド CTA をインストールおよび設定してください。

***

## フェーズ3：不足データの管理（SFTP）

*このセクションは、標準 API エンドポイントからデータを取得できない場合に適用されます。*

WooCommerce ストアが標準 WooCommerce REST API を通じて返品データを公開しないサードパーティの返品/RMA プラグインを使用している場合は、CSV ファイル交換で対応します。

以下のドキュメントをご参照ください。不足データの送信プロセスをステップごとに説明しています。返品データ部分に特にご注目ください。

***

## クッキーとデータプライバシー

Kleep は訪問者の同意によって完全に制御されています。スクリプトは CMP を通じて同意が収集された**後にのみ**ロードされ、それに応じてロードを条件付けする必要があります。トラッカーの完全なリスト、処理されるデータ、目的と法的根拠、ホスティング、サブプロセッサー、セキュリティについては、[クッキー、CMP とデータプライバシー](/ja/cookie-consent)をご参照ください。