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 itens são ignoradas nas cadeias de ofertas:
    • regras de personalização
    • limites de compra
    • disponibilidade programada (data de início/fim)
    • promoções e descontos
  • Número máximo de etapas em uma cadeia de ofertas — 30.
  • Uma etapa pode conter apenas um item.
  • O preço da etapa paga da cadeia de ofertas é igual ao preço do item nessa etapa.

Fluxo do usuário

  1. O usuário vai à loja.
  2. O usuário vê uma cadeia de ofertas disponível e os itens oferecidos 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 reivindica o item.
    • Se a etapa for paga, o usuário faz um pagamento. O item é concedido ao usuário da mesma forma que ao comprá-lo.
  6. O usuário prossegue para a próxima etapa da 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 específica.
  • Se o usuário já resgatou ou comprou itens dentro de uma cadeia, o progresso atual dele é 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.
  • Se a cadeia for renovável, o progresso do usuário é redefinido conforme o 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 primeiro. Tenha em mente:

  • Se você deseja que um item esteja disponível apenas através da cadeia, defina seu status como Parcialmente Disponível.
  • 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 Items catalog > All items. Encontre informações detalhadas sobre esse e outros métodos para criar itens nas seções Catálogo de itens e Gerenciamento de Catálogo da documentação.

Configurar na Conta de Distribuidor

Observação
Você também pode configurar a cadeia de ofertas usando um canvas.

Para criar uma cadeia de ofertas:

  1. No seu projeto na Conta de Distribuidor, vá para a seção LiveOps > Offer chains.
  2. Clique em Create offer chain.
  3. Especifique:
    • Título da cadeia.
    • Descrição da cadeia (opcional).
  4. Clique em Next.
  5. Configure o número necessário de etapas da cadeia:
    1. Clique em Add step.
    2. Na Select SKU lista suspensa, 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. Clique em Save.
  1. Clique em Next.

  2. Se quiser personalizar a cadeia de ofertas:

    1. Ative a opção Personalized offer chain.
    2. Selecione uma das opções de exibição da cadeia:
      • Show offer chain to specific users. Defina as condições de personalização. Neste caso, a cadeia é exibida apenas para Usuários Autorizados que atendem às 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 para Usuários Não Autorizados, bem como em casos em que nenhuma cadeia de ofertas correspondente é encontrada para o Usuário Autorizado.
    3. Clique em Next.
  1. Especifique o fuso horário, data e hora em que a cadeia pode se tornar disponível para os usuários.
  2. Para limitar a cadeia por tempo, ative a opção Set time limit e especifique a data e hora. Sem essa configuração, a cadeia é considerada indefinida.
  3. Para configurar a renovação da cadeia, ative a opção Make offer chain renewable, selecione o período necessário e especifique os parâmetros requeridos.
  4. Clique em Create.

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

  1. No seu projeto na Conta de Distribuidor, vá para a seção LiveOps > Offer chains.
  2. Na linha com uma cadeia de ofertas, clique em ••• e escolha Activate na lista suspensa.

Configurar 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.
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:
  • “is_always_visible”: true — a cadeia é exibida a todos os usuários.
  • “is_always_visible”: false e as condições de visibilidade são especificadas — a cadeia é considerada personalizada e é exibida somente a usuários autorizados que cumprem as condições especificadas.
  • “is_always_visible”: false e nenhuma condição de visibilidade é especificada — a cadeia é exibida a usuários não autorizados, bem como em casos onde nenhuma cadeia correspondente é encontrada para o usuário autorizado.
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

Exibir no site criado com 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. Vá para o construtor do site onde você deseja adicionar a cadeia de ofertas de uma das seguintes maneiras:

    • No formulário de edição da cadeia de ofertas no canvas — clique em Open ou Open in Site Builder no banner.
    • De qualquer página da Conta de Distribuidor:
      1. Vá para a seção Storefronts > Websites.
      2. Selecione seu site e clique em Open Site Builder.
  1. Se seu site incluir múltiplas páginas, selecione a que você precisa:
    1. Clique no título da página atual no topo do construtor.
    2. Selecione a página necessária na lista suspensa.
  2. Na área principal do construtor, escolha um lugar onde você deseja adicionar um novo bloco e clique em Add block.
  3. Selecione o bloco Offer chain.
  1. No menu lateral, vá para as configurações do bloco.
  2. Na lista suspensa, selecione uma cadeia de ofertas ativa.
  1. Personalize a aparência do bloco (opcional):
    1. Configure a aparência da cadeia.
    2. Configure a aparência dos passos.
  1. Para conferir a cadeia, clique em Preview no canto superior direito do construtor.
Observação
O modo prévia foi feito para teste, então o site pode ser diferente da versão publicada. Por exemplo, você poderá ver cadeias inativas e reivindicar itens gratuitos na cadeia de ofertas.
  1. Para aplicar as alterações, publique o site:

    1. No canto superior direito do construtor de sites, clique em Publish.
    2. Marque as caixas ao lado das páginas que você deseja publicar.
    3. Clique em 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 está publicada ou selecionada para publicação. Você não pode publicar páginas filhas antes da 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: 11 de Agosto 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 [email protected].