Verificação de Elegibilidade do Jogador (ComeOn)

Prev Next

Esta página é especificamente para o grupo ComeOn. Os atributos do perfil descritos nesta página são específicos para a implementação da integração da verificação de elegibilidade dos jogadores no ComeOn.

A integração para verificação de elegibilidade permite enviar campanhas apenas para jogadores elegíveis. Antes do envio de uma campanha, a integração verifica o status de exclusão de cada jogador perante um órgão regulador nacional, garantindo que jogadores que se autoexcluíram não recebam comunicações de marketing. Se um jogador for excluído, a campanha não é enviada a ele.

Essas verificações de exclusão de jogadores funcionam tanto para campanhas de uma só quanto de múltiplas etapas.

Como funciona a verificação de elegibilidade

Para usar esta integração de verificação de elegibilidade do jogador:

  1. Configure a integração da verificação de elegibilidade do jogador no Xtremepush.

  2. Envie os dados dos jogadores para o Xtremepush usando a API de Importação de Perfil, incluindo os seguintes atributos de perfil para cada jogador:

    • franquia: O país com o qual o jogador está associado.

    • exclusion_type: O registro nacional de exclusão no qual o jogador está registrado (SPELPAUS, OASIS ou ROFUS).

    • is_excluded: Se o jogador está atualmente excluído (verdadeiro ou falso).

    • last_exclusion_check_time: O carimbo de data da verificação de elegibilidade mais recente (formato ISO-8601).

  3. Crie uma Categoria de Engajamento usando a integração da sua verificação de elegibilidade para jogadores.

    A categoria de engajamento controla quais jogadores são elegíveis para receber mensagens de uma campanha e garante que a verificação de elegibilidade seja realizada antes de cada envio. Para mais informações, veja Categorias de Engajamento.

  4. Adicione a categoria de engajamento à sua campanha.

Quando uma campanha é enviada, o Xtremepush verifica o status de exclusão de cada jogador. Se o status foi verificado pela última vez dentro de 24 horas, o valor armazenado é utilizado. Se não, o Xtremepush chama o endpoint gRPC para obter um status atualizado. A tabela a seguir mostra o que acontece com base nesses valores de atributo:

exclusion_type

last_exclusion_check_time

is_excluded

Desfecho

Vazio

Vazio

falso

Campanha enviada

Vazio

Vazio

Verdade

Campanha não é enviada

Cenário

Menos de 24 horas atrás

falso

Campanha enviada

Cenário

Menos de 24 horas atrás

Verdade

Campanha não é enviada

Cenário

Mais de 24 horas atrás

Vazio

Xtremepush atualiza o status de exclusão do jogador via endpoint gRPC, depois envia ou suprime a campanha com base no valor de is_excluded atualizado

Configure a Integração de Elegibilidade do Jogador

Para configurar a integração da verificação de elegibilidade do jogador, você precisa do endereço do host e do número da porta do endpoint externo do gRPC.

  1. Vá para Configurações > Integrações do Marketplace > Verificação de Elegibilidade do Jogador.

  2. Clique em Conectar Agora.

  3. No campo Nome , insira um nome para sua integração.

  4. No campo Host , insira o endereço do host do endpoint gRPC.

  5. No campo Porta , insira o número da porta de endpoint gRPC.

  6. Clique em Salvar.

Uma vez configurada a integração, envie ou atualize os atributos do perfil do jogador usando a API de Importação de Perfil.

Use a Verificação de Elegibilidade do Jogador em uma campanha

Para aplicar a verificação de elegibilidade a uma campanha, você deve criar uma Categoria de Engajamento com a integração configurada do Player Eligibility Check (Verificação de Elegibilidade do Jogador).

Campanhas em Múltiplas Etapas

Para campanhas multinível, você também pode ativar a opção de Verificação Nacional de Exclusão em nós individuais de Engajamento no construtor de workflow. Isso não exige criar uma categoria de engajamento.

Crie a Categoria de Engajamento

  1. Vá para Públicos > Categorias de Engajamento.

  2. Abra uma categoria existente ou clique em Criar categoria.

  3. Ative a opção de Usar Exclusão Nacional .

  4. No menu suspenso da Verificação Nacional de Exclusão , selecione a integração da verificação de elegibilidade do jogador.

  5. Complete as configurações restantes da categoria e clique em Salvar.

Use a categoria em uma campanha

  1. Crie uma campanha de uma ou várias etapas.

  2. No construtor de campanhas, selecione sua categoria de engajamento na categoria de engajamento na aba Configuração .

  3. Complete a configuração restante da campanha e clique em Lançar.

Quando a campanha é enviada, o Xtremepush executa a verificação de elegibilidade para cada jogador na categoria selecionada. A campanha não é enviada para jogadores cujo status de exclusão é confirmado como excluído.

A verificação não é realizada em todos os envios. O Xtremepush atualiza o status de exclusão de cada jogador a cada 24 horas.

Para verificar a entrega da campanha, acesse Campanhas > Registro de Notificações e abra sua campanha. Em Mensagens Individuais, a coluna de Status mostra Falhou para os jogadores para quem a campanha não foi enviada, com o erro Excluído por Verificação Nacional de Exclusão (ComeOn).

Antes de você enviar

  • A verificação de elegibilidade não afeta a contagem de destinatários mostrada no construtor de campanhas. Os jogadores são filtrados apenas no momento de envio, então a contagem de pré-visualização incluirá jogadores para quem a campanha pode não ser enviada. Esses aparecem como erros no Registro de Notificações da campanha após o envio da campanha.

  • Se um jogador não tiver um user_id conjunto em seu perfil, nenhuma verificação de elegibilidade é realizada e a mensagem não é enviada. Isso é registrado como um erro ausente user_id no Registro de Notificações.