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

  1. O usuário visita a loja.
  2. O usuário vê uma cadeia de ofertas disponíveis e as recompensas para cada etapa.
  3. O usuário faz login.
  4. O usuário vê seu progresso atual na cadeia.
  5. 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.
  6. 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

Observação

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:

  1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Offer chains.
  2. Selecione Create offer chains.
  3. Especifique:
    • Título da cadeia.
    • Descrição da cadeia (opcional).
  4. Selecione Next.
  5. Configure a quantidade necessária das etapas da cadeia:
    1. Selecione Add new step.
    2. Na lista suspensa Select SKU, selecione um item.
    3. 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.
    4. Selecione Save.
  1. Selecione Next.
  2. Especifique o fuso horário, data e horário quando a cadeia ficará disponível aos usuários.
  3. 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.
  4. 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.
  5. Selecione Create.

Para disponibilizar uma cadeia de ofertas aos usuários, você deve ativá-la. Para fazer isso:

  1. Na sua Conta de Distribuidor do seu projeto, acesse a seção LiveOps > Offer chains.
  2. 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:

TarefaChamada 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.
Observação
Se você desativar ou excluir uma cadeia de ofertas ativa, ela não ficará mais disponível aos usuários.

Exibir cadeia de ofertas na loja

Exiba no site criado com a Xsolla

Observação
Os usuários não verão a cadeia de ofertas até ela ser ativada e o período de validade for iniciado.

Para exibir uma cadeia de ofertas 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 Offer chain.
  1. No menu lateral, acesse as configurações do bloco.
  2. Na lista suspensa, selecione a cadeia de ofertas.
  1. Personalize a aparência do bloco (opcional):
    1. Configure a aparência da cadeia.
    2. Configure a aparência das etapas.
  1. Para aplicar as alterações, publique o site:
    1. No canto superior direito do construtor de sites, selecione Publish.
    2. Marque as caixas próximas às páginas que você deseja publicar.
    3. Selecione Publish.
Observação

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

  1. Na interface do seu aplicativo, implemente os elementos para exibir etapas da cadeia de ofertas.
  2. Implemente a lógica para trabalhar com cadeias usando as seguintes chamadas de API do lado do cliente do grupo Cadeias de ofertas:
TarefaChamada 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.
  1. Garanta que os itens sejam corretamente concedidos ao usuário.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 13 de Fevereiro de 2026

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!
Não conseguimos enviar seu feedback
Tente novamente mais tarde ou contate-nos via doc_feedback@xsolla.com.