# Visão geral

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:

* Descontos — preços reduzidos nos itens selecionados.
* Bônus — itens concedidos aos usuários ao junto da compra deles.
* Cupons — códigos que permitem os usuários receberem um ou mais itens bônus ao os resgatarem.
* 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).
* 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.

Exemplo de fluxo para configurar uma promoção de desconto:
1. 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).
2. 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.
3. 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.
4. 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`.
5. 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/).

![Exemplo de configuração de promoção](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)

Consulte a nossa documentação para obter informações detalhadas sobre a configuração de promoções:
* [Descontos](https://developers.xsolla.com/pt/liveops/promotion-tools/discounts/)
* [Bônus](https://developers.xsolla.com/pt/liveops/promotion-tools/bonuses/)
* [Cupons](https://developers.xsolla.com/pt/liveops/promotion-tools/coupons/)
* [Códigos promocionais](https://developers.xsolla.com/pt/liveops/promotion-tools/promo-codes/)
* [Ofertas de catálogo exclusivas](https://developers.xsolla.com/pt/liveops/promotion-tools/unique-offer/)