Recompensas diárias

Como funciona

Recompensas diárias motivam os usuários a fazerem login na loja todos os dias para receberem itens grátis. Você pode criar os seguintes tipos de recompensas diárias:

• Login reward — recompensas que são desbloqueadas sequencialmente a cada 24 horas, começando a partir do primeiro login do usuário.
• Reward calendar — recompensas que são desbloqueadas ao mesmo tempo todos os dias e para todos os usuários. O cronograma de recompensas é global e não depende da data em que um usuário específico faz login na loja.

1. Exemplo: Se um usuário fizer login na loja pela primeira vez no dia 4 da promoção, ele verá a recompensa para o dia 4 da cadeia.

Os seguintes tipos de itens podem ser usados como recompensas:

• Itens Virtuais
• Moedas virtuais
• Pacotes de moedas virtuais
• Conjuntos

As seguintes configurações de item são ignoradas na cadeia de recompensas diárias:

• regras de personalização
• limites de compra
• disponibilidade programada (data inicial/final)
• promoções e descontos

As recompensas diárias são exibidas como cadeias que os usuários podem desbloquear consecutivamente. Você pode publicar cadeias de recompensas diárias recorrentes que automaticamente reiniciam depois que o último dia na cadeia é concluído.

Para garantir que o sistema de recompensas diárias funcione corretamente, você deve ativar a autenticação dos usuários.

Usuários não autenticados podem ver a cadeia de recompensas completa, mas não podem resgatar recompensas.

Fluxo do usuário

1. O usuário visita a loja.
2. O usuário vê a cadeia de recompensas diárias e a recompensa disponível pelo acesso do dia.
3. O usuário faz login.
4. O usuário vê seu progresso atual na cadeia de recompensas diárias.
5. O usuário resgata a recompensa diária.

Configuração através da Conta de Distribuidor

Antes de criar uma cadeia de recompensas diárias, você precisa criar itens que os usuários podem obter de graça ao fazerem login na loja.

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.

Criar recompensas diárias

Para criar recompensas diárias:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção LiveOps > Daily rewards.
2. Selecione Create daily rewards.

3. Especifique os seguintes parâmetros:
   • Forneça um título para a cadeia de recompensas diárias.
   • Insira uma descrição (opcional).

4. Selecione Next.
5. Adicione uma recompensa pelo dia da cadeia. Para fazer isso:

1. 1. Selecione Add reward.

1. 2. Selecione um item, especifique a quantidade que usuários recebem como recompensa por esse dia, e selecione Save.

6. Depois de adicionar as recompensas para cada dia, selecione Next.
7. Selecione o tipo de recompensas diárias — Login reward ou Reward calendar. O tipo de recompensa na etapa de criação e não pode ser alterado em seguida.
8. Especifique a data inicial e horário para as recompensas diárias.
9. Pelo tipo Login reward, você pode ativar a opção Add time limit e especificar a data de término e o horário da promoção.

Observação

Para o tipo Reward calendar, a data de término é calculada automaticamente com base na quantidade de dias para os quais recompensas foram criadas.

10. Se quiser que a cadeia de recompensas diárias recomece depois de acabar, ative a opção Make promotion renewable.

1. A lógica de renovação depende do tipo de cadeia:

1. • A cadeia Login reward é reiniciada após o fim do ciclo atual, antes da promoção acabar.

1. 1. Exemplo: uma cadeia de 5 recompensas está disponível entre 1 de outubro e 31 de outubro. Se essa configuração estiver ativada, o usuário poderá iniciar um novo clico de recompensas depois que o atual terminar (depois de receber 5 recompensas ou redefinir o progresso). Cada novo ciclo começa com a primeira recompensa na cadeia. Múltiplas renovações são possíveis ao longo do período de promoção, até e incluindo 31 de outubro.

1. • A cadeia Reward calendar renova-se para todos os usuários com uma frequência equivalente ao comprimento da cadeia de recompensas.

1. 1. Exemplo: uma cadeia de 5 recompensas está disponível a partir de 1º de outubro. Se essa configuração estiver ativada, a cadeia será renovada para todos os usuários a cada 5 dias — os dias 6, 11 e 16 de outubro, e assim por diante.

11. Selecione Create.

1. Exemplo: em uma cadeia de 5 recompensas, se o usuário fizer login 3 dias em seguida e pular o quarto dia, no quinto dia:
   • O usuário receberá a primeira recompensa na cadeia se a configuração de redefinição estiver ativada.
   • O usuário receberá a quarta recompensa na cadeia se a configuração de redefinição estiver desativada.

12. Selecione Create.

1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Daily rewards.
2. Na fileira com uma recompensa diária, selecione ••• e escolha Activate na lista suspensa.

Editar recompensas diárias

Você também pode ativar, desativar e editar as recompensas diárias. Para as recompensas do tipo Login reward, você também pode redefinir o progresso de todos os usuários no ciclo de recompensas diárias atual. Para alterar as configurações, pressione ••• na fileira da recompensa diária e selecione a ação desejada.

Configuração via API

Para configurar e gerenciar uma cadeia de recompensas diárias via API, use as seguintes chamadas da seção Admin no grupo Correntes diárias:

Exibir recompensas diárias na loja

Exibir no site criado com a Xsolla

Para exibir uma recompensa diária no seu site:

1. No seu projeto na Conta de Distribuidor, acesse a seção Storefronts > Websites.
2. Selecione seu site e pressione Open Site Builder.

3. Na área principal do construtor, escolha um lugar onde você deseja adicionar um novo bloco e selecione Add block.
4. Selecione o bloco Daily rewards.

5. No menu lateral, acesse as configurações do bloco.
6. Na lista suspensa, escolha a cadeia de recompensa diária.

7. Para ver uma prévia da cadeia de recompensas, selecione Preview no canto superior direito do construtor.
8. Para aplicar as alterações, publique o site:
   1. No canto superior direito do construtor de sites, selecione Publish.
   2. Marque as caixas que ao lado das páginas que deseja publicar.
   3. Selecione Publish.

Os usuários não verão a cadeia de recompensas diárias até que ela seja ativada e o período de validade inicie.

As cadeias de recompensas diárias com datas expiradas ou cadeias que ainda não começaram serão exibidas no modo prévia no construtor de sites. Esse modo permite que você visualize todas as alterações não publicadas, incluindo cadeias inativas.

Exibir na sua própria interface

1. Na interface do seu aplicativo, implemente os elementos para exibir etapas da cadeia de recompensas diárias.
2. Implemente a lógica para trabalhar com cadeias usando as seguintes chamadas de API do lado do cliente do grupo Correntes diárias:
   • Obter recompensas diárias do usuário atual
   • Obtém a recompensa diária do usuário atual por seu ID
   • Resgatar etapa da recompensa diária
3. Garanta que os itens sejam corretamente concedidos ao usuário.