> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# レコメンデーション戦略を作成および設定する

> 商品レコメンデーション戦略を作成し、アルゴリズムとルールを設定し、テンプレートを選択して、ブロックをウェブサイトに公開します。

<Note>
  これはプレミアム機能です。Kameleoon アカウントで有効化するには、カスタマーサクセスマネージャーにお問い合わせください。
</Note>

**Product Recommendations** ワークスペースにアクセスするには:

* **Settings** > **Recommendations** をクリックします。

## レコメンデーション戦略

### 戦略を作成する

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/reco-menu.png)
</Frame>

1. **Recommendations** メニューで、**Recommendation strategy** をクリックします。
2. ヘッダーの **+ Add block** をクリックして新しい戦略を作成します。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/add-block-cta.png)
</Frame>

3. 名前と説明を入力します。
4. ブロックに表示する商品の最大数を定義します。
5. **Save** をクリックします。

戦略を保存すると、そのルール、テンプレート、デザインを設定できます。

### ルールを設定する

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/rules.png)
</Frame>

**Rules** セクションを使用して、レコメンデーション戦略が商品を選択およびフィルタリングする方法を定義します。

次の項目を設定できます。

* 戦略のタイトルと説明
* アルゴリズム、ブロック内の商品、タグ

例えば、商品が一定金額未満の場合は 1 つのアルゴリズムを、それ以上の場合は別のアルゴリズムを使用することができます。

ルールを設定した後、**Save** をクリックして変更を適用します。

高度なルールを設定する方法については、[高度なマーチャンダイジングルールを定義する](./define-advanced-merchandising-rules)を参照してください。

#### アルゴリズム

Kameleoon アルゴリズムは、レコメンデーションブロックに表示される商品を決定します。アルゴリズムを選択し、返される商品数を指定し、フィルタを適用できます。

アルゴリズムで 10 商品の制限を設定し、ブロックの制限を 6 と定義した場合、ブロックには 6 商品が表示されます。

利用可能なアルゴリズムのリストを確認するには、[商品レコメンデーションブロック用のアルゴリズムを選択する](./select-an-algorithm-for-your-product-recommendation-block)を参照してください。

### テンプレートを選択する

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/template-selection.png)
</Frame>

**Template** セクションでは、事前定義された設定をプロジェクトに迅速に適用できます。エディタでデフォルトコードを編集して [Liquid Markup](https://liquidmarkup.org) を使用して独自のテンプレートを定義したり、既存のテンプレートを適用したりできます。既存のテンプレートをカスタマイズしたり新しいものを作成するには、専用の **[Templates](#manage-templates)** ページを使用します。

戦略のパフォーマンスを分析プラットフォームで追跡するために、UTM パラメータを追加することもできます。

### 戦略を公開する

完了したら、**Copy code** をクリックしてブロック用に生成されたスニペットを取得します。表示したい場所のページのソースコードに貼り付けます。

また、Kameleoon の [Activation API](../../../developer-docs/apis/activation-api-js/api-reference/api-reference#obtainrecommendedproducts) を使用して商品レコメンデーションを配信することもできます。API は自動的に保存されたテンプレートの最新バージョンを使用します。

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/copy-code.png)
</Frame>

ブロックが特定のアルゴリズムを使用する場合、Kameleoon の事前定義された変数を含める必要があります。例えば、**Similar product** アルゴリズムを使用し、すべての商品ページにブロックを表示したい場合は、`data-recommender-item` 変数を追加して現在の商品の ID を指定します。下記の表に、利用可能なすべての Kameleoon 変数を示します。

| パラメータ                           | 必須               | 説明                                                                           |
| ------------------------------- | ---------------- | ---------------------------------------------------------------------------- |
| `data-recommender-min`          | いいえ              | ブロックを表示するためのレスポンス内の最小商品数。十分な商品がない場合、ブロックは非表示になります。                           |
| `data-recommender-code`         | はい               | 商品レコメンデーションブロック ID                                                           |
| `data-recommender-item`         | はい（一部のアルゴリズムの場合） | ユーザーが商品カード上にいる場合の現在の商品 ID。「Similar」および「They also buy this」アルゴリズムのブロックでは必須です。 |
| `data-recommender-exclude`      | いいえ              | レコメンデーションから除外する必要がある商品 ID のカンマ区切りリスト。                                        |
| `data-recommender-search_query` | いいえ              | 現在の検索ワード。検索結果ページ上のブロックで使用されます。                                               |
| `data-recommender-callback`     | いいえ              | カスタム商品レコメンデーションハンドラが必要な場合に、API リクエストの結果が渡される JS 関数の名前。                       |
| `data-recommender-error`        | いいえ              | 商品レコメンデーションリクエストが失敗した場合に呼び出される JS 関数の名前。                                     |
| `data-recommender-category`     | いいえ              | 指定されたカテゴリからのみ商品を推奨します。                                                       |
| `data-recommender-categories`   | いいえ              | 指定されたカテゴリ（カテゴリ ID のカンマ区切りリスト）からのみ商品を推奨します。                                   |
| `data-recommender-brands`       | いいえ              | 指定されたブランド（ブランドのカンマ区切りリスト）からのみ商品を推奨します。                                       |

## 同意管理

デフォルトでは、商品レコメンデーションは A/B テストおよびパーソナライゼーションと同じ同意設定を共有します。レコメンデーション専用の同意ポリシーを個別に設定することはできません。商品レコメンデーション専用の独立した同意ポリシーを設定するには、カスタマーサクセスマネージャー（CSM）にお問い合わせください。

### 設定がレコメンデーションに与える影響

レコメンデーションエンジンの動作は、アカウントの同意要件に依存します。

* **同意が不要な場合:** Kameleoon は、訪問者の同意ステータスに関係なく、Cookie に訪問者データを保存し、レコメンデーションモジュールに送信します。
* **同意が必要な場合:** 訪問者が提供する同意によって、Kameleoon がデータをどのように管理するかが決まります。
  * **同意が付与された場合:** Kameleoon は訪問者データを保存および送信し、閲覧履歴と行動に基づいてパーソナライズされたレコメンデーションを提供します。
  * **同意が付与されない場合:** Kameleoon は訪問者データを Cookie に保存しません。レコメンデーションアルゴリズムは、訪問者データを必要としないロジックまたはフィルタ（例：全体的な人気度や静的なグローバルフィルタ）のみを使用して商品を表示します。

### 設定を更新する

商品レコメンデーション用の個別の同意ポリシーを有効にしたり、既存の設定を更新するには、CSM にお問い合わせください。

## テンプレートを管理する

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/template-page.png)
</Frame>

**Templates** ページを使用して、レコメンデーションブロック用のテンプレートを作成およびカスタマイズします。

1. **Recommendations** メニューで、**Templates** をクリックします。
2. **+ Add template** をクリックします。
3. テンプレートの名前を入力します。
4. テンプレートのコードを編集して、表示するレイアウトと情報（例：商品ブランド、画像、説明）を定義します。
5. **Save** をクリックします。

複数のテンプレートを作成できます。同じテンプレートを複数の戦略で使用したり、各戦略に専用のテンプレートを割り当てたりすることもできます。

テンプレートは [Liquid Markup](http://liquidmarkup.org/) を使用します。

## デザインをカスタマイズする

<Frame>
  ![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/configure-and-add-a-recommendation-block/design-page.png)
</Frame>

**Recommendations** メニューで、**Design** をクリックしてブロックのビジュアルスタイルをカスタマイズします。**鉛筆** アイコンをクリックしてエディタにアクセスします。次から選択できます。

* **Basic editor:** シンプルなインターフェースを通じてビジュアル要素をカスタマイズします。
* **CSS editor:** 完全なスタイリング制御のためにカスタム CSS を記述します。