設定 - Kleep Docs

カスタムサイト設定

メタデータのインポート後、BM > Merchant Tools > Site Preferences > Custom Preferences に移動します。

Kleep を選択します。

設定	説明
`kleepRetailerUUID`	必須。 Kleep プラットフォーム上のリテーラーの一意識別子。Kleep アカウントマネージャーから提供されます。手動で入力する必要があります — すべての Kleep API 呼び出しで送信され、アカウントを解決するためのレコメンデーション iframe の `domain` パラメーターとして使用されます。自動フォールバックはありません：空のままにすると、トラッキング、レコメンデーション機能、および iframe が機能しません（設定エラーが発生します）。
`isKleepRecommendationEnabled`	PDP の Kleep ボタンを有効/無効にします。トラッキングやジョブエクスポートには影響しません。
`kleepButtonColor`	ボタンの色（黒または白）。カスタムスタイリングのために CSS でオーバーライドできます。
`kleepFontFamily`	Kleep ボタンと iFrame のフォントファミリー。
`kleepCountryCode`	マーケット / 国コード（ISO 3166 A-2）。

サービス

Administration > Operations > Services で確認できます。

kleep.sftp — SFCC WebDAV から Kleep SFTP にエクスポートファイルを送信します。Kleep から提供されたユーザーと .p12 証明書に置き換えてください。パスワードは設定しないでください。

kleep — その他すべての機能に使用します。ユーザー/パスワードは不要です — リクエストは kleepRetailerUUID サイト設定によって認証され、アカウントを解決するためにすべての Kleep API 呼び出しのペイロードで送信されます。

秘密鍵と証明書

Administration > Operations > Private Keys and Certificates に移動します。

Import をクリックします
Select をクリックして、Kleep から提供された .p12 ファイルを選択します
エイリアスとして kleep を使用します
Save をクリックします

結果は次のようになります — 有効で kleep という名前である必要があります。

エクスポートジョブ

Administration > Operations > Jobs に移動します。2 つのジョブが事前設定されています。

KleepExportProductsCSV — サイトの商品をエクスポートします
KleepExportOrdersCSV — 顧客の注文履歴をエクスポートします

両方ともデフォルトで無効になっています。1 日 1 回実行するように有効にします。

共通設定（両ジョブ）

Job Steps タブに移動し、RefArch をクリックして Kleep を使用するサイトを選択します。

Timeout — エクスポートを停止するまでの秒数
OrdersMaxToExport — エクスポートする最大注文数 （注文ジョブのみ）

KleepExportProductsCSV の設定

パラメーター	説明	デフォルト
`SkipMaster`	マスター商品のエクスポートを無視する	無効
`OnlineOnly`	オンライン商品のみエクスポートする	無効
`ExportType`	デルタ（最後のエクスポート以降の更新分のみ）またはフル	デルタ
`MainViewType`	商品画像の画像ビュータイプ。PDP と同じものを使用してください。	`large`
`Locale`	エクスポートの特定ロケール。空の場合はデフォルトを使用します。	—

エクスポートされる商品数は処理された数を超える場合があります。これは、カテゴリ未分類の商品がカテゴリ分けされた VariationGroup との関連を通じて含まれる場合に発生します。

MainViewType パラメーターがショップの設定と一致していることを確認してください。ビュータイプが一致しない場合、AI 分析に必要な商品画像が欠落します。

KleepResetLastExported（ユーティリティジョブ）

3 つ目のジョブ KleepResetLastExported は、注文の完全な再エクスポートを強制するために提供されています。その ResetKleepExportAttributes ステップは、すべての注文のエクスポートトラッキング属性（kleepLastExported → 空、isKleepExported → false）をクリアして、次回の KleepExportOrdersCSV 実行時に再度処理されるようにします。 デフォルトで無効になっており、必要に応じて（例：Kleep 側のデータリセット後に）手動で実行することを目的としています。パラメーターは必要ありません。

リアルタイム在庫チェック

Kleep は在庫切れのサイズを推奨しないよう、在庫をリアルタイムでクエリします。以下の 2 つの方法のうちいずれか 1 つを使用してアクセスを設定します。

どちらを選ぶか分からない場合は？OCAPI は Business Manager Data API を使用する従来のアプローチです。SCAPI（IAS） は Inventory Availability Service を使用した新しい Salesforce Commerce API です。不明な場合は Salesforce 管理者にお問い合わせください。

OCAPI（Open Commerce API）
SCAPI — Inventory Availability Service（IAS）

インスタンスが在庫管理に OCAPI を使用している場合はこちらを使用します。ステップ 1 — OCAPI 設定を開くAdministration > Site Development > Open Commerce API Settings に移動し、Data API 設定を編集します。ステップ 2 — クライアント ID の設定テスト用：

"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

本番環境では、Salesforce ドキュメントに従って新しいクライアント ID を生成します。動画ウォークスルー。ステップ 3 — リソースアクセスの設定OCAPI Data API 設定に以下を追加します。

Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*

ステップ 4 — 認証情報を Kleep に送信

Client ID
Client Secret
在庫 ID（マーケットごとに 1 つ — マッピングを提供してください）
本番 SBX URL（在庫チェックは本番環境のみで有効）

インスタンスが Inventory Availability Service（IAS） / Omnichannel Inventory（OCI）を使用した SCAPI を使用している場合はこちらを使用します。ステップ 1 — API クライアントの作成

Salesforce Account Manager にログインします。
API Client → Add API Client をクリックします。
表示名：例 Kleep Inventory。
Token Endpoint Auth Method：client_secret_post。
Access Token Format：JWT。
Allowed Scopes：sfcc.inventory.availability
組織に割り当てます。
保存します。Client ID と Client Secret をコピーしてください — シークレットは一度しか表示されません。

SCAPI と OCAPI のクライアントは共有できません。各 API フレームワークには独自のクライアントが必要です。

ステップ 2 — インスタンス識別子の収集

識別子	確認場所	例
Short Code	BM > Administration > Site Development > Salesforce Commerce API Settings	`kv7kzm78`
Organization ID	同ページ、または Account Manager	`f_ecom_zzzz_prd`
Tenant ID	Account Manager > Organizations	`zzzz_prd`
Location Group(s)	BM > Merchant Tools > Inventory > Inventory Availability	`WAREHOUSE_FR`, `WAREHOUSE_US`

ステップ 3 — 認証情報を Kleep に送信

Client ID と Client Secret
Short Code
Organization ID
Tenant ID
Location Group(s)（マーケットごとに 1 つ — マッピングを提供してください）

ようこそ

CMS

モバイル

ダッシュボード

データ

プライバシー

設定

カスタムサイト設定

サービス

秘密鍵と証明書