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.

Observação
Você também pode adicionar promoções de cupons à sua loja.
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.
Depois de ativar um código promocional, o usuário pode receber:
  • 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 Verifique o código promocional ou Redeem promo code. O usuário não poderá obter nenhum dos itens do código promocional.

Fluxo de integração

Observaçã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.

Aviso

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

  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 código promocional

Você pode configurar promoções de código promocional 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 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:

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.

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 e abra a seção Promotions and rewards.
  1. Clique em Criar promoção.
  1. Especifique os seguintes parâmetros:
    • Insira o nome da promoção.
    • Escolha Códigos promocionais como o tipo de promoções.
  2. Crie um ID Externo — um identificador único para a promoção, utilizado para gerenciar as promoções via métodos de API.
  3. Especifique o percentual de desconto do código promocional. O desconto pode ser aplicado à compra inteira ou a itens específicos.
  4. Escolha os itens bônus que o usuário recebe ao resgatar um código promocional:
  1. Especifique a quantidade total de resgates e o limite de resgates por usuário.
  1. Especifique a duração da campanha.
  1. Confira as configurações e salve a promoção.
  2. Vá para o menu de edição da promoção.
  3. Na aba Códigos, escolha como os códigos promocionais devem ser gerados.
  4. Gere o código promocional ou insira-o manualmente.
  5. Salve as alterações.
  6. 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:
  1. Crie um pacote de moedas virtuais.
  2. 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:

  1. Crie um item virtual.
  2. 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:
  1. Crie um pacote de chave de jogo.
  2. 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.

Você pode escolher várias chaves com SKUs diferentes para um código promocional.

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.
Você pode gerar códigos promocionais no editor de promoções depois de criar uma promoção com códigos promocionais. Você pode gerar códigos promocionais várias vezes. O upload dos códigos inseridos manualmente é feito sob demanda via e-mail para Xsolla.
Observação
O código promocional diferencia maiúsculas de minúsculas. Por exemplo, 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:

TarefaMétodo API
Crie uma promoção com um código promocionalCrie uma promoção de código promocional
Ative uma promoção com um código promocionalAtive uma promoção de código promocional
Editar promoçãoAtualize 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çãoDesative a promoção de código promocional
Configure uma promoção indefinidaCrie 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.
Verificando e aplicando o código promocional:
TarefaMétodo API
Confira se o código promocional está corretoVerifique o código promocional
Resgatar código promocionalResgatar 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 promocionalObter recompensas do código promocional
Gerenciamento de limites:
TarefaMétodo API
Obtenha a quantidade de usos restantes de código promocional que um usuário específico temObté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íficoAumenta 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íficoDefine 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íficoReduz 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.

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!