# 個人用カタログ

個人用設定機能を使用すると、認証された特定のユーザーに対してのみ、アイテムカタログの表示条件を設定したりプロモーションを適用したりすることができます。条件はユーザー属性に基づいて定義され、特定のユーザーに最も関連性の高いアイテムやプロモーションを提供できるようになります。

利用可能な個人用設定のタイプは次のとおりです：

* [エクソーラ側の個人用設定](/ja/liveops/promotion-tools/personalization/#guides_personalization_on_xsolla_side)。個人用設定のルールとロジックはエクソーラ側で設定および保存されます。ユーザー属性を渡すと、エクソーラがそれを使用してパーソナライズされたカタログを生成します。
* [パートナー側の個人用設定](/ja/liveops/promotion-tools/personalization/#guides_personalization_on_partner_side)。個人用設定のルールとロジックを自分の側で設定し、指定したユーザーに対する最終的なカタログペイロードをエクソーラに送信します。

<div class="note">
  <b>注意</b><br><br>
  使用できる個人用設定のタイプは1つだけです。変更するには、
  <a href="/ja/liveops/promotion-tools/personalization/#guides_personalization_change">説明</a>に従ってください。
</div>

エクソーラAPIを使用してエクソーラ側で個人用設定を構成するには：

1. [仮想アイテムと仮想通貨](/ja/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/)、[バンドル](/ja/api/catalog/bundles-admin/admin-create-bundle)、または[ゲームキー](/ja/api/catalog/game-keys-admin)グループの**管理者**サブセクションにあるAPIコールを使用して、アイテムを作成します。
2. [エクソーラログインAPIを使用してユーザー属性をセットアップ](/ja/liveops/promotion-tools/personalization/#web_shop_guide_personalization_setting_attributes)し、ゲーム内で変更が発生した場合はエクソーラ内のデータを更新して同期を保ちます。
3. アイテムまたはプロモーションの個人用設定を設定します：
    * アイテムカタログをパーソナライズするには、[カタログフィルタルールを作成する](/ja/api/liveops/personalized-catalog/create-filter-rule)APIコールを使用してカタログの表示ルールを定義します：
        * [attribute_conditions](/ja/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=attribute_conditions)配列で、ユーザー属性に基づいてアイテムの可用性を決定する条件を指定します。
        * [items](/ja/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=items)配列で、指定された条件に一致するユーザーに表示されるべきアイテムのリストを提供します。
    * パーソナライズされたプロモーションを設定するには、[必要なプロモーションタイプのAPIコールを作成または更新する](/ja/api/liveops/promotions-discounts/create-item-promotion)を使用します。[attribute_conditions](/ja/api/liveops/promotions-discounts/create-item-promotion)配列で、ユーザー属性に基づいてプロモーションの可用性を決定する条件を指定します。

4. ユーザー属性を含む[ユーザーJWT](/ja/api/login/getting-user-token?#getting-user-token)を[カタログ取得APIコール](https://developers.xsolla.com/ja/api/catalog/virtual-items-currency-catalog/get-virtual-items)に渡して、パーソナライズされたカタログを受け取ります。

**アイテムカタログにおけるエクソーラ側パーソナライズの設定および適用手順：**

![アイテムカタログの個人用設定](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-catalog.png)

**プロモーションにおけるエクソーラ側パーソナライズの設定および適用手順：**

![プロモーションの個人用設定](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-liveops.png)

<div class="note">
<b>注意</b><br><br>
詳細情報は以下に提供されています：
<ul>
  <li><a href="/ja/liveops/promotion-tools/personalization/">エクソーラ側およびパートナー側での個人用設定に関するガイド</a></li>
  <li><a href="/ja/doc/shop-builder/tutorials/personalization-tutorial/">エクソーラ側でのアイテムカタログ個人用設定に関するステップバイステップのチュートリアル</a></li>
</ul>
</div>