# Персонализированный каталог

Персонализация позволяет задавать условия отображения каталога товаров и применения акций только для определенного круга авторизованных пользователей. Условия задаются на основе атрибутов пользователей и позволяют показывать релевантные товары, предложения и скидки.

Доступны следующие типы персонализации:

* [Персонализация на стороне Xsolla](/ru/liveops/promotion-tools/personalization/#guides_personalization_on_xsolla_side). Правила и логика персонализации настраиваются и хранятся на стороне Xsolla. Вы передаете атрибуты пользователя, а Xsolla на их основе формирует персонализированный каталог.
* [Персонализация на стороне партнера](/ru/liveops/promotion-tools/personalization/#guides_personalization_on_partner_side). Вы самостоятельно настраиваете правила и логику персонализации и передаете в Xsolla готовый каталог для конкретного пользователя.

<div class="note">
  <b>Примечание</b><br><br>
  Вы можете использовать только один тип персонализации. Чтобы изменить его, используйте
  <a href="/ru/liveops/promotion-tools/personalization/#guides_personalization_change">инструкцию</a>.
</div>

Чтобы настроить персонализацию на стороне Xsolla с помощью Xsolla API:

1. Создайте товары с помощью методов подраздела **Admin** из группы [Виртуальные предметы и валюта](/ru/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Бандлы](/ru/api/catalog/bundles-admin/admin-create-bundle) или [Игровые ключи](/ru/api/catalog/game-keys-admin).
2. [Настройте атрибуты пользователя, используя Xsolla Login API](/ru/liveops/promotion-tools/personalization/#web_shop_guide_personalization_setting_attributes) и поддерживайте значения атрибутов в актуальном состоянии: обновляйте их в Xsolla, когда они меняются у пользователя в игре.
3. Настройте персонализацию для товаров или акций:
    * Для персонализации каталога товаров задайте правила отображения каталога с помощью метода  [Создание правила фильтрации каталога](/ru/api/liveops/personalized-catalog/create-filter-rule):
        * В массиве [attribute_conditions](/ru/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=attribute_conditions) укажите условия доступности товаров в каталоге на основе проверки атрибутов пользователя.
        * В массиве [items](/ru/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=items) передайте список товаров, которые должен видеть пользователь, если значения его атрибутов соответствуют условиям.
    * Для настройки персонализированных акций используйте [методы создания и обновления акции нужного типа](/ru/api/liveops/promotions-discounts/create-item-promotion) и в массиве [attribute_conditions](/ru/api/liveops/promotions-discounts/create-item-promotion) передайте условия, которые определяют доступность акции на основе проверки атрибутов пользователя.

4. Передайте [JWT пользователя](/ru/api/login/getting-user-token?#getting-user-token) с его атрибутами в методы [получения каталога товаров](https://developers.xsolla.com/ru/api/catalog/virtual-items-currency-catalog/get-virtual-items), чтобы получить персонализированный каталог.

**Процесс настройки и применения персонализации на стороне Xsolla для товаров каталога:**

![Персонализация каталога товаров](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-catalog.png)

**Процесс настройки и применения персонализации на стороне Xsolla для акций:**

![Персонализация акций](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-liveops.png)

<div class="note">
<b>Примечание</b><br><br>
Подробная информация приведена:
<ul>
  <li>в <a href="/ru/liveops/promotion-tools/personalization/">инструкции по настройке персонализации на стороне Xsolla и стороне партнера</a>;</li>
  <li>в пошаговом руководстве по <a href="/ru/doc/shop-builder/tutorials/personalization-tutorial/">персонализации каталога товаров на стороне Xsolla</a></li>
</ul>
</div>