Códigos promocionais

Como funciona

Os códigos promocionais são uma ferramenta de marketing para atrair novos usuários e aumentar as vendas. Depois de ativar um código promocional, o usuário recebe uma das seguintes opções de recompensa:

• um desconto que se aplica ao carrinho do usuário ou a itens específicos
• um dos itens bônus:
  • chave do jogo
  • pacote de moedas virtuais
  • item virtual incluindo um conjunto ou itens de tempo limitado

Principais características:

• escolher apenas um desconto, apenas um item bônus, ou ambos um desconto e um item como recompensa
• definir o número total de resgates do código promocional dentro da campanha
• definir o número de resgates de código promocional para um usuário dentro da campanha
• definir restrições regionais a pedido
• geração múltipla de códigos promocionais
• adicionar um item bônus ao carrinho depois de aplicar o código promocional
• aplicar um desconto aos itens após usar um código promocional

Restrições:

• apenas 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 incluir um item com restrições de venda regionais, um usuário de uma região onde esses itens são limitados, não poderá receber itens usando este código promocional

Como funciona

Fluxo do usuário:

1. O usuário insere o código promocional no campo correspondente na interface.

2. O custo dos itens é recalculado, itens bônus são adicionados.
3. O usuário efetua um pagamento, após o qual o código promocional é considerado resgatado.
4. Se o código promocional incluir alguns itens bônus, eles serão entregues ao usuário de uma das seguintes maneiras:
• diretamente para o inventário (item virtual ou um pacote de moedas virtuais)
• via e-mail (uma chave de jogo)
• diretamente para o sistema de direitos (uma chave de jogo)

• o resultado da aplicação de uma promoção de desconto:
  • valor do desconto para a promoção
  • preço riscado sem desconto
  • preço com desconto
• o resultado da aplicação da promoção de bônus:
  • itens bônus
  • Valor grátis na linha de preço para itens bônus
• o resultado da aplicação do código promocional
  • valor de desconto para o código promocional
  • preço riscado sem desconto
  • preço com desconto
  • itens bônus
  • Valor grátis na linha de preço para itens bônus

Como obtê-lo

Pré-requisitos

1. Crie sua Conta de Distribuidor Xsolla.
2. Conecte o módulo Game Keys e configure-o.

Fluxo de integração

• Configure uma campanha promocional com códigos promocionais.
• Implemente o método de obter uma recompensa de código promocional.
• Implemente os métodos de resgate de código promocional.

Se você estiver implementando uma compra rápida de uma chave usando o método Criar pedido com item especificado, o usuário prosseguirá para o pagamento sem ir ao carrinho.

Ao mesmo tempo, um carrinho é criado no lado da Xsolla, que não é exibido para o usuário. Isso é necessário para aplicar corretamente todos os descontos existentes na compra do usuário e exibir o valor, incluindo todos os descontos, no formulário de pagamento.

Configure uma campanha com códigos promocionais

1. Vá para Store > Promotions and rewards na Conta de Distribuidor e crie uma promoção.
2. Especifique os seguintes parâmetros:
1. Insira o nome da promoção.
2. Escolha Promo codes como o tipo de promoção.
3. Crie um ID Externo — um identificador de promoção exclusivo usado para gerenciar promoções usando os métodos receiving rewards e redeeming promo code.
4. Especifique a porcentagem de desconto para o código promocional. O desconto pode ser aplicado a todo o carrinho ou a itens específicos.
5. 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 pacotes e itens de tempo limitado)
• chave de jogo
6. Especifique o número total de resgates e o número de resgates por usuário.
7. Especifique a duração da campanha.
8. Verifique as configurações e salve a promoção.
9. Vá para o menu de edição da promoção.
10. Na aba Codes, escolha como os códigos promocionais são gerados.
11. Gere o código promocional ou insira-o manualmente.
12. Salve as alterações.
13. 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.

Para criar um pacote de moedas virtuais:

1. Vá para as configurações de módulo Store > Virtual Currency e crie uma moeda virtual. Para fazer isso, clique em New virtual currency e adicione:
   • imagem do pacote (opcional)
   • SKU da moeda virtual
   • nome da moeda virtual
   • preço de uma unidade de moeda virtual
   • moeda padrão (opcional)
   • atributo (opcional)
2. Crie os pacotes de moedas virtuais. Para fazer isso, clique em New Package e adicione:
   • imagem do pacote (opcional)
   • SKU do pacote
   • nome do pacote
   • breve descrição do pacote
   • moeda virtual do pacote
   • quantia de moeda no pacote
   • preços em moedas reais ou (e) virtuais
   • moeda padrão
   • atributo (opcional)
3. Clique em Create package.

Código promocional com um item virtual

Para criar um código promocional com um item virtual:

1. Create a virtual item.
2. Especifique um item virtual como um item bônus.

Para criar itens virtuais:

1. Vá para as configurações de módulo Store > Virtual Items e clique em Create Item.
2. Para cada item, adicione:
   • image (opcional)
   • SKU
   • um ou vários grupos aos quais o item deve pertencer (opcional)
   • nome do item
   • descrição do item
   • propriedade itens – consumíveis, não consumíveis ou de tempo limitado
   • preços em moedas reais ou (e) virtuais
3. Clique em Create Item.

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.

Geração de códigos promocionais

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

Restrições regionais

Recebimento de recompensas com códigos promocionais

1. Se o valor for is_selectable=true, você deve mostrar o formulário para escolher elementos do objeto unit_items para cada item com o elemento type=unit. Neste formulário, o usuário escolhe apenas um elemento para cada tipo de unit.

{
	"bonus": [{
		"item": {
			"sku": "xsollus_gold_edition",
			"name": "Xsollus: Gold Edition",
			"type": "unit",
			"description": null,
			"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
			"unit_items": [{
				"sku": "xsollus_gold_edition_steam",
				"name": "Xsollus: Gold Edition (steam)",
				"type": "game_key",
				"drm_name": "Steam",
				"drm_sku": "steam"
			}, {
				"sku": "xsollus_gold_edition_playstation",
				"name": "Xsollus: Gold Edition (playstation)",
				"type": "game_key",
				"drm_name": "Playstation",
				"drm_sku": "playstation"
			}, {
				"sku": "xsollus_gold_edition_xbox",
				"name": "Xsollus: Gold Edition (xbox)",
				"type": "game_key",
				"drm_name": "XBox",
				"drm_sku": "xbox"
			}, {
				"sku": "xsollus_gold_edition_nintendo_eshop",
				"name": "Xsollus: Gold Edition (nintendo_eshop)",
				"type": "game_key",
				"drm_name": "Nintendo Switch eShop",
				"drm_sku": "nintendo_eshop"
			}]
		},
		"quantity": 1
	}, {
		"item": {
			"sku": "xsollus_bonus_pack_edition",
			"name": "Xsollus: Bonus Pack",
			"type": "unit",
			"description": null,
			"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
			"unit_items": [{
				"sku": "xsollus_bonus_pack_edition_steam",
				"name": "Xsollus: Bonus Pack (steam)",
				"type": "game_key",
				"drm_name": "Steam",
				"drm_sku": "steam"
			}, {
				"sku": "xsollus_bonus_pack_edition_origin",
				"name": "Xsollus: Bonus Pack (origin)",
				"type": "game_key",
				"drm_name": "Origin",
				"drm_sku": "origin"
			}, {
				"sku": "xsollus_bonus_pack_edition_drmfree",
				"name": "Xsollus: Bonus Pack (drmfree)",
				"type": "game_key",
				"drm_name": "DRM Free",
				"drm_sku": "drmfree"
			}, {
				"sku": "xsollus_bonus_pack_edition_gog",
				"name": "Xsollus: Bonus Pack (gog)",
				"type": "game_key",
				"drm_name": "GOG",
				"drm_sku": "gog"
			}, {
				"sku": "xsollus_bonus_pack_edition_rockstar",
				"name": "Xsollus: Bonus Pack (rockstar)",
				"type": "game_key",
				"drm_name": "Rockstar Games Launcher",
				"drm_sku": "rockstar"
			}]
		},
		"quantity": 3
	}],
	"discount": {
		"percent": null
	},
	"is_selectable": true

2. Se for is_selectable=false, você não deve passar parâmetros adicionais na solicitação.

Resgate de um código promocional

1. Se is_selectable=true, você deve passar o objeto selected_unit_items no seguinte formato ao chamar o método Redeem promo code:

selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Exemplo de resposta:

{
  {
    "items": [
    {
      "sku": "xsollus_gold_edition_steam",
      "name": "Xsollus: Gold Edition (steam)",
      "type": "game_key",
      "description": null,
      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
      "attributes": [],
      "is_free": true,
      "groups": [],
      "price": null,
      "virtual_prices": [],
      "drm_name": "Steam",
      "drm_sku": "steam",
      "has_keys": false,
      "is_pre_order": true,
      "release_date": null,
      "quantity": 1
    },
    {
      "sku": "xsollus_bonus_pack_edition_origin",
      "name": "Xsollus: Bonus Pack (origin)",
      "type": "game_key",
      "description": null,
      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
      "attributes": [],
      "is_free": true,
      "groups": [],
      "price": null,
      "virtual_prices": [],
      "drm_name": "Origin",
      "drm_sku": "origin",
      "has_keys": false,
      "is_pre_order": true,
      "release_date": null,
      "quantity": 3
    }
    ]
}

2. Se for is_selectable=false, você não deve passar parâmetros adicionais na solicitação.