Cupons

Como funciona

Campanhas de cupom permitem que os usuários recebam itens bônus configurados na campanha sem fazer uma compra. O campo de inserção do cupom é exibido no catálogo.

Depois de resgatar um código promocional, o usuário pode receber um item bônus:

• chave de jogo
• pacote de moedas virtuais
• item virtual, incluindo um conjunto de itens de tempo limitado

Recursos principais:

• limitar a quantidade total de resgates de cupom dentro da campanha
• limitar a quantidade de resgates de cupons de um único usuário dentro da campanha
• gerar múltiplos cupons
• aplicar restrições regionais de venda nas promoções e itens vinculados ao cupom

Restrições:

• Se as chaves de jogo forem anexadas como itens bônus a um cupom, depois que o cupom for resgatado, a chave será enviada ao endereço de e-mail do usuário. Se as chaves da campanha acabarem, o usuário não será capaz de resgatar o cupom.
• Se forem aplicadas restrições regionais a uma promoção de cupom, os usuários das regiões restringidas não serão capazes de resgatar o cupom.
• Se o cupom incluir um item com uma restrição regional de venda, os usuários que estiverem em uma região onde o item estiver indisponível não poderão receber os itens.
  Exemplo: uma espada e um escudo são oferecidos como bônus de um cupom. O escudo possui uma restrição regional e só está disponível para compra nos EUA. Se um usuário fora dos EUA inserir o código do cupom, será retornado um erro em resposta aos métodos Verifique o código promocional ou Resgatar código de cupom. O usuário não será capaz de obter nenhum dos itens do cupom.

Fluxo de integração

1. Na sua loja, exiba o campo onde o usuário pode inserir o código do cupom.
2. Use o método Verifique o código promocional para validar o código do cupom.
3. Use o método Resgatar código de cupom para resgatar o cupom. Se uma chave de jogo for fornecida como bônus, ela é entregue ao endereço de e-mail do usuário.

Como obtê-lo

Pré-requisitos

1. Cadastre-se na Conta de Distribuidor.
2. Conecte a Store e configure os módulos Itens Virtuais e Moeda Virtual.

Configure uma promoção com um cupom

Você pode configurar promoções de cupons das seguintes maneiras:

• via a Conta de Distribuidor
• via métodos de API

Em qualquer uma das opções para configurar uma promoção, é necessário implementar chamadas de métodos de API para conferir a exatidão do código de cupom e resgatar o código de cupom.

Configuração através da Conta de Distribuidor

Se você configurar promoções bônus pela Conta de Distribuidor, você pode:

• definir o período de validade da promoção
• limitar a quantidade de vezes que a promoção pode ser utilizada pelo usuário
• configurar promoções que se aplicam a qualquer tipo de itens:
  • pacotes de moedas virtuais
  • itens virtuais (incluindo itens de tempo limitado)
  • chaves de jogo
  • conjuntos

A edição de promoções de cupom com um status Active não está disponível na Conta de Distribuidor no momento.

Você pode usar métodos de API para melhorar suas opções de configuração de promoções de cupom.

Para configurar uma promoção pela Conta de Distribuidor:

1. Abra seu projeto na Conta de Distribuidor.
2. No menu lateral, clique em Store.
3. No painel Promotions and rewards, clique em:
   • Conectar — se você não tiver promoções
   • Configurar — se você conectou promoções anteriormente

4. Clique em Criar promoção.

5. Especifique os seguintes parâmetros:
   1. Insira o nome da promoção.
   2. Escolha Coupon como tipo de promoção.
   3. Crie um ID Externo — um identificador de promoção exclusivo utilizado para gerenciar promoções via métodos de API.
   4. Escolha o item bônus que o usuário recebe ao resgatar um cupom:
      • Pacote de moedas virtuais.
      • Chave de jogo.
      • Item virtual (um ou vários, incluindo conjuntos e itens de tempo limitado).

6. Especifique a quantidade total de resgates e a quantidade de resgates por usuário.

7. Configure as datas de início e fim da campanha.

8. Confira as configurações e salve a promoção.

9. Vá para o menu de edição de promoções.
10. No menu Códigos, escolha o método para gerar os cupons.
11. Gere o código de cupom ou insira-o manualmente.
12. Salve as alterações.
13. Ative a promoção.

Cupom com pacote de moeda virtual

Você deve especificar o pacote de moeda para um cupom de pacote de moeda virtual. Para criar um pacote de moeda virtual:

1. Vá para as configurações do módulo Moeda virtual e especifique os seguintes parâmetros:
   • Imagem
   • SKU
   • Nome da moeda
   • Preço de uma unidade da moeda virtual
   • Moeda padrão
2. Crie um número necessário de pacotes de moeda e especifique os seguintes parâmetros para cada um deles:
   • Imagem
   • SKU
   • Nome
   • Descrição
   • Moeda utilizada
   • Quantia em um pacote
   • Preço
   • Moeda padrão
3. Habilite os pacotes de moeda exibidos na Loja.

Cupom com chave de jogo

Você deve especificar um SKU de chave de jogo e informações de DRM para um cupom de chave de jogo. Existem 2 opções:

• Gerar cupons para o DRM já definido. O parâmetro é definido ao gerar cupons.
• Escolha um DRM ao usar um cupom.

Cupom com itens virtuais

Você deve especificar o SKU do item virtual e sua quantidade para um cupom de itens virtuais. Você pode escolher um ou vários itens com SKUs diferentes para um cupom, incluindo pacotes e itens de tempo limitado.

Geração de cupons

Uma campanha pode incluir um ou vários cupons. O formato do cupom tem 2 opções:

1. Caracteres inseridos manualmente — Adequada para campanhas com apenas um cupom que pode ser usado muitas vezes (máximo de 128 caracteres).
2. Caracteres gerados — Linha de numerais e símbolos latinos (10 caracteres). Adequada para campanhas com muitos cupons.

Você pode gerar cupons no editor de promoções depois de criar uma promoção de cupons. Você pode gerar um código várias vezes. O envio dos códigos inseridos manualmente é feito sob demanda via e-mail para a Xsolla.

Restrições regionais

As restrições regionais aplicam-se a toda a campanha promocional. As restrições regionais são aplicadas a pedido via e-mail para a Xsolla.

Configuração por meio de métodos de API

Para trabalhar com promoções de códigos de cupom, você pode usar os métodos da subseção Cupons do grupo de métodos Promoções.

Configuração da promoção:

Verificando e aplicando o código promocional:Gerenciamento de limites:Última atualização: 3 de Outubro de 2024