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.

Observação
Você também pode adicionar promoções de códigos promocionais à sua loja.
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.
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 Redeem coupon code. O usuário não será capaz de obter nenhum dos itens do cupom.

Fluxo de integração

Observação
Para resgatar o cupom e receber os itens bônus, o usuário deve estar autorizado.
  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 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

  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:

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:

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.

Observação
Novas promoções ficam inativas por padrão. Para ativar sua promoção, edite-a e, no canto superior direito da lista suspensa, selecione Activate promotion.
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
  1. Clique em Criar promoção.
  1. 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:
  1. Especifique a quantidade total de resgates e a quantidade de resgates por usuário.
  1. Configure as datas de início e fim da campanha.
  1. Confira as configurações e salve a promoção.
  1. Vá para o menu de edição de promoções.
  2. No menu Códigos, escolha o método para gerar os cupons.
  3. Gere o código de cupom ou insira-o manualmente.
  4. Salve as alterações.
  5. 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.
Observação
O código do cupom diferencia maiúsculas de minúsculas. Por exemplo, 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:

TarefaMétodo API
Crie uma promoção com um cupomCrie uma promoção de cupom
Ative uma promoção com um cupomAtive uma promoção de cupom
Editar promoçãoAtualize 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çãoDesative uma promoção de cupom
Configure uma promoção indefinidaCrie uma promoção de cupom ou Atualize uma promoção de cupom. Passe o parâmetro “date_end”:null ao método especificado.
Verificando e aplicando o código promocional:
TarefaMétodo API
Confira se o cupom está corretoVerifique o código promocional
Resgatar cupomResgatar 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 cupomObter recompensas de cupom
Gerenciamento de limites:
TarefaMétodo API
Obtenha a quantidade de usos restantes de cupom que um usuário específico temObtém o limite de cupons de um usuário específico
Aumente a quantidade restante de usos do cupom para um usuário específicoAumenta 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íficoDefine 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íficoReduz o limite de cupons de um usuário específico
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 3 de Outubro de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!