Cadeias de ofertas
Como funciona
Visão geral
Uma cadeia de ofertas é uma sequência de etapas, cada uma contendo um item. Os usuários recebem esse item de graça ou o compram como parte de uma oferta ativa, progredindo pela cadeia uma etapa por vez. A próxima etapa é desbloqueada somente após concluir a anterior.
Uma cadeia de ofertas pode incluir itens disponíveis somente dentro da cadeia, bem como itens por preços descontados quando comparados aos preços da loja. Isso encoraja os usuários a retornarem ao jogo e concluírem a cadeia antes dela expirar. Use essa ferramenta de marketing para reter usuários e aumentar o engajamento.
Os seguintes itens podem ser oferecidos nas etapas da cadeia:
- pacotes de moedas virtuais
- itens virtuais
- conjuntos
Limitações:
- As seguintes configurações de item são ignoradas na cadeia de ofertas:
- regras de personalização
- limites de compra
- disponibilidade programada (data inicial/final)
- promoções e descontos
- Uma quantidade máxima de etapas em uma cadeia de ofertas — 30.
- Uma etapa pode conter apenas um item.
- Você não pode usar o mesmo item em diferentes etapas da cadeia.
Fluxo do usuário
- O usuário visita a loja.
- O usuário vê uma cadeia de ofertas disponíveis e as recompensas para cada etapa.
- O usuário faz login.
- O usuário vê seu progresso atual na cadeia.
- O usuário conclui a etapa atual:
- Se a etapa for gratuita, o usuário clica em Claim reward.
- Se a etapa for paga, o usuário faz um pagamento. O item é concedido ao usuário da mesma maneira de quando é comprado.
- O usuário prossegue à próxima etapa na cadeia.

Visibilidade e comportamento da cadeia de ofertas
A lógica da exibição da cadeia de ofertas é a seguinte:
- Usuários não autorizados podem ver todas as cadeias de ofertas disponíveis na loja.
- Uma vez que o login foi feito, os usuários só veem cadeias de ofertas disponíveis com base nas condições de exibição.
- Se o usuário já resgatou ou comprou itens dentro de uma cadeia, o progresso atual é exibido incluindo as etapas concluídas e a próxima disponível.
- Se o usuário concluir todas as etapas, a cadeia é exibida como concluída.
- A cadeia é renovável, o progresso do usuário é redefinido no cronograma.
Itens reembolsados
Se um item comprado for reembolsado, o progresso do usuário na cadeia de ofertas é alterado. A etapa onde o usuário recebeu o item reembolsado é considerada incompleta. Para prosseguir pela cadeia, o usuário deve comprar o item novamente. As recompensas resgatadas antes do reembolso não são afetadas.
Exemplo:
O usuário resgatou e comprou os itens nas etapas 1, 2 e 3, e então solicitou um reembolso para o item na etapa 2. As etapas 1 e 3 permanecem concluídas, mas a etapa 4 continua bloqueada até o usuário concluir a etapa 2 novamente.
Configuração da cadeia de ofertas
Para criar uma cadeia de ofertas, você precisa configurar os itens. Tenha em mente:
- Se quiser que um item esteja disponível somente pela cadeia, defina seu status para Partially available.
- Se o usuário comprar um item fora da cadeia de ofertas, isso não afeta seu progresso na cadeia.
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 cadeia de ofertas:
- Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Offer chains.
- Selecione Create offer chains.
- Especifique:
- Título da cadeia.
- Descrição da cadeia (opcional).
- Selecione Next.
- Configure a quantidade necessária das etapas da cadeia:
- Selecione Add new step.
- Na lista suspensa Select SKU, selecione um item.
- Se você especificou um preço ao criar o item, mas deseja que a oferta seja gratuita, ative a opção Offer free reward. Para itens criados como gratuitos, essa opção é ativada automaticamente.
- Selecione Save.
- Selecione Next.
- Especifique o fuso horário, data e horário quando a cadeia ficará disponível aos usuários.
- Para limitar a cadeia por tempo, ative a opção Set time limit e especifique a data e horário. Sem essa configuração, a cadeia será considerada indefinida.
- Para configurar a redefinição da cadeia, ative a opção Make offer chain renewable, selecione o período necessário e especifique os parâmetros necessários.
- Selecione Create.
Para disponibilizar uma cadeia de ofertas aos usuários, você deve ativá-la. Para fazer isso:
- Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Offer chains.
- Na fileira com uma cadeia de ofertas, selecione ••• e escolha Publish na lista suspensa.
Configuração via API
Para configurar e gerenciar uma cadeia de ofertas via API, use as seguintes chamadas da seção Admin no grupo Cadeias de ofertas:
| Tarefa | Chamada API |
|---|---|
| Crie uma cadeia. | Criar cadeia de ofertas. |
| Ative uma cadeia. | Passe o parâmetro “is_enabled”: true às chamadas Criar cadeia de ofertas ou Atualizar cadeia de ofertas. Você também pode usar a chamada Alternar cadeia de ofertas. |
| Atualize uma cadeia. | Atualizar cadeia de ofertas. |
| Desative uma cadeia. | Alternar cadeia de ofertas. |
| Excluir uma cadeia. | Excluir cadeia de ofertas. |
Exibir cadeia de ofertas na loja
Exiba no site criado com a Xsolla
Para exibir uma cadeia de ofertas no seu site:
- No seu projeto na Conta de Distribuidor, acesse a seção Storefronts > Websites.
- Selecione seu site e pressione 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 Offer chain.

- No menu lateral, acesse as configurações do bloco.
- Na lista suspensa, selecione a cadeia de ofertas.

- Personalize a aparência do bloco (opcional):
- Configure a aparência da cadeia.
- Configure a aparência das etapas.
- 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 você 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.
Exibir na sua própria interface
- Na interface do seu aplicativo, implemente os elementos para exibir etapas da cadeia de ofertas.
- Implemente a lógica para trabalhar com cadeias usando as seguintes chamadas de API do lado do cliente do grupo Cadeias de ofertas:
| Tarefa | Chamada API |
|---|---|
| Obtenha a lista de cadeias disponíveis. | Obtenha as cadeias de ofertas do usuário atual. |
| Adquira informações sobre o progresso do usuário. | Obter a cadeia de ofertas do usuário atual por ID. |
| Ofereça um item gratuito ao usuário. | Resgate a etapa da cadeia de oferta gratuita. |
| Ofereça um item pago ao usuário. | Criar ordem para a etapa da cadeia de ofertas pagas. |
- Garanta que os itens sejam corretamente concedidos ao usuário.
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.