Introdução

A Plataforma de Engajamento de Jogadores (PEP) é uma ferramenta crucial para os operadores de jogos online gerenciarem sua base de jogadores, melhorarem a retenção de clientes e aumentarem a receita, fornecendo experiências personalizadas, relevantes e atraentes para seus jogadores.

O PEP da Gamanza se integra a outros sistemas, como a plataforma de jogos, o sistema de gerenciamento de contas de jogadores e as ferramentas de marketing, permitindo que os operadores simplifiquem suas operações e melhorem a experiência geral do cliente. A plataforma também fornece análises e relatórios detalhados que permitem que os operadores acompanhem a eficácia de suas campanhas de marketing e tomem decisões baseadas em dados para otimizar o desempenho de seus negócios.

O PEP rastreia a atividade do jogador em tempo real*, fornecendo aos operadores insights sobre o comportamento e as preferências dos jogadores. Essas informações podem ser usadas para desenvolver programas de recompensas personalizados, esquemas VIP, segmentação e outros incentivos que mantenham os jogadores engajados e motivados a continuar jogando no site de jogos.

Começando

O PEP fornece dois Gateways de API projetados para casos de uso específicos e níveis de segurança:

1. Gateway de API da Plataforma: Projetado para fornecer integração entre a plataforma do operador e o PEP.
2. Gateway de API do Front-end: Projetado para fornecer integração com o aplicativo front-end do cassino ou do operador, é usado para recuperar informações do jogador para integrações de gamificação e sistema de fidelidade. Requer acesso específico de API do jogador.

Integração de Plataforma

O PEP é um sistema baseado em fluxo de dados reativo, o que significa que o sistema é projetado para operar e tomar decisões com base em dados atualizados a cada minuto, transmitidos e processados de forma reativa, à medida que são gerados. O Gateway de API da Plataforma fornece integração entre a plataforma do operador e o PEP, expondo APIs para permitir a ingestão de dados e feeds de dados em tempo real/reativos. Para garantir o acionamento reativo de atividades e manter o modelo de segmentação atualizado, é necessário publicar eventos de registro, transacionais e de login na plataforma de integração dentro do sistema do operador. Fornecer uma API para ingestão de dados envolve a criação de um conjunto de endpoints que podem receber e processar dados recebidos, principalmente usados para a primeira carga/sincronização de dados.

O que são APIs de ingestão de dados? São APIs projetadas para operações de dados em massa, como a primeira carga de dados ou sincronização periódica de dados entre a plataforma do operador e o PEP, e operações de sincronização. Alguns usos comuns são:

• Sincronização em massa de dados de jogadores
• Envio de mensagens para jogadores (email, sms, notificações push)
• Solicitando informações do CRM

O que são APIs reativas? São APIs usadas para fornecer eventos em tempo real que devem ser processados imediatamente e vão desencadear processos internos, como:

• Gamificação: iniciar o mecanismo de decisão para validar missões atribuídas ao jogador, mover classificações e pontos.
• Segmentação: manter o modelo de segmentação atualizado e fornecer agregações transacionais
• CRM: enviar campanhas de acionamento relacionadas a eventos transacionais.

Autenticação: O método de autenticação necessário para integrações de plataforma é o OAuth 2.0 usando o tipo de concessão client_credentials. A concessão de Credenciais do Cliente é usada quando os aplicativos solicitam um token de acesso para acessar seus próprios recursos, não em nome de um usuário.

Integração do Front-end do Operador

Alguns dos recursos fornecidos pelo PEP exigem integração com o usuário final (jogador), para fornecer todas as interações de gamificação para componentes personalizados ou os widgets de interface do usuário fornecidos pelo PEP. Esses Gateways de API fornecem integração com a API REST para recuperar informações relacionadas ao progresso de missões do jogador, pacotes, torneios, classificações, etc. e o SocketIO para fornecer atualizações em tempo real de acordo com o progresso do Jogador, bem como fornecer integração com recursos de comunicação do CRM, como notificações no site, notificações push e muito mais integrações futuras.

Para fornecer autenticação aos clientes da interface do usuário do cassino (também conhecidos como jogadores), precisamos de um token de identidade JWT para proteger adequadamente a solicitação do jogador ao Gateway da API do Front-end.

Para validar a sessão do jogador e criar o token de identidade JWT para que o jogador acesse os endpoints da API do Front-end do PEP, os operadores precisam fornecer um SessionID válido do jogador ou um token de identidade que seja validado pelo PEP com a API do operador.

Não importa qual o mecanismo que você use para autenticar o jogador em sua interface do usuário do cassino, precisamos gerar um token de acesso de identidade válido para permitir que seu jogador se conecte aos endpoints da API do Jogador do PEP.

Processo de autenticação do jogador:

1. Você precisa ligar para o POST: {gamanza_engage_fe_api_url}/api/auth/v1/player endpoint com os seguintes parâmetros:

• identityToken: string : Token de identidade exclusivo do jogador, como sessionID ou accessToken
• clientId: string: ClientID gerado no Admin relacionado ao seu cliente da API.

2. O PEP Frontend API Gateway recebe a chamada e imediatamente chama um endpoint no Operadores API para validar o Token de Identidade. Esta API deve ser implementada da seguinte forma:

• Método: POST

• Endpoint: {operators_api_url}/api/auth/v1/player

• Parâmetros:

  • identityToken: string

• Retornos:

  • status: 200
  • Carga útil (JSON):
    • playerId: <string|required> o id do jogador relacionado ao token de identidade.
    • expiresAt: <RFC 3339 format DateTime|opcional> data e hora até que o token de identidade do jogador seja válido.

• Erros:

  • 404: Não encontrado
  • 400: Parâmetro inválido
  • 401: Token inválido ou expirado
  • 500: Erro interno do servidor

3. Assim que o PEP recebe o PlayerID, um novo token de identidade JWT é criado para permitir que o jogador acesse o PEP API, adicionando o JWT no cabeçalho x-authorization.

Fluxo de processo:

dica

Se você estiver usando os Widgets da Interface do Usuário do Gamanza Engage, o processo de autenticação é tratado internamente, portanto, você não precisa se preocupar com o processo de autenticação; mas é obrigatório fornecer o Token de Identidade para o jogador.

dica

Para mais detalhes, verifique a Especificação da API Aberta aqui.

Player Validate Identity Token API Spec