> ## 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.
# 設定
> サイト設定、サービス、証明書、エクスポートジョブ、リアルタイム在庫チェック
## カスタムサイト設定
メタデータのインポート後、**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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)）。 |
## サービス
**Administration > Operations > Services** で確認できます。
**`kleep.sftp`** — SFCC WebDAV から Kleep SFTP にエクスポートファイルを送信します。Kleep から提供されたユーザーと `.p12` 証明書に置き換えてください。パスワードは設定しないでください。
**`kleep`** — その他すべての機能に使用します。ユーザー/パスワードは不要です — リクエストは `kleepRetailerUUID` サイト設定によって認証され、アカウントを解決するためにすべての Kleep API 呼び出しのペイロードで送信されます。
## 秘密鍵と証明書
**Administration > Operations > Private Keys and Certificates** に移動します。
1. **Import** をクリックします
2. **Select** をクリックして、Kleep から提供された `.p12` ファイルを選択します
3. エイリアスとして `kleep` を使用します
4. **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** を使用している場合はこちらを使用します。
**ステップ 1 — OCAPI 設定を開く**
**Administration > Site Development > Open Commerce API Settings** に移動し、**Data** API 設定を編集します。
**ステップ 2 — クライアント ID の設定**
テスト用：
```
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
```
本番環境では、[Salesforce ドキュメント](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5)に従って新しいクライアント ID を生成します。[動画ウォークスルー](https://www.youtube.com/watch?v=Z3cZlQHWjtM)。
**ステップ 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 クライアントの作成**
1. [Salesforce Account Manager](https://account.demandware.com) にログインします。
2. **API Client** → **Add API Client** をクリックします。
3. 表示名：例 `Kleep Inventory`。
4. Token Endpoint Auth Method：`client_secret_post`。
5. Access Token Format：`JWT`。
6. Allowed Scopes：`sfcc.inventory.availability`
7. 組織に割り当てます。
8. 保存します。**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 つ — マッピングを提供してください）