Limites de uso da promoção

Como funciona

Você pode definir um limite de quantas vezes uma promoção pode ser utilizada por um usuário e configurar redefinições programadas a esses limites. A configuração de limites está disponível para promoções bônus e de desconto. Você pode ativar redefinições periódicas de limites para:

• permitir compras repetidas usando a mesma promoção.
• sincronizar dados com o seu sistema quando itens são vendidos entre diversas plataformas de publicação de jogos.

Quando um usuário atinge o limite de uso da promoção, o item se torna disponível pelo preço total sem desconto ou bônus.

Para exibir corretamente os usos restantes da promoção disponíveis a um usuário, você deve configurar a autenticação.

Usuários não autenticados sempre veem a quantidade máxima de usos de promoção. Para exibir os usos restantes da promoção que o usuário tem com o limite ativo aplicado, inclua os dados de autorização do usuário ao fazer a solicitação:

• o catálogo de itens usando chamadas da subseção Catálogo do grupo Itens virtuais & Moeda.
• O catálogo de jogos usando chamadas da subseção Catálogo do grupo Game Keys.

Para configurar limites de compra de itens, consulte as instruções.

Configuração e atualização de limites

Configuração e atualização na Conta de Distribuidor

Para criar uma promoção de quantidade limitada:

1. Abra seu projeto na Conta de Distribuidor e vá para a seção LiveOps > Promotions.
2. Selecione Create promotion.
3. Insira o título da promoção.
4. Na lista suspensa, escolha o tipo Discount ou Bonus.
5. Preencha os campos dependendo do tipo de promoção escolhido.
6. Selecione Next.
7. Para limitar a quantidade de vendas, na página Conditions, defina a opção Limit number of times one user can use promotion como On e insira a quantidade de usos.

8. Para configurar promoções personalizadas, defina a opção Promotion for only specific users como On e siga essas instruções.
9. Selecione Next.
10. Defina das datas de início e finalização da campanha. Especifique o fuso horário, data inicial e data final. Para tornar a campanha disponível indefinidamente, selecione No end date.
11. Selecione Next.
12. Confira as configurações e selecione Save and exit.
13. Para ativar uma promoção:
    1. Encontre a promoção no seu catálogo de promoções.
    2. Clique no botão de menu ••• e selecione Edit promotion.
    3. No canto superior direito, abra o menu suspenso e escolha Activate promotion.

Para configurar ou atualizar limites para uma promoção existente:

1. Abra seu projeto na Conta de Distribuidor e vá para a seção LiveOps > Promotions.
2. Na fileira da promoção, selecione ••• e escolha Edit promotion na lista suspensa.
3. Se a promoção que você precisa estiver ativada, desative-a no canto superior direito da lista suspensa.
4. Na página Condition and limits, selecione Refresh this limit manually.
5. Confirme a ação e selecione Save changes.
6. Para ativar a promoção, no canto superior direito, abra o menu suspenso e escolha Activate promotion.

Configure e atualize via chamadas API

Para definir limites diários, semanais ou mensais, passe a matriz limites nas seguintes chamadas API:

• Criar promoção de desconto para item
• Criar promoção de bônus

Para atualizar e gerenciar limites, use as chamadas API da seção Limits:

Exibe os limites no catálogo de itens

Limites de uso da promoção são exibidos no catálogo dependendo de como ele é implementado — seja pelo Site Builder ou via API.

Exibição via site builder

Se você utilizar o construtor de sites, os limites são exibidos automaticamente. Depois de configurar um limite de uso da promoção, o cartão do item exbirá:

• a quantidade do desconto para promoções de desconto
• uma mensagem bônus para as promoções bônus
• um contador indicando a quantidade de itens promocionais disponíveis para compra

Obter informações de limites via API

Se o catálogo for implementado usando a API, a informação de limites de uso da promoção é retornada na matriz promotions.limits nas seguintes chamadas API relacionadas ao catálogo:

• Obter lista de itens virtuais
• Obter lista de moedas virtuais
• Obter lista de pacotes de moedas virtuais
• Obter lista de pacotes
• Obter lista de jogos

Você pode usar esses dados para exibir os limites de uso da promoção no catálogo — por exemplo, para exibir a quantidade máxima de usos da promoção disponíveis ao usuário.Última atualização: 13 de Fevereiro de 2026