Informações do jogador

As informações do cliente são essenciais para os sistemas de CRM (Gestão de Relacionamento com o Cliente) quando se trata de enviar campanhas de marketing por várias razões:

1. Personalização: Ao compreender as preferências do cliente, o histórico de compras/jogos e os padrões de comportamento, o PEP pode ajudar a personalizar as campanhas de marketing. Campanhas personalizadas têm mais chances de ressoar com os clientes, levando a taxas de engajamento e conversão mais altas.

2. Direcionamento: Permite que as empresas segmentem sua base de clientes com base em vários critérios, como demografia, interesses ou histórico de compras. Essa segmentação permite campanhas de marketing direcionadas e adaptadas a grupos específicos de clientes, aumentando a relevância das mensagens entregues.

3. Cronometragem: Pode acompanhar as interações do cliente em vários canais e pontos de contato, ajudando as empresas a identificar os momentos mais oportunos para se engajar com os clientes. Enviar campanhas de marketing no momento certo pode impactar significativamente sua eficácia e melhorar a satisfação geral do cliente.

4. Retenção: Ao analisar os dados do cliente por meio de segmentação e análises, você pode identificar clientes em risco ou aqueles que podem estar prontos para produtos ou serviços adicionais. Campanhas de marketing direcionadas à retenção de clientes ou ao incentivo de compras repetidas podem ajudar a aumentar a lealdade e o valor de vida útil do cliente.

5. Feedback Loop: Facilita a coleta de feedback e dados de campanhas de marketing. Analisando as métricas de desempenho da campanha e as respostas dos clientes, as empresas podem obter valiosas informações sobre o que reverbera com seu público e aprimorar continuamente suas estratégias de marketing para melhores resultados.

As informações do cliente são vitais para o PEP enviar campanhas de marketing eficazes, pois permitem a personalização, o direcionamento, o engajamento oportuno, os esforços de retenção e a melhoria contínua por meio da análise de feedback. Durante este capítulo, vamos orientá-lo a entender adequadamente como enviar dados para o PEP e as melhores práticas.

Informações do jogador

O PEP permite que você crie novos clientes/jogadores adequadamente em nosso armazenamento de dados; o PEP requer pelo menos as seguintes informações para funcionar:

• ID do jogador: Identificador exclusivo do jogador
• Nome: Nome do jogador
• Sobrenome: Sobrenome do jogador
• Gênero: Gênero do jogador, útil para saudações personalizáveis em campanhas de marketing
• Número de telefone: Número de telefone celular para campanhas através do canal SMS
• E-mail: E-mail do jogador usado para enviar campanhas através do canal de e-mail
• Nome de usuário: Nome de usuário do jogador. Se o jogador não tiver um nome de usuário, você pode usar o e-mail do jogador
• Idioma: Idioma do jogador para abordar adequadamente as campanhas com base no idioma do jogador
• Moeda: Moeda baseada no jogador
• Data de nascimento: Data de nascimento do jogador, útil para campanhas de aniversário
• Nacionalidade: Nacionalidade do jogador para campanhas de direcionamento demográfico
• País de endereço: País do jogador para campanhas de direcionamento demográfico
• Cidade de endereço: País do jogador para campanhas de direcionamento demográfico
• Endereço da rua
• Código postal

dica

Our platform allows you to register, update or delete player's information in real time through our players Rest API.

Você pode encontrar a especificação da API Aberta para Informações do Jogador aqui:

• Criar um jogador
• Atualizar um jogador

nota

Você não precisa registrar as informações do jogador para que o PEP funcione, mas você terá opções limitadas no CRM; por exemplo, para segmentação ou em placeholders personalizáveis de modelos.

Excluir Jogador

Esta seção descreve os processos para excluir dados de jogadores do sistema. A funcionalidade de exclusão é dividida em duas operações: Exclusão Suave e Exclusão Definitiva.

Exclusão Suave

A operação de Exclusão Suave move o jogador para uma coleção separada, excluindo-o efetivamente de:

• Consultas
• Relatórios
• Quaisquer fluxos de trabalho operacionais

Isso garante que os dados do jogador permaneçam no sistema, mas não sejam processados ​​ativamente ou visíveis em nenhum aplicativo front-end.

Exclusão Definitiva

A operação de Exclusão Definitiva remove permanentemente os dados do jogador do sistema. No entanto, a exclusão ocorre 48 horas após o início da solicitação, permitindo tempo para cancelamento, se necessário.

Principais Pontos:

• Opção de Cancelamento:
  • Você pode cancelar a solicitação de exclusão definitiva usando o endpoint de cancelamento de exclusão dentro da janela de 48 horas.
  • Cancelar a exclusão definitiva retém o status de exclusão suave do jogador.
• Irreversível Após 48 Horas:
  • Depois que a janela de 48 horas tiver passado, os dados do jogador serão permanentemente removidos do banco de dados e não poderão ser recuperados.

Notas

• Certifique-se de ter a devida autorização para todas as solicitações de exclusão.
• As operações de exclusão definitiva são irreversíveis após a passagem da janela de 48 horas.
• A exclusão suave garante que os dados sejam preservados para fins de conformidade e auditoria.

dica

Here the Open API Specs for player delete operations:

• Excluir um jogador
• Cancelamento de exclusão definitiva
• Restaurar um jogador

Informações Adicionais de Jogadores

Por outro lado, se você tiver informações adicionais que não estão listadas nas informações básicas do jogador, nós temos você coberto. O PEP possui uma seção de dados personalizados para cada jogador, portanto, você pode enviar quaisquer informações adicionais que possam ser necessárias para:

• Melhores campanhas de marketing direcionadas
• Personalização Aprimorada
• Regulamentações de mercado

Nosso módulo de Dados Personalizados de Jogador permite que você envie cinco tipos de dados:

• string: representa uma sequência de caracteres. Uma string é usada para armazenar e manipular dados de texto
• number: representa um valor numérico, incluindo inteiros e números de ponto flutuante
• boolean: representa um valor binário indicando verdadeiro ou falso
• date: representa um tipo de dados de data expresso no formato RFC 3339
• option: representa um tipo de dados que pode ser enumerável, como status, tags, etc

As informações personalizadas do jogador podem ser adicionadas diretamente na API de Integração de Jogadores ou usando essa API específica para adicionar/atualizar dados personalizados do jogador.

Vamos ver isso em ação através de um exemplo:

Suponha que você tenha um jogador registrado com o ID: 00000000-0000-0000-0000-000000000001

E você precisa adicionar as seguintes propriedades a este jogador:

• É VIP: tipo de dados booleano
• Valor máximo de aposta: tipo de dados número
• Status da conta: tipo de dados opção (enumeração)

Vamos ver um exemplo de solicitação de API para adicionar essas propriedades ao jogador e como essas propriedades são exibidas no PEP:

Mostre-me o código!

import axios from 'axios';

const axiosInstance = axios.create(...);

/**
 * Enviar uma solicitação para atualizar o jogador, adicionando propriedades extras
 * para o playerID: 00000000-0000-0000-0000-000000000001
 * Especificação da API: @url: https://docs.gamanzaengage.com/docs-api/platform-rest-api/player/players-controller-upsert-player-custom-data
 */
this.axiosInstance.patch(
  'https://customer-domain.gamanzaengage.com/api/players-data/v1/players/00000000-0000-0000-0000-000000000001/custom-data',
  {
    customData: [
      {
        name: 'is_vip',
        type: 'boolean',
        value: 'true',
      },
      {
        name: 'maxBetAmount',
        type: 'number',
        value: '200',
      },
      {
        name: 'accountStatus',
        type: 'option',
        option: {
          selected: ['1'],
          type: 'single',
          allowedOptions: [
            {
              key: 'provisional',
              value: '1',
            },
          ],
        },
      },
    ],
  },
);

info

O valor de cada propriedade deve ser definido na representação de string.

atenção

Take into consideration that type validations are performed to ensure data consistency. For example, if you define the maxBetAmount as a number but you send a string value not numerical or a non valid numeric string value, the request will end with an HTTP status code 400:

{
    "message": "Exceção de solicitação inválida",
    "request": {...}
    "details": {
        "faultCode": 400,
        "fields": [
            {
                "field": "1.value",
                "error": "o valor deve ser uma string numérica"
            }
        ]
    }
}

Vamos ver o resultado no Cartão do Jogador na interface administrativa:

Como você pode ver na imagem anterior, as três novas propriedades foram adicionadas ao jogador (últimas três propriedades na seção de dados do jogador no cartão do jogador). O PEP é capaz de entender os dados e dar o contexto adequado se você definir os tipos de dados corretos, isso acontece em tempo real, e muitas coisas agora estão habilitadas na plataforma (mais em breve).

Dados Personalizados - Tipos de Dados

Agora vamos nos aprofundar em cada tipo de propriedade de dados e ver os recursos habilitados no CRM.

Tipo boolean

Do exemplo anterior:

{
    name: 'is_vip',
    type: 'boolean',
    value: 'true'
}

O nome da propriedade pode estar em qualquer formato válido de variável de linguagem de programação: CamelCase, PascalCase, snake_case, kebab-case, UPPER_CASE. Internamente, a plataforma PEP cria um nome de exibição legível por humanos, como você pode ver na seguinte imagem:

A próxima parte é o tipo. O tipo define como a plataforma lida internamente com as informações e define o tipo adequado no armazenamento de dados. Ele também habilita as interações para segmentação e modelo de e-mail para os espaços reservados.

Por exemplo, é isso que você pode ver no Construtor de Segmentação para a propriedade É VIP:

De relance, o CRM apresenta informações legíveis por humanos fáceis de usar para permitir que os operadores entendam e interajam facilmente com os dados; o valor é realmente armazenado como um booleano "primitivo".

Tipo number

O tipo número representa qualquer valor numérico:

{
    nome: 'maxBetAmount',
    tipo: 'número',
    valor: '200'
}

Internamente, o PEP armazena o valor como um número "primitivo", int/float, permitindo opções de filtro específicas para segmentação numérica:

Tipo date

O tipo data permite que você represente valores de propriedade de data:

{
    nome: 'lastSelfAssessment',
    tipo: 'data',
    valor: '2024-03-27T23:18:59.911+00:00'
}

Internamente, o PEP armazena o valor como um valor de data "primitivo", permitindo opções de filtro específicas para datas na segmentação:

Tipo string

O tipo string permite que você represente valores de propriedade de texto:

{
    nome: 'riskEvaluationResult',
    tipo: 'cadeia de caracteres',
    valor: 'Baixo risco, hábitos saudáveis.'
}

Este tipo de propriedade é útil para o envio de campanhas específicas e pode ser usado em modelos:

Tipo opção

O tipo de opção é um campo especial para definir propriedades enumeráveis. Este tipo de dado permite que você envie informações que podem estar relacionadas a um identificador exclusivo de banco de dados interno, e você precisa dar algum contexto aos seus operadores administrativos para entender os dados. Vamos ver um exemplo.

Imagine que você tem uma propriedade para seus jogadores chamada Status da Conta, essa propriedade é definida em uma tabela do banco de dados em seu sistema da seguinte forma:

ID	nome
1	provisório
2	ativo
3	bloqueado

Você pode enviar os valores como propriedades de string ou número, mas você obriga seus operadores a definir manualmente esses valores em segmentação. Se você enviar os status da conta como opções, você reduzirá a complexidade de uso para seus operadores:

{
    name: 'statusDaConta',
    type: 'option',
    option: {
      selected: ['1'],
      type: 'single',
      allowedOptions: [
        {
          key: 'provisório',
          value: '1',
        },
      ],
    }
}

Para dar o contexto adequado ao analisador de dados PEP, você precisa definir os allowedOptions no objeto de carga útil da opção, você não precisa enviar todos os elementos disponíveis em seu banco de dados em cada solicitação, o PEP rastreia automaticamente as alterações e atualizações internamente de acordo com os dados que você envia.

Isso resulta na seguinte experiência, por exemplo, para criar um novo segmento para jogadores com status de conta específicos:

dica

🤗 Quanto mais contexto você definir para os dados, melhor será a experiência para os operadores de cassino da Administração.

info

All the data that you send to PEP is read-only for PEP, which means we never allow operators to edit or modify this information from our Admin UI. You, the integrator, are the sole source of truth for PEP.

❗ Confiamos em você para manter os dados sincronizados.

Os tipos de dados são essenciais para o manuseio de informações na programação e são amplamente utilizados em uma ampla gama de aplicações. Mas, mais importante, se você definir os tipos de dados adequadamente, você habilita uma excelente e fácil experiência de usuário para os Operadores Administrativos que podem não ter um entendimento profundo dos tipos de dados de programação, e permite que eles criem qualquer coisa de cálculos simples de data a algoritmos de agendamento complexos e tarefas de análise de dados. Entender como trabalhar com tipos de dados e realizar operações relacionadas a dados é crucial para o desenvolvimento de mecânicas de engajamento.

Feliz integração!