Pré-requisitos

  • 5 minuto(s) lido(s)
Prev Next

Visão geral dos requisitos de configuração de fidelidade e do fluxo de dados entre o CDP do Xtremepush e o Loyalty Hub.

Antes de usar o Hall de Fidelidade, certifique-se de que as seguintes configurações estejam configuradas na Plataforma de Dados de Clientes (CDP) do Xtremepush:

  • Atributos

  • Eventos

  • Perfis de Usuário

  • Integração com o motor bônus (Opcional)

Você deve usar a versão do SDK do Xtremepush a partir de março de 2026 para incorporar o widget de fidelidade em seu aplicativo ou site.

A imagem abaixo mostra como os dados fluem da Plataforma de Dados de Clientes Xtremepush para o Hall de Fidelidade.

Fluxo de dados entre o CDP Xtremepush e o Fidelidade Hub

Atributos

There are two types of attributes you can use in the Loyalty Hub:

  • Standard and custom attributes from the Xtremepush CDP. These are available under Data > Data Manager > Attributes and tags

  • Standard loyalty attributes that are preset in the Loyalty Hub. For a full list of these attributes, see Manage Loyalty Attributes.

To use any custom attributes in the Loyalty Hub, you must first configure them in the Xtremepush CDP. After loyalty is enabled on your project, these attributes are available to use in the Loyalty Hub.

Note

The standard preset loyalty attributes do not currently reflect in Xtremepush Data Manager. This means that any changes to these attribute values for each user are only recorded in the Loyalty Hub.

Nota

Os tipos de atributos suportados no Fidelidade Hub são número, string, boolean e array de strings. Isso significa que os atributos Data criados no Data Manager são mapeados para um tipo de atributo string no Loyalty Hub. E os atributos inteiros são mapeados para o tipo de atributo número.

Where attributes are used in Loyalty Hub

In the Loyalty Hub, attributes are used for the following:

  • Create user segments. The user segments you create in Xtremepush under Data > Audiences do not appear in the loyalty widget. To specify user eligibility for your loyalty features, you must configure user segments in the Loyalty Hub. See Configure Loyalty User Segments for more information.

  • Specifying user eligibility for your loyalty features. When configuring loyalty features like quests, you can also specify user eligibility by creating User Restriction logic using attributes. For example, if you configure a reward rule that provides users 100 tokens for a deposit. For this reward rule, you can specify that only users with a total_deposit attribute of greater than 1000 are eligible without creating a segment.

  • Triggers Achievements, which are loyalty features that award users when their attribute values change. For example, a High Roller Achievement that is awarded to users whose total_deposit is over 5000. For more information, see Achievements.

  • Configuring levels, which are tiers in your loyalty features. Users progress through these levels based on changes to their user attributes. For example, users with a total_deposit value of 500 are on a Bronze level and those with a total value of 1000 on a Silver level. For more information, see Levels.

  • Awarding Game Element rewards. Game elements are a reward type in your loyalty features that allow you to modify the user attribute values. For more information, see Game Elements under Dynamic Rewards.

Eventos

Existem quatro tipos de eventos que você pode usar no Hall de Lealdade.

  • Eventos personalizados configurados no CDP do Xtremepush. Esses estão disponíveis no Data > Data Manager > Eventos. Para usar qualquer evento personalizado no Loyalty Hub, você deve primeiro configurá-los no CDP do Xtremepush. Depois que a fidelidade for ativada no seu projeto, esses eventos podem ser usados no Hall de Fidelidade.

  • Eventos específicos de fidelidade: Esses são eventos que podem ser predefinidos ou configuráveis no Hall de Fidelidade:

    • Eventos Internos: Estes são os eventos internos pré-definidos gerados quando os usuários interagem com seu Widget de Lealdade. Veja Eventos Internos em Gerenciar Eventos de Fidelidade para mais detalhes.

    • Eventos Programados: São eventos cronometrados que você pode configurar no plugin Loyalty. Veja Eventos Programados na seção Gerenciar Eventos de Fidelidade para mais detalhes.

    • Eventos de Atributo do Usuário: Estes são os eventos pré-definidos do atributo do usuário que são acionados toda vez que o valor do atributo de um usuário muda. Veja Eventos de Atributos do Usuário em Gerenciar Eventos de Fidelidade para mais detalhes.

Eventos personalizados que você configura no CDP do Xtremepush estão disponíveis no Hall de Fidelidade. Da mesma forma, quaisquer Eventos Internos do Hall de Fidelidade são registrados para cada usuário em Perfil de Usuário> Eventos no CDP Xtremepush.

Onde os eventos são usados no Hall de Fidelidade

No Hall de Lealdade, esses eventos são usados para ativar a lealdade como missões, regras de recompensa e vantagens. Para mais informações, veja Configurar Regras de Recompensa ou Configurar Missões.

Perfis de Usuário

O ID de usuário registrado na aba Perfis de Usuário é usado para mapear usuários do CDP Xtremepush para o Loyalty Hub.

Usuários Existentes no Site/App

A sequência a seguir descreve como o Fidelidade Hub identifica usuários existentes:

  1. Um usuário interage com seu widget de fidelidade pela primeira vez.

  2. O Faithful Hub identifica o ID de Usuário específico deles.

  3. O usuário é então registrado automaticamente na aba Todos os Usuários no Hall de Fidelidade

Novos usuários no site/aplicativo

A sequência a seguir descreve como novos usuários são mapeados para o CDP do Xtremepush e para o Loyalty Hub:

  1. Um usuário faz login no seu aplicativo ou site

  2. O SDK Xtremepush grava o usuário e cria um novo perfil em Perfis de Usuário.

  3. O usuário interage com seu widget de fidelidade pela primeira vez.

  4. O Faithful Hub identifica o ID de Usuário específico deles.

  5. O usuário é então automaticamente registrado na aba Todos os Usuários dentro do Núcleo de Lealdade

Integração com o Motor Bônus (Opcional)

Você pode atribuir recompensas pela integração do seu motor de bônus. Recursos de fidelidade, como missões e regras de recompensa, permitem que você inclua recompensas embutidas como tokens ou recompensas externas, como promoções do seu motor de bônus.

Depois que a fidelidade estiver ativada no seu projeto, você pode selecionar recompensas da integração do seu motor de bônus usando a opção de recompensas Promoções ao configurar um recurso de fidelidade.

Requisitos do SDK

Você deve usar a versão do SDK Xtremepush a partir de março de 2026 para carregar o widget de fidelidade e gerenciar a autenticação do usuário. Para mais informações, veja Gerenciar Autenticação do Usuário e Carregar o Widget.

Artigos relacionados

© 2026 Xtremepush. Todos os direitos reservados.