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.
A principal diferença é que os códigos promocionais são resgatados durante uma compra, enquanto cupons são resgatados independentemente sem requisito de compra.
- 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 Redeem coupon code. O usuário não será capaz de obter nenhum dos itens do cupom.
Fluxo de integração
- Na sua loja, exiba o campo onde o usuário pode inserir o código do cupom.
- Use o método Verifique o código promocional para validar o código do cupom.
- Use o método Redeem coupon code 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
- Cadastre-se na Conta de Distribuidor.
- 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.
- Abra seu projeto na Conta de Distribuidor.
- No menu lateral, clique em Store.
- No painel Promotions and rewards, clique em:
- Conectar — se você não tiver promoções
- Configurar — se você conectou promoções anteriormente
- Clique em Criar promoção.
- Especifique os seguintes parâmetros:
- Insira o nome da promoção.
- Escolha Coupon como tipo de promoção.
- Crie um ID Externo — um identificador de promoção exclusivo utilizado para gerenciar promoções via métodos de API.
- 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).
- Especifique a quantidade total de resgates e a quantidade de resgates por usuário.
- Configure as datas de início e fim da campanha.
- Confira as configurações e salve a promoção.
- Vá para o menu de edição de promoções.
- No menu Códigos, escolha o método para gerar os cupons.
- Gere o código de cupom ou insira-o manualmente.
- Salve as alterações.
- 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:- 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
- 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
- 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:- Caracteres inseridos manualmente — Adequada para campanhas com apenas um cupom que pode ser usado muitas vezes (máximo de 128 caracteres).
- Caracteres gerados — Linha de numerais e símbolos latinos (10 caracteres). Adequada para campanhas com muitos cupons.
winter2021
e WINTER2021
são 2 cupons diferentes.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:
Tarefa | Método API |
---|---|
Crie uma promoção com um cupom | Crie uma promoção de cupom |
Ative uma promoção com um cupom | Ative uma promoção de cupom |
Editar promoção | Atualize a promoção de cupom com novas opções de promoção. A edição de promoções também está disponível para promoções com o status Ativa. |
Desativar promoção | Desative uma promoção de cupom |
Configure uma promoção indefinida | Crie uma promoção de cupom ou Atualize uma promoção de cupom. Passe o parâmetro “date_end”:null ao método especificado. |
Tarefa | Método API |
---|---|
Confira se o cupom está correto | Verifique o código promocional |
Resgatar cupom | Resgatar código do cupom |
Obtenha uma lista de plataformas de distribuição de jogos para exibir ao usuário caso uma chave de jogo seja fornecido como bônus de um cupom | Obter recompensas de cupom |
Tarefa | Método API |
---|---|
Obtenha a quantidade de usos restantes de cupom que um usuário específico tem | Obtém o limite de cupons de um usuário específico |
Aumente a quantidade restante de usos do cupom para um usuário específico | Aumenta o limite de cupons de um usuário específico |
Defina um novo limite de usos de um código de cupom para um usuário específico | Define o limite de cupons de um usuário específico |
Reduza a quantidade restante de usos do código de cupom para um usuário específico | Reduz o limite de cupons de um usuário específico |
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.