Códigos promocionais
Como funciona
Promoções com códigos promocionais permitem que usuários comprem itens com preços descontados e recebam itens bônus de acordo com as configurações da campanha. O campo de inserção do código promocional pode ser exibido no catálogo ou no carrinho.
A principal diferença é que os códigos promocionais são resgatados durante uma compra, e cupons são resgatados independentemente sem requisito de compra.
- um desconto que é aplicado à compra inteira ou a itens específicos
um item bônus:
- chave de jogo
- pacote de moedas virtuais
- item virtual, incluindo um conjunto de itens de tempo limitado
Recursos principais:
- fornecer um desconto, item bônus ou ambos como recompensa de um código promocional
- limitar a quantidade máxima de resgates do código promocional dentro de uma campanha
- limitar a quantidade de resgates do código promocional que um usuário específico pode fazer dentro da campanha
- gerar múltiplos códigos promocionais
- configurar restrições regionais como desejado
- adicionar um item bônus ao carrinho depois de aplicar o código promocional
- aplicar um desconto aos itens após o uso de um código promocional
Restrições:
- Somente um código promocional pode ser aplicado ao carrinho.
- Para obter um desconto ou bônus, o usuário deve pagar pelos itens no carrinho.
- Se um código promocional inclui um item com restrições regionais de venda, o usuário na região onde os itens estão indisponíveis não poderá receber esses itens.
Exemplo: um código promocional oferece um escudo e uma espada como bônus. O escudo possui uma restrições regionais e está disponível para compra somente nos EUA. Se um usuário fora dos EUA inserir o código promocional, será retornado um erro em resposta aos métodos Verify promotion code ou Redeem promo code. O usuário não poderá obter nenhum dos itens do código promocional.
Fluxo de integração
Os cenários descritos abaixo representam a situação de um usuário autorizado.
Para usuários não autorizados, a quantidade máxima de vezes que uma promoção pode ser usada é sempre exibida. Para exibir a quantidade restante de vezes que uma promoção pode ser utilizada pelo usuário (sujeita ao limite atual), passe os dados de autorização do usuário ao solicitar os dados do catálogo de itens usando os métodos da subseção Catálogo do grupo de métodos Itens Virtuais e Moeda.
Você pode configurar diferentes tipos de promoções para um item: descontos, cupons, códigos promocionais e bônus.
Se várias promoções forem válidas para um item no momento da compra, os descontos serão aplicados ao item um a um. A ordem em que os descontos são aplicados não importa.
Por exemplo:
O preço de um item virtual é de $10 USD. Na Conta de Distribuidor, as seguintes promoções foram criadas para os itens virtuais:
- Black Friday — promoção de desconto com um desconto de 10% de 4 a 30 de novembro.
- Oferta — promoção de desconto com um desconto de 20% de 15 de novembro a 15 de dezembro.
- Promoção com um código promocional para um desconto de 5% de 4 a 30 de novembro.
Se o item for comprado em 20 de novembro, tanto as promoções de desconto quanto as promoções com códigos promocionais são válidas.
O custo total do item virtual é então calculado como (($10 - 10%) - 20%) - 5%, e será de $6,84 USD.
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 código promocional
Você pode configurar promoções de código promocional 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 promocional e resgatar o código promocional.
Configuração através da Conta de Distribuidor
Se você configurar códigos promocionais 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
Não é possível editar promoções de código promocional com o status Ativa atualmente na Conta de Distribuidor.
Você pode usar métodos de API para aprimorar suas opções de configuração das promoções de código promocional.
- Abra seu projeto na Conta de Distribuidor.
- No menu lateral, clique em Store e abra a seção Promotions and rewards.
- Clique em Criar promoção.
- Especifique os seguintes parâmetros:
- Insira o nome da promoção.
- Escolha Códigos promocionais como o tipo de promoções.
- Crie um ID Externo — um identificador único para a promoção, utilizado para gerenciar as promoções via métodos de API.
- Especifique o percentual de desconto do código promocional. O desconto pode ser aplicado à compra inteira ou a itens específicos.
- Escolha os itens bônus que o usuário recebe ao resgatar um código promocional:
- sem recompensa
- pacote de moedas virtuais
- item virtual (um ou mais, incluindo conjuntos e itens de tempo limitado)
- chave de jogo
- Especifique a quantidade total de resgates e o limite de resgates por usuário.
- Especifique a duração da campanha.
- Confira as configurações e salve a promoção.
- Vá para o menu de edição da promoção.
- Na aba Códigos, escolha como os códigos promocionais devem ser gerados.
- Gere o código promocional ou insira-o manualmente.
- Salve as alterações.
- Ative a promoção.
Código promocional com um pacote de moeda virtual
Para criar um código promocional com um pacote de moeda virtual:- Crie um pacote de moedas virtuais.
- Especifique um pacote de moedas virtuais como um item bônus.
Código promocional com um item virtual
Para criar um código promocional com um item virtual:
- Crie um item virtual.
- Especifique um item virtual como um item bônus.
Você pode escolher um ou vários itens com SKUs diferentes para um código promocional, incluindo conjuntos e itens de tempo limitado.
Código promocional com uma chave de jogo
Para criar um código promocional com uma chave de jogo:- Crie um pacote de chave de jogo.
Especifique o SKU do pacote de chave de jogo criado como um bônus e o método de escolha da plataforma para a qual o jogo é comprado:
- O código promocional é gerado para a plataforma específica já definida.
- O usuário seleciona uma plataforma específica ao usar códigos promocionais.
Geração de códigos promocionais
Uma campanha pode incluir um ou vários códigos promocionais. O formato de código promocional tem 2 opções:- Cadeia de caracteres inserida manualmente — adequada para uma campanha com apenas um código promocional que pode ser usado muitas vezes (o máximo é de 128 caracteres).
- Cadeia de caracteres gerada — linha de numerais e símbolos latinos (10 caracteres). Combina com a campanha com muitos códigos promocionais.
winter2021
e WINTER2021
são 2 códigos promocionais 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 promocionais, você pode usar os métodos da subseção Códigos Promocionais do grupo de métodos Promoções.
Configuração da promoção:
Tarefa | Método API |
---|---|
Crie uma promoção com um código promocional | Crie uma promoção de código promocional |
Ative uma promoção com um código promocional | Ative uma promoção de código promocional |
Editar promoção | Atualize a promoção de código promocional com novas opções de promoção. A edição de promoções também está disponível para promoções com o status Active. |
Desativar promoção | Desative a promoção de código promocional |
Configure uma promoção indefinida | Crie uma promoção de código promocional ou Atualize uma promoção de código promocional. Passe o parâmetro “date_end”:null ao método especificado. |
Tarefa | Método API |
---|---|
Confira se o código promocional está correto | Verifique o código promocional |
Resgatar código promocional | Resgatar código promocional |
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 código promocional | Obter recompensas do código promocional |
Tarefa | Método API |
---|---|
Obtenha a quantidade de usos restantes de código promocional que um usuário específico tem | Obtém o limite de códigos promocionais de um usuário específico |
Aumente a quantidade restante de usos do código promocional para um usuário específico | Aumenta o limite de códigos promocionais de um usuário específico |
Defina um novo limite de usos de um código promocional para um usuário específico | Define o limite de códigos promocionais de um usuário específico |
Reduza a quantidade restante de usos do código promocional para um usuário específico | Reduz o limite de códigos promocionais de um usuário específico |
Se o campo de inserção do código promocional for posicionado no catálogo, solicite o catálogo de itens do usuário novamente passando o parâmetro promo_code
nos métodos de construção do catálogo na subseção Catálogo.
Se você estiver implementando uma compra rápida de um item usando Criar pedido com o método de item especificado, passe as informações sobre o código promocional no parâmetro promo_code
. Isso permite que a compra seja feita com o código promocional aplicado.
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.