{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/pt/api/liveops/index.yaml","sidebar":"sidebar-@l10n/pt/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/pt/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/pt/api/liveops","seo":{"title":"Catálogo personalizado","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"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.\n\nOs seguintes tipos de personalização estão disponíveis:\n\n* [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.\n* [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.\n\n<div class=\"note\">\n  Observação</b><br><br>\n  Você só pode usar um tipo de personalização. Para alterá-lo, siga as\n  <a href=\"/pt/liveops/promotion-tools/personalization/#guides_personalization_change\">instruções</a>.\n</div>\n\nPara configurar a personalização no lado da Xsolla usando a Xsolla API:\n\n1. 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).\n2. [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.\n3. Configure a personalização para itens ou promoções:\n    * 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):\n        * 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.\n        * 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.\n    * 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.\n\n4. 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.\n\n**Sequência para configurar e aplicar personalizações do lado da Xsolla para o catálogo de itens:**\n\n![Personalização para o catálogo de itens](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-catalog.png)\n\n**Sequência para configurar e aplicar personalizações do lado da Xsolla para promoções:**\n\n![Personalização para promoções](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-liveops.png)\n\n<div class=\"note\">\n<b>Observação</b><br><br>\nInformações detalhadas são fornecidas:\n<ul>\n  <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>\n  <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>\n</ul>\n</div>"},"itemId":"personalized-catalog","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.217.101"},"lang":"pt","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/pt/api/liveops/personalized-catalog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}