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 todas as anteriores.
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.
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 de funcionamento da cadeia de ofertas é a seguinte:
- A disponibilidade da cadeia de ofertas depende das configurações de visibilidade e personalização configuradas para uma cadeia particular.
- 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 primeiro. 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 a seção Catálogo de itens > Todos os itens. 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.
- Se quiser personalizar a cadeia de ofertas:
- Ative a opção Personalized offer chain.
- Selecione uma das opções de exibição:
- Show offer chain to specific users. Defina as condições de personalização. Nesse caso, a cadeia é exibida apenas a usuários autorizados que cumprirem as condições especificadas.
- Show offer chain to users who don’t meet conditions. Para tal cadeia, você não precisa especificar as condições de personalização — ela é aplicada por padrão. Isso significa que é exibida a usuários não autorizados, bem como nos casos de que nenhuma cadeia de ofertas correspondente é encontrada para um usuário autorizado.
- 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 Activate 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. |
| Personalize a cadeia. | Crie uma cadeia de ofertas ou Atualize uma cadeia de ofertas. Passe as condições de visibilidade na matriz attribute_conditions.Você também pode configurar a visibilidade da cadeia usando o parâmetro is_always_visible. A lógica da exibição da cadeia será a seguinte:
|
| 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 conferir a cadeia, selecione Preview no canto superior direito do construtor.
- 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.