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

​
カスタムサイト設定

メタデータのインポート後、BM > Merchant Tools > Site Preferences > Custom Preferences に移動します。 image.png Kleep を選択します。 image.png
設定説明
kleepRetailerUUID必須。 Kleep プラットフォーム上のリテーラーの一意識別子。Kleep アカウントマネージャーから提供されます。手動で入力する必要があります — すべての Kleep API 呼び出しで送信され、アカウントを解決するためのレコメンデーション iframe の domain パラメーターとして使用されます。自動フォールバックはありません：空のままにすると、トラッキング、レコメンデーション機能、および iframe が機能しません（設定エラーが発生します）。
isKleepRecommendationEnabledPDP の 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 呼び出しのペイロードで送信されます。

​
秘密鍵と証明書

Administration > Operations > Private Keys and Certificates に移動します。
  1. Import をクリックします
  2. Select をクリックして、Kleep から提供された .p12 ファイルを選択します
  3. エイリアスとして kleep を使用します
  4. Save をクリックします
image.png 結果は次のようになります — 有効で kleep という名前である必要があります。 image.png

​
エクスポートジョブ

Administration > Operations > Jobs に移動します。2 つのジョブが事前設定されています。
  • KleepExportProductsCSV — サイトの商品をエクスポートします
  • KleepExportOrdersCSV — 顧客の注文履歴をエクスポートします
image.png 両方ともデフォルトで無効になっています。1 日 1 回実行するように有効にします。 image.png

​
共通設定（両ジョブ）

Job Steps タブに移動し、RefArch をクリックして Kleep を使用するサイトを選択します。
  • Timeout — エクスポートを停止するまでの秒数
  • OrdersMaxToExport — エクスポートする最大注文数 （注文ジョブのみ）
image.png

​
KleepExportProductsCSV の設定

image.png
パラメーター説明デフォルト
SkipMasterマスター商品のエクスポートを無視する無効
OnlineOnlyオンライン商品のみエクスポートする無効
ExportTypeデルタ（最後のエクスポート以降の更新分のみ）またはフルデルタ
MainViewType商品画像の画像ビュータイプ。PDP と同じものを使用してください。large
Localeエクスポートの特定ロケール。空の場合はデフォルトを使用します。—
エクスポートされる商品数は処理された数を超える場合があります。これは、カテゴリ未分類の商品がカテゴリ分けされた VariationGroup との関連を通じて含まれる場合に発生します。
MainViewType パラメーターがショップの設定と一致していることを確認してください。ビュータイプが一致しない場合、AI 分析に必要な商品画像が欠落します。
image.png

​
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 を使用している場合はこちらを使用します。ステップ 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（在庫チェックは本番環境のみで有効）