Sistema de recompensa

Glossário

Como funciona

O sistema de recompensa oferece a oportunidade de incentivar os usuários que compram itens regularmente na loja do jogo com moedas reais. Nesse caso, os usuários recebem motivações adicionais para usar a loja do jogo ou a loja virtual.

Você pode criar cadeias de recompensas distribuindo recompensas para cada certa quantidade de moeda real gasta. Pode haver várias cadeias no jogo. O comprimento máximo de uma cadeia é de 31 passos. Cada etapa tem uma condição de execução — ganhar um determinado número de pontos de valor que mostram o progresso do usuário no sistema de recompensa.

Em cada etapa, o usuário pode receber de 1 a 10 recompensas.

Você pode recompensar os usuários distribuindo os seguintes tipos de item:

• itens virtuais
• moedas virtuais
• pacotes de moedas virtuais
• conjuntos

Usuários não autorizados podem ver cadeias de recompensas, mas não o próprio progresso. O número de pontos de valor agregado e o progresso no sistema de recompensa são exibidos ao usuário após a autorização.

Fluxo do usuário

1. O usuário acessa o site.
2. O usuário vê o catálogo de itens, as recompensas disponíveis e o número de pontos de valor que podem ser recebidos pela compra de cada item.
3. O usuário faz login ou se inscreve no site.
4. O usuário vê seu progresso no sistema de recompensa e pode avançar nas cadeias de recompensa ganhando pontos de valor pela compra de itens.

Como obtê-lo

Para configurar um sistema de recompensas, você precisará dos seguintes dados:

• data inicial e final do sistema de recompensa

• uma imagem, descrição, SKUs e nomes de pontos de valor que permitem o progresso na cadeia de recompensas
• o número de pontos de valor e itens na cadeia de recompensas

Veja os exemplos abaixo.

Cadeia de recompensas:

Descrição	Exemplo
Nome	Fragmento
Texto explicativo	Para obter recompensas, colete os fragmentos.
SKU	ExemploSKU003
Imagem ou seu URL

• exibição de elementos do sistema de recompensa na loja:
  • o número de pontos de valor que são concedidos por comprar itens no catálogo
  • pontos de valor
  • passos
  • cadeias de recompensas
  • o saldo dos pontos de valor do usuário autorizado
  • recompensas
• integração dos métodos de recompensa

• Get virtual items list
• Get current user’s reward chains
• Get current user’s value point balance
• Claim step reward

Configuração através da Conta de Distribuidor

Antes de criar a cadeia de recompensas, você deverá criar pontos de valor.

Criar pontos de valor

Para criar pontos de valor:

1. Abra seu projeto na Conta de Distribuidor.
2. Clique em Store no menu lateral.
3. No painel Promotions and rewards, clique em:
   • Connect — se você não tiver promoções ou recompensas.
   • Configure – se você conectou promoções ou recompensas anteriormente.

4. Na aba Rewards, clique em Create value points.

5. Especifique os seguintes parâmetros:
   • Imagem (opcional).
   • SKU de pontos de valor especiais.
   • Nome dos pontos de valor.

6. Clique em Next.
7. Clique em + e selecione o SKU do item virtual e a quantidade de pontos de valor que o usuário receberá por compra.

8. Clique em Save.

Pontos de valor são criados e exibidos acima das cadeias de recompensa. Se necessário, você pode alterá-las usando o botão Edit.

Criar cadeia de recompensas

Para criar a cadeia de recompensas:

1. Abra seu projeto na Conta de Distribuidor.
2. No painel lateral, clique em Store.
3. No painel Promotions and rewards, clique em:
   • Connect — se você não tiver promoções nem recompensas.
   • Configure — se você conectou promoções ou recompensas anteriormente.

4. Na aba Rewards, clique em Create reward.

5. Especifique os seguintes parâmetros:
   • Reward chain name.
   • Descrição.
   • Na lista suspensa, escolha os pontos de valor.

6. Clique em Next.
7. Especifique os seguintes parâmetros:
   • Nome da etapa.
   • Quantidade necessária de pontos de valor para resgatar a recompensa.
   • Quantia necessária de itens virtuais para a etapa.

8. Clique em Save.

9. Clique em Next.

10. Especifique o período de validade da cadeia de recompensas.

11. Clique em Save.

A cadeia de recompensas é criada e exibida em um catálogo.

Para ativar a cadeia de recompensas:

1. No catálogo de recompensas, escolha a cadeia de recompensas.
2. Clique em ••• e escolha Activate na lista suspensa.

Configure por meio de chamadas de API

Você pode usar os métodos da subseção Admin do grupo de métodos Reward chains & Value points para trabalhar com o sistema de recompensas.

1. Crie os pontos de valor que dão acesso a recompensas no sistema de recompensas através da API Create value point.
2. Use a API Set value points for items para conceder pontos de valor aos usuários depois de comprar certos itens.
3. Crie o sistema de recompensas através da API Create reward chain.
4. Ative o sistema de recompensas através da API Toggle reward chain.

Você pode alterar, desativar ou excluir o sistema de recompensas e remover pontos de valor de itens.