{"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":"Visão geral","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Promoções são ferramentas de marketing para atrair novos usuários e aumentar as vendas. Usando a Xsolla API, você pode configurar as seguintes promoções:\n\n* Descontos — preços reduzidos nos itens selecionados.\n* Bônus — itens concedidos aos usuários ao junto da compra deles.\n* Cupons — códigos que permitem os usuários receberem um ou mais itens bônus ao os resgatarem.\n* Códigos promocionais — códigos que permitem que os usuários recebam itens bônus, um desconto em um item específico, ou um desconto no carrinho inteiro. Diferentemente dos cupons, que são resgatados após a inserção deles pelo usuário, os códigos promocionais são resgatados durante a compra (na finalização).\n* Ofertas exclusivas — itens ocultos exibidos no catálogo a usuários que inseriram um código de oferta exclusiva. Se o código não for inserido, os itens não são exibidos.\n\nExemplo de fluxo para configurar uma promoção de desconto:\n1. Crie itens usando as chamadas 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. Crie uma promoção usando a chamada [Criar promoção de desconto para item](/pt/api/liveops/promotions-discounts/create-item-promotion/). Na matriz `items`, passe os SKUs dos itens necessários.\n3. Configure os períodos de validade da promoção. Para fazer isso, chame os métodos [Criar promoção de desconto para item](/pt/api/liveops/promotions-discounts/create-item-promotion/) ou [Atualizar promoção de item](/pt/api/liveops/promotions-discounts/update-item-promotion/), e passe o campo `promotion_periods` como uma matriz de objetos onde `date_from` define o começo, e `date_until` define a data final do período de validade.\n4. Ative uma promoção usando a chamada [Atualizar promoção de item](/pt/api/liveops/promotions-discounts/update-item-promotion/). Passe o parâmetro`\"is_enabled\": true`.\n5. Para obter informações sobre os preços dos itens, incluindo preços com descontos, chame os métodos da API de cliente para obter um catálogo de itens das subseções [Comum > Catálogo](/pt/api/catalog/tag/common-catalog/), [Itens e Moedas Virtuais > Catalog](/pt/api/catalog/virtual-items-currency-catalog/get-virtual-items/) e [Conjuntos > Catálogo](/pt/api/catalog/bundles-catalog/get-bundle-list/).\n\n![Exemplo de configuração de promoção](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)\n\nConsulte a nossa documentação para obter informações detalhadas sobre a configuração de promoções:\n* [Descontos](https://developers.xsolla.com/pt/liveops/promotion-tools/discounts/)\n* [Bônus](https://developers.xsolla.com/pt/liveops/promotion-tools/bonuses/)\n* [Cupons](https://developers.xsolla.com/pt/liveops/promotion-tools/coupons/)\n* [Códigos promocionais](https://developers.xsolla.com/pt/liveops/promotion-tools/promo-codes/)\n* [Ofertas de catálogo exclusivas](https://developers.xsolla.com/pt/liveops/promotion-tools/unique-offer/)"},"itemId":"promotions-overview","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/promotions-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}