Cupons

Como funciona

Campanhas de cupons são uma ferramenta de marketing desenvolvida para atrair usuários em potencial ao seu produto e gerar vendas. Quando um usuário resgata um cupom, ele recebe um ou mais itens bônus. Os seguintes itens podem ser usados como recompensas:

• pacotes de moedas virtuais
• chaves de jogo
• itens virtuais
• conjuntos

Um cupom contém um código exclusivo. Para resgatar um cupom, o usuário deve inserir o código dentro do cliente do jogo ou uma loja do jogo, incluindo a Web Shop.

Recursos principais:

• Definição da quantidade total de resgates dentro de uma campanha.
• Definição da quantidade de resgates por usuário dentro de uma campanha.
• Múltipla geração de códigos para cupons.
• Aplicação de restrições regionais para campanhas e itens vinculados a um cupom.

Limitações:

• Se chaves de jogo forem usadas como um item bônus, a chave será enviada ao usuário via e-mail ou para o sistema de direitos após o resgate. Se a campanha exaurir as chaves, o usuário não poderá resgatar o cupom.
• Se as restrições regionais forem aplicadas a uma campanha de cupom, os usuários dessas regiões não poderão resgatar o cupom.
• Se um cupom incluir ao menos um item bônus com uma restrição regional, um usuário daquela região não poderá receber o item usando esse cupom.

1. Exemplo: Um escudo e espada são oferecidos como bônus com o cupom. O escudo tem uma restrição regional e está disponível para compra somente nos EUA. Se um usuário fora dos EUA inserir o código do cupom, um erro será retornado em resposta às chamadas Verificar o código promocional ou Resgatar código de cupom. O usuário não conseguirá obter qualquer um dos itens do cupom.

Fluxo do usuário:

1. Um usuário autorizado acessa a loja.
2. O usuário insere o código do cupom.
3. A Xsolla retorna uma lista de itens bônus disponíveis para o cupom (opcional).
4. O usuário seleciona os bônus (opcional).
5. O usuário resgata o cupom.
6. Os itens vinculados ao cupom são creditados ao usuário da mesma maneira que uma compra normal.

Definição de campanha de cupom

Pré-requisitos

Antes de configurar uma campanha de cupom, você deve configurar os itens que serão emitidos como bônus.

Para criar itens manualmente no seu projeto na Conta de Distribuidor, acesse a seção Items catalog > All items. Encontre informações detalhadas sobre esse e outros métodos para criar itens na seção Catálogo de itens da documentação.

Configuração na Conta de Distribuidor

Para criar uma nova campanha de cupom:

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
2. Na aba Promotions, selecione Create promotion.

3. Especifique os parâmetros da promoção principal:

1. 1. Especifique o Promotion name.

1. 2. Na lista suspensa Promotion type, selecione Coupon.

1. 3. No campo External ID, especifique um ID de promoção usado para gerenciar promoções via chamadas de API.

1. 4. Na lista suspensa Select bonus items, selecione o tipo de um item a ser concedido ao usuário após o resgate do cupom.

1. 5. Selecione os itens que serão concedidos a um usuário ao resgatar o cupom.

1. 1. Para itens virtuais, especifique a quantidade para cada item.

1. 1. Para chaves de jogo, especifique quando a plataforma será determinada:
      • Para pré-atribuir uma plataforma específica (ex.: Steam), selecione Select DRM during code generation na lista suspensa Type of DRM selection. Depois, selecione a plataforma da lista suspensa DRM.
      • Para permitir que o usuário escolha, selecione Player selects DRM at redemption na lista suspensa Type of DRM selection.

Observação

Você pode selecionar tipos diferentes de itens como bônus. Para trocar entre os tipos de itens diferentes, use o campo Select bonus items. As informações sobre todos os itens selecionados são exibidas na área List of bonus items.

1. 6. Selecione Next.

4. Configure os limites de resgate de cupom:

1. 1. Para limitar a quantidade total de resgates de cupons entre todos os usuários dentro de uma campanha, defina a opção Limit total number of coupon redemptions como On e especifique a quantidade máxima de resgates.

1. 2. Para limitar a quantidade de cupons que um único usuário pode resgatar dentro de uma campanha, defina a opção Limit total number of redemptions per user como On e especifique a quantidade máxima de resgates por usuário.

1. 3. Para limitar a quantidade de vezes que qualquer código de cupom exclusivo pode ser resgatado entre todos os usuários, defina a opção Limit number of unique coupon code redemptions como On e especifique a quantidade máxima de resgates para o cupom.

1. 4. Selecione Next.

5. Especifique o período de validade da campanha: um fuso horário, data inicial e data final. Para criar uma campanha sem uma data final, marque a caixa No end date.
6. Selecione Next.
7. Revise as configurações de campanha.
8. Selecione Save and exit.

Para adicionar códigos de cupom a uma campanha:

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
2. Na fileira da promoção de cupom, selecione ••• e escolha Edit promotion na lista suspensa.

3. Vá para a aba Codes.
4. Para gerar códigos automaticamente:

1. 1. Na lista suspensa Code string format, selecione Auto-generated.

1. 2. Especifique a quantidade de códigos a gerar e selecione Generate.

5. Para adicionar códigos manualmente:

1. 1. Na lista suspensa Code string format, selecione Manually entered.

1. 2. Insira o código do cupom e selecione Create.

1. 2. Repita a etapa anterior para adicionar a quantidade necessária de códigos.

6. Baixe um arquivo CSV com os códigos (opcional).

Para disponibilizar a campanha aos usuários, você deve ativá-la. Para fazer isso:

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
2. Na fileira da promoção de cupom, selecione ••• e escolha Edit promotion na lista suspensa.
3. Na lista suspensa no canto superior direito, selecione Activate promotion.

Configurar via API

Para configurar e gerenciar campanhas de cupom via API, use as seguintes chamadas:

Defina uma resgate de cupom no seu aplicativo ou site

Resgate de cupom na sua própria interface

Para permitir que os usuários resgatem cupons no seu aplicativo ou site:

3. Garanta que os itens sejam corretamente concedidos ao usuário no resgate do cupom.

1. Se você já implementou uma loja no jogo no seu aplicativo ou no seu site, não é necessária nenhuma outra configuração. Os itens vinculados a um cupom são concedidos ao usuário da mesma maneira que uma compra padrão.

O resgate de cupons no site criado com a Xsolla

Para exibir o campo de entrada de código no seu site:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Storefronts > Websites.
2. Na seção Sites, selecione seu site e clique em Open Site Builder.
3. Na área principal do construtor, escolha um lugar onde você deseja adicionar um novo bloco e selecione Add block.
4. Selecione o bloco Promo codes.
5. Personalize a aparência do bloco (opcional):
   • Edite o cabeçalho do bloco e texto de descrição.
   • Defina um plano de fundo personalizado para o bloco.
   • Altere o estilo do botão.
   • Edite o texto para o botão de resgate do cupom.
6. Para aplicar as alterações, publique o site:

1. 1. No canto superior direito do construtor de sites, selecione Publish.

1. 2. Marque as caixas próximas às páginas que deseja publicar.

1. 3. Selecione Publish.