メインコンテンツへスキップ

フェーズ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 Keyck_ で始まります)
  • Consumer Secretcs_ で始まります)
⚠️ 重要: 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 Keyck_...
  3. Consumer Secretcs_...

フェーズ2:フロントエンドインテグレーション(ウィジェット)

このステップでは、商品ページ(PDP)に Kleep スクリプトを追加します。WooCommerce の全バージョンに対応しています。 JS ライブラリ ウィジェットガイドに従って、商品ページのフロントエンド CTA をインストールおよび設定してください。

フェーズ3:不足データの管理(SFTP)

このセクションは、標準 API エンドポイントからデータを取得できない場合に適用されます。 WooCommerce ストアが標準 WooCommerce REST API を通じて返品データを公開しないサードパーティの返品/RMA プラグインを使用している場合は、CSV ファイル交換で対応します。 以下のドキュメントをご参照ください。不足データの送信プロセスをステップごとに説明しています。返品データ部分に特にご注目ください。

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

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