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.

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:

• 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

Configuração na Conta de Distribuidor

Para criar uma nova campanha com códigos promocionais:

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
2. Na aba Promotions, selecione Create promotion.

3. Especifique o Nome da promoção (Promotion name).
4. Na lista suspensa Promotion type, selecione Promo code.
5. No campo External ID, especifique um ID de promoção usado para gerenciar promoções via chamadas de API.
6. Para aplicar um desconto a qualquer item ou o carrinho inteiro quando um código promocional é resgatado:

1. 1. Defina a poção Discount on purchase como On.

1. 2. Campo Discount amount, especifique o percentual de desconto.

7. Para aplicar um desconto a itens específicos quando um código promocional é resgatado:

1. 1. Defina a opção Discount on selected items como On.

1. 2. Campo Discount amount, especifique o percentual de desconto.

1. 3. Na lista suspensa Item type, selecione o tipo do item que será descontado ao resgatar o código promocional.

1. 4. Selecione os itens.

8. Para fornecer itens bônus quando um código promocional é resgatado:

1. 1. Defina a opção Bonus items como On.

1. 2. 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.

1. 3. Selecione os itens a serem fornecidos ao resgatar o código promocional.

1. 1. Para itens virtuais, especifique a quantidade para cada item.

1. 1. 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.

1. 4. Selecione Next.

9. Configure limites de resgate de códigos promocionais:

1. 1. 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.

1. 2. 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.

1. 3. 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.

1. 4. Selecione Next.

10. Especifique o período de validade da promoção: um fuso horário, data inicial e data final. Para criar uma promoção sem uma data final, marque a caixa No end date.

Observação

Para adicionar outro período de validade de promoção, clique em +. Se uma promoção tem múltiplos períodos de validade, cada um deve ter uma data final. A promoção termina no último segundo do minuto especificado. Por exemplo, se um período final estiver definido para 12:00 a promoção ocorrerá até 12:00:59.

11. Selecione Next.
12. Revise as configurações de campanha.
13. Selecione Save and exit.

Para adicionar códigos promocionais a uma campanha:

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
2. Na fileira da promoção de código promocional, selecione ••• e escolha Edit promotion na lista suspensa.

3. Vá para a aba Codes.
4. Para gerar códigos automaticamente:

1. 1. Na lista suspensa Code string format, selecione Auto-generated.

1. 2. Especifique a quantidade de códigos a gerar e selecione Generate.

5. Para adicionar códigos manualmente:

1. 1. Na lista suspensa Code string format, selecione Manually entered.

1. 2. Insira o código promocional e selecione Create.

1. 3. Repita a etapa anterior para adicionar a quantidade necessária de códigos.

6. Baixe um arquivo CSV com os códigos (opcional).

Para disponibilizar a campanha aos usuários, você deve ativá-la. Para fazer isso:

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
2. Na fileira da promoção de código promocional, selecione ••• e escolha Edit promotion na lista suspensa.
3. Na lista suspensa no canto superior direito, selecione Activate promotion.

Configurar via API

Para configurar e gerenciar campanhas com códigos promocinais via API, use as seguintes chamadas:

Defina uma resgate de código promocional no seu aplicativo ou site

Uso de código promocional na sua interface

1. 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
2. Implemente a lógica do código promocional usando as seguintes chamadas API do lado do cliente:

3. Garanta que os itens sejam corretamente concedidos ao usuário no resgate do código promocional.

1. 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:

3. Se seu site incluir múltiplas páginas, selecione a que você precisa:
   1. Selecione o título da página atual no topo do construtor.
   2. Selecione a página necessária na lista suspensa.
4. Na área principal do construtor, escolha um lugar onde você deseja adicionar um novo bloco e selecione Add block.
5. Selecione o bloco Promo codes.
6. 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.

7. Para aplicar as alterações, publique o site:

1. 1. No canto superior direito do construtor de sites, selecione Publish.

1. 2. Marque as caixas próximas às páginas que deseja publicar.

1. 3. Selecione Publish.

Como funciona

Campanhas de cupons são uma ferramenta de marketing desenvolvida para atrair usuários em potencial ao seu produto e gerar vendas. Quando um usuário resgata um cupom, ele recebe um ou mais itens bônus. Os seguintes itens podem ser usados como recompensas:

• pacotes de moedas virtuais
• chaves de jogo
• itens virtuais
• conjuntos

Um cupom contém um código exclusivo. Para resgatar um cupom, o usuário deve inserir o código dentro do cliente do jogo ou uma loja do jogo, incluindo a Web Shop.

Recursos principais:

• 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 para cupons.
• Aplicação de restrições regionais para campanhas e itens vinculados a um cupom.

Limitações:

• 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 cupom.
• Se as restrições regionais forem aplicadas a uma campanha de cupom, os usuários dessas regiões não poderão resgatar o cupom.
• Se um cupom incluir ao menos um item bônus com uma restrição regional, um usuário daquela região não poderá receber o item usando esse cupom.

1. Exemplo: Um escudo e espada são oferecidos como bônus com o cupom. O escudo tem uma restrição regional e está disponível para compra somente nos EUA. Se um usuário fora dos EUA inserir o código do cupom, um erro será retornado em resposta às chamadas Verificar o código promocional ou Resgatar código de cupom. O usuário não conseguirá obter qualquer um dos itens do cupom.

Fluxo do usuário:

1. Um usuário autorizado acessa a loja.
2. O usuário insere o código do cupom.
3. A Xsolla retorna uma lista de itens bônus disponíveis para o cupom (opcional).
4. O usuário seleciona os bônus (opcional).
5. O usuário resgata o cupom.
6. Os itens vinculados ao cupom são creditados ao usuário da mesma maneira que uma compra normal.

Definição de campanha de cupom

Pré-requisitos

Antes de configurar uma campanha de cupom, você deve configurar os itens que serão emitidos como bônus.

Para criar itens manualmente no seu projeto na Conta de Distribuidor, acesse a seção 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 de cupom:

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
2. Na aba Promotions, selecione Create promotion.

3. Especifique os parâmetros da promoção principal:

1. 1. Especifique o Promotion name.

1. 2. Na lista suspensa Promotion type, selecione Coupon.

1. 3. No campo External ID, especifique um ID de promoção usado para gerenciar promoções via chamadas de API.

1. 4. Na lista suspensa Select bonus items, selecione o tipo de um item a ser concedido ao usuário após o resgate do cupom.

1. 5. Selecione os itens que serão concedidos a um usuário ao resgatar o cupom.

1. 1. Para itens virtuais, especifique a quantidade para cada item.

1. 1. 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.

Observação

Você pode selecionar tipos diferentes de itens como bônus. Para trocar entre os tipos de itens diferentes, use o campo Select bonus items. As informações sobre todos os itens selecionados são exibidas na área List of bonus items.

1. 6. Selecione Next.

4. Configure os limites de resgate de cupom:

1. 1. Para limitar a quantidade total de resgates de cupons entre todos os usuários dentro de uma campanha, defina a opção Limit total number of coupon redemptions como On e especifique a quantidade máxima de resgates.

1. 2. Para limitar a quantidade de cupons 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.

1. 3. Para limitar a quantidade de vezes que qualquer código de cupom exclusivo pode ser resgatado entre todos os usuários, defina a opção Limit number of unique coupon code redemptions como On e especifique a quantidade máxima de resgates para o cupom.

1. 4. Selecione Next.

5. Especifique o período de validade da promoção: um fuso horário, data inicial e data final. Para criar uma promoção sem uma data final, marque a caixa No end date.

Observação

Para adicionar outro período de validade de promoção, clique em +. Se uma promoção tem múltiplos períodos de validade, cada um deve ter uma data final. A promoção termina no último segundo do minuto especificado. Por exemplo, se um período final estiver definido para 12:00 a promoção ocorrerá até 12:00:59.

6. Selecione Next.
7. Revise as configurações de campanha.
8. Selecione Save and exit.

Para adicionar códigos de cupom a uma campanha:

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
2. Na fileira da promoção de cupom, selecione ••• e escolha Edit promotion na lista suspensa.

3. Vá para a aba Codes.
4. Para gerar códigos automaticamente:

1. 1. Na lista suspensa Code string format, selecione Auto-generated.

1. 2. Especifique a quantidade de códigos a gerar e selecione Generate.

5. Para adicionar códigos manualmente:

1. 1. Na lista suspensa Code string format, selecione Manually entered.

1. 2. Insira o código do cupom e selecione Create.

1. 2. Repita a etapa anterior para adicionar a quantidade necessária de códigos.

6. Baixe um arquivo CSV com os códigos (opcional).

Para disponibilizar a campanha aos usuários, você deve ativá-la. Para fazer isso:

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Promotions.
2. Na fileira da promoção de cupom, selecione ••• e escolha Edit promotion na lista suspensa.
3. Na lista suspensa no canto superior direito, selecione Activate promotion.

Configurar via API

Para configurar e gerenciar campanhas de cupom via API, use as seguintes chamadas:

Defina uma resgate de cupom no seu aplicativo ou site

Resgate de cupom na sua própria interface

Para permitir que os usuários resgatem cupons no seu aplicativo ou site:

3. Garanta que os itens sejam corretamente concedidos ao usuário no resgate do cupom.

1. 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 cupom são concedidos ao usuário da mesma maneira que uma compra padrão.

O resgate de cupons no site criado com a Xsolla

Para exibir o campo de entrada de código no seu site:

3. Se seu site incluir múltiplas páginas, selecione a que você precisa:
   1. Selecione o título da página atual no topo do construtor.
   2. Selecione a página necessária na lista suspensa.
4. Na área principal do construtor, escolha um lugar onde você deseja adicionar um novo bloco e selecione Add block.
5. Selecione o bloco Promo codes.
6. 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.

7. Para aplicar as alterações, publique o site:

1. 1. No canto superior direito do construtor de sites, selecione Publish.

1. 2. Marque as caixas próximas às páginas que deseja publicar.

1. 3. Selecione Publish.