Códigos promocionais
Como funciona
Informações gerais
Promoções com códigos promocionais são uma ferramenta de marketing desenvolvida para reforçar as taxas de conversões de compra e aumentar a receita média. Quando um código promocional é aplicado a um pedido, o usuário pode receber:
- um desconto aplicado na compra inteira ou em itens específicos
- itens bônus, incluindo:
- pacotes de moedas virtuais
- chaves de jogo
- itens virtuais
- conjuntos
Recursos principais:
- Configuração de bônux flexível. Você pode configurar um tipo de bônus único (desconto em uma compra, desconto em itens específicos, ou um item bônus) ou uma combinação deles.
- Definição da quantidade total de resgates dentro de uma campanha.
- Definição da quantidade de resgates por usuário dentro de uma campanha.
- Múltipla geração de códigos promocionais.
- Aplicação de restrições regionais para campanhas e itens vinculados a um código promocional.
Limitações:
- Apenas um código promocional pode ser aplicado à compra.
- Para receber um desconto ou item bônus, o usuário deve pagar pela compra.
- Descontos não são aplicados a preços especificados nas moedas virtuais. Para itens tanto com preços de moedas reais e virtuais, os descontos se aplicam somente ao preço de moedas reais.
- Se chaves de jogo forem usadas como um item bônus, a chave será enviada ao usuário via e-mail ou para o sistema de direitos após o resgate. Se a campanha exaurir as chaves, o usuário não poderá resgatar o código promocional.
- Se as restrições regionais forem aplicadas a uma campanha de código promocional, os usuários dessas regiões não poderão resgatar o código promocional.
- Se um código promocional incluir ao menos um item bônus com uma restrição regional, um usuário daquela região não poderá resgatar esse código promocional.
Você também pode configurar promoções de cupons para sua loja.
Principais diferenças:
- Um cupom permite que um usuário receba somente itens bônus. Um código promocional pode fornecer itens bônus, um desconto para um item específico, ou um desconto no carrinho inteiro.
- Códigos promocionais são resgatados durante a compra (na finalização), e os cupons são resgatados após o usuário inserir e aplicar o código.
Fluxo do usuário
Regras para aplicar descontos
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.
Exemplo:
O preço de um item virtual é $10. Na Conta de Distribuidor, as seguintes promoções foram criadas para os itens virtuais:
- Promoção de desconto Black Friday com um desconto de 10% entre 4 e 30 de novembro
- Promoção de desconto Oferta com um desconto de 20% entre 15 de novembro e 15 de dezembro
- promoção com um código promocional de 5% de desconto entre 4 e 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% = $10 × (100%-10%) × (100%-20%) × (100%-5%) = $10 × 0,9 × 0,8 × 0,95, e será de $6,84 USD.
Configure uma campanha com códigos promocionais
Se quiser criar uma promoção com itens bônus, você precisa primeiro configurar esses itens e então prosseguir à configuração da promoção.
Para criar itens manualmente no seu projeto na Conta de Distribuidor, acesse Items catalog > All items. Encontre informações detalhadas sobre esse e outros métodos para criar itens na seção Catálogo de itens da documentação.
Configuração na Conta de Distribuidor
Para criar uma nova campanha com códigos promocionais:
- Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
- Na aba Promotions, selecione Create promotion.
- Especifique o Nome da promoção (Promotion name).
- Na lista suspensa Promotion type, selecione Promo code.
- No campo External ID, especifique um ID de promoção usado para gerenciar promoções via chamadas de API.
- Para aplicar um desconto a qualquer item ou o carrinho inteiro quando um código promocional é resgatado:
- Defina a poção Discount on purchase como On.
- Campo Discount amount, especifique o percentual de desconto.
- Para aplicar um desconto a itens específicos quando um código promocional é resgatado:
- Defina a opção Discount on selected items como On.
- Campo Discount amount, especifique o percentual de desconto.
- Na lista suspensa Item type, selecione o tipo do item que será descontado ao resgatar o código promocional.
- Selecione os itens.
- Para fornecer itens bônus quando um código promocional é resgatado:
- Defina a opção Bonus items como On.
- Na lista suspensa Select bonus items, selecione o tipo de um item a ser concedido ao usuário após o resgate do código promocional.
- Selecione os itens a serem fornecidos ao resgatar o código promocional.
- Para itens virtuais, especifique a quantidade para cada item.
- Para chaves de jogo, especifique quando a plataforma será determinada:
- Para pré-atribuir uma plataforma específica (ex.: Steam), selecione Select DRM during code generation na lista suspensa Type of DRM selection. Depois, selecione a plataforma da lista suspensa DRM.
- Para permitir que o usuário escolha, selecione Player selects DRM at redemption na lista suspensa Type of DRM selection.
- Para chaves de jogo, especifique quando a plataforma será determinada:
- Selecione Next.
O desconto para um pedido ou itens específicos deve ser um número inteiro e não pode exceder 99%. Ao configurar descontos para itens específicos ou itens bônus, considere o seguinte:
- Um tipo de item fica disponível para seleção somente se ao menos um item daquele tipo foi criado no seu projeto.
- Você pode configurar itens ou tipos diferentes. Para trocar entre tipos de itens, use o campo de seleção do tipo de item.
- Configure limites de resgate de códigos promocionais:
- Para limitar a quantidade total de resgates de códigos promocionais entre todos os usuários dentro de uma campanha, defina a opção Limit total number of redemptions como On e especifique a quantidade máxima de resgates.
- Para limitar a quantidade de códigos promocionais que um único usuário pode resgatar dentro de uma campanha, defina a opção Limit total number of redemptions per user como On e especifique a quantidade máxima de resgates por usuário.
- Para limitar a quantidade de vezes que qualquer código promocional exclusivo pode ser resgatado entre todos os usuários, defina a opção Limit number of unique promo code redemptions como On e especifique a quantidade máxima de resgates para o cupom promocional.
- Selecione Next.
- Especifique o período de validade da campanha: um fuso horário, data inicial e data final. Para criar uma campanha sem uma data final, marque a caixa No end date.
- Selecione Next.
- Revise as configurações de campanha.
- Selecione Save and exit.
Para adicionar códigos promocionais a uma campanha:
- Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
- Na fileira da promoção de código promocional, selecione ••• e escolha Edit promotion na lista suspensa.
- Vá para a aba Codes.
- Para gerar códigos automaticamente:
- Na lista suspensa Code string format, selecione Auto-generated.
- Especifique a quantidade de códigos a gerar e selecione Generate.
- Para adicionar códigos manualmente:
- Na lista suspensa Code string format, selecione Manually entered.
- Insira o código promocional e selecione Create.
- Repita a etapa anterior para adicionar a quantidade necessária de códigos.
- Baixe um arquivo CSV com os códigos (opcional).
Códigos promocionais diferenciam maiúsculas de minúsculas. Por exemplo, winter123 e WINTER123 são considerados cupons promocionais diferentes.
Você pode adicionar novos códigos a uma campanha quantas vezes quiser sem limitações. Porém, a quantidade total de códigos adicionados não pode exceder 50.000.
Se você precisar enviar uma quantidade grande de códigos autogerados, contate-nos via igs@xsolla.com.
Para disponibilizar a campanha aos usuários, você deve ativá-la. Para fazer isso:
- Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
- Na fileira da promoção de código promocional, selecione ••• e escolha Edit promotion na lista suspensa.
- Na lista suspensa no canto superior direito, selecione Activate promotion.
Configurar via API
- os parâmetros necessários
- os parâmetros que você deseja alterar
- todos os outros parâmetros retornados pela chamada de recuperação de promoções
Para configurar e gerenciar campanhas com códigos promocinais via API, use as seguintes chamadas:
| Tarefa | Chamada API |
|---|---|
| Crie uma promoção com um código promocional. | Crie uma promoção de código promocional. |
| Ativar uma promoção com um código promocional. | Ative uma promoção de código promocional. |
| Edite uma 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. |
| Defina uma promoção de prazo indeterminado. | Create promo code promotion ou Update promo code promotion. Passe o parâmetro “date_end”:null às chamadas especificadas. |
| Exclua uma promoção. | Delete promo code promotion. |
Defina uma resgate de código promocional no seu aplicativo ou site
Uso de código promocional na sua interface
Na interface do seu aplicativo (no catálogo ou carrinho), implemente os seguintes elementos:
- um campo de entrada de código promocional
- Elementos de interface para exibir recompensas e descontos de código promocional
- um formulário de seleção para recompensas de código promocional (se aplicável)
- um botão para aplicar o código promocional
Implemente a lógica do código promocional usando as seguintes chamadas API do lado do cliente:
| Tarefa | Chamada API |
|---|---|
| Confira se o código promocional é válido. | Verificar o código promocional. |
| Obtenha uma lista de plataformas de distribuição de jogos para exibir ao usuário se uma chave de jogo é fornecida como bônus de cupom promocional. | Obter recompensas de código promocional. Se a resposta retornar O parâmetro |
| Exiba o catálogo atualizado considerando descontos e itens bônus de um código promocional. | Use chamadas da subseção Catalog. Você precisa passar o código promocional no parâmetro de solicitação promo_code. |
| Compre um item específico diretamente (sem adicioná-lo ao carrinho) e resgate um código promocional. | Criar pedido com item especificado. Você precisa passar o código promocional no parâmetro de solicitação |
| Aplique um código promocional e atualize o conteúdo do carrinho e custo total (aplicar descontos e adicionar itens bônus). | Você precisa passar o código promocional no parâmetro de solicitação |
- Garanta que os itens sejam corretamente concedidos ao usuário no resgate do código promocional.
- Se você já implementou uma loja no jogo no seu aplicativo ou no seu site, não é necessária nenhuma outra configuração. Os itens vinculados a um código promocional são concedidos ao usuário da mesma maneira que uma compra padrão.
Uso de códigos promocionais no site criados com a Xsolla
Para exibir o campo de entrada de código no seu site:
- Abra seu projeto na Conta de Distribuidor e acesse a seção Storefronts > Websites.
- Na seção Sites, selecione seu site e clique em Open Site Builder.
- Na área principal do construtor, escolha um lugar onde você deseja adicionar um novo bloco e selecione Add block.
- Selecione o bloco Promo codes.
- Personalize a aparência do bloco (opcional):
- Edite o cabeçalho do bloco e texto de descrição.
- Defina um plano de fundo personalizado para o bloco.
- Altere o estilo do botão.
- Edite o texto para o botão de resgate do cupom.
- Para aplicar as alterações, publique o site:
- No canto superior direito do construtor de sites, selecione Publish.
- Marque as caixas próximas às páginas que deseja publicar.
- Selecione Publish.
Se a publicação do site não estiver disponível, certifique-se de que todas as condições sejam cumpridas:
- Não há seções vazias no construtor (marcadas com um indicador vermelho).
- O Acordo de Licenciamento com a Xsolla foi assinado.
- A página principal foi publicada ou selecionada para publicação. Você não pode publicar páginas descendentes antes da página principal.
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.