# Catálogo personalizado

A personalização permite que você especifique as condições para exibir o catálogo de itens e aplicar promoções apenas para usuários autorizados específicos. As condições são definidas com base nos atributos dos usuários e permite que você ofereça itens e promoções que sejam relevantes a usuários específicos.

Os seguintes tipos de personalização estão disponíveis:

* [Personalização do lado da Xsolla](/pt/liveops/promotion-tools/personalization/#guides_personalization_on_xsolla_side). Regras de personalização e lógica são configuradas e armazenadas no lado da Xsolla.
* [Personalização do lado do parceiro](/pt/liveops/promotion-tools/personalization/#guides_personalization_on_partner_side). Você configura as regras e lógica de personalização do seu lado e envia uma carga de catálogo final para um usuário específico à Xsolla.

<div class="note">
  Observação</b><br><br>
  Você só pode usar um tipo de personalização. Para alterá-lo, siga as
  <a href="/pt/liveops/promotion-tools/personalization/#guides_personalization_change">instruções</a>.
</div>

Para configurar a personalização no lado da Xsolla usando a Xsolla API:

1. Crie itens usando as chamadas API da subseção **Admin** dos grupos [Itens e moedas virtuais](/pt/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [Conjuntos](/pt/api/catalog/bundles-admin/admin-create-bundle) ou [Chaves de jogo](/pt/api/catalog/game-keys-admin).
2. [Configure os atributos dos usuários usando a Xsolla Login API](/pt/liveops/promotion-tools/personalization/#web_shop_guide_personalization_setting_attributes) e mantenha-os sincronizados atualizando os dados na Xsolla sempre que ocorrerem atualizações no seu jogo.
3. Configure a personalização para itens ou promoções:
    * Para personalizar o catálogo de itens, define as regras de exibição de catálogos usando a chamada de API [Criar regra de filtro de catálogo](/pt/api/liveops/personalized-catalog/create-filter-rule):
        * Na matriz [attribute_conditions](/pt/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=attribute_conditions), especifique as condições que determinam a disponibilidade do item com base nos atributos do usuário.
        * Na matriz [itens](/pt/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=items), forneça a lista de itens que devem permanecer visíveis ao usuário se os atributos deles corresponder às condições especificadas.
    * Para configurar promoções personalizadas, use as [chamadas API de criação e atualização para o tipo de promoção desejado](/pt/api/liveops/promotions-discounts/create-item-promotion). Na matriz [attribute_conditions](/pt/api/liveops/promotions-discounts/create-item-promotion), especifique as condições que determinam a disponibilidade da promoção com base nos atributos de usuários.

4. Passe o [JWT do usuário](/pt/api/login/getting-user-token?#getting-user-token) com os atributos do usuário para as [chamadas API de recuperação de catálogo](https://developers.xsolla.com/pt/api/catalog/virtual-items-currency-catalog/get-virtual-items) para receber um catálogo personalizado.

**Sequência para configurar e aplicar personalizações do lado da Xsolla para o catálogo de itens:**

![Personalização para o catálogo de itens](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-catalog.png)

**Sequência para configurar e aplicar personalizações do lado da Xsolla para promoções:**

![Personalização para promoções](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-liveops.png)

<div class="note">
<b>Observação</b><br><br>
Informações detalhadas são fornecidas:
<ul>
  <li>no <a href="/pt/liveops/promotion-tools/personalization/">guia de configuração de personalização do laod da Xsolal e do lado do parceiro</a></li>
  <li>no tutorial passo-a-passo sobre a <a href="/pt/doc/shop-builder/tutorials/personalization-tutorial/">personalização de catálogos de itens no lado da Xsolla</a></li>
</ul>
</div>