Carregamento de Dados dos Jogadores
O CRM depende de um mínimo de informações do jogador para seu correto funcionamento.
O Módulo de Dados dos Jogadores do PEP é responsável por armazenar todas essas informações para serem consumidas pelos diferentes serviços da plataforma. Além disso, todo evento que atualiza os dados do jogador; dispara eventos para o serviço que depende desses dados. Por essa razão, é necessário migrar pela primeira vez todas as informações mínimas dos jogadores; isso será necessário apenas uma vez, pois posteriormente será atualizado através de endpoints quando o usuário executar alguma ação, como cadastro, atualização de dados e assim por diante.
É necessário que o Casino nos envie as informações dos jogadores através do endpoint habilitado no API Gateway da Plataforma.
Migração de Jogadores, Primeiro Carregamento e Sincronização Offline
O PEP oferece uma API projetada para o primeiro carregamento de dados de jogadores, essa API é projetada para trabalhar nos seguintes casos de uso:
- Primeiro Carregamento de Dados da Plataforma: O processo inicial de importação de grandes volumes de dados em uma plataforma quando ela é configurada pela primeira vez ou ao transicionar de um sistema antigo. Isso garante que todos os dados necessários estejam disponíveis para uso pelos recursos da plataforma.
- Migração de Dados: O processo de transferência de dados de um sistema ou banco de dados para outro, frequentemente como parte de atualizações de sistema, consolidações ou mudanças de plataforma. Inclui extração, transformação e carregamento de dados (ETL) para garantir consistência e integridade.
- Sincronização Offline: Um mecanismo que permite que os dados sejam coletados ou modificados enquanto não estiver conectado à internet, o que é posteriormente sincronizado com o servidor central assim que o dispositivo ficar online, garantindo a consistência dos dados entre as plataformas.
The API Specification to send the players Chunk is defined here: Players Migration
Esta API retorna o ID da Tarefa relacionado ao processo de carregamento de dados em segundo plano.
Tamanho do Lote
O tamanho de lote recomendado é de 20.000 jogadores. Esse valor pode variar. O corpo da solicitação não deve exceder 15 MB de tamanho.
Quando esse conjunto de jogadores for recebido, eles serão validados e um objeto de resposta será enviado com os jogadores que foram validados corretamente e aqueles que não foram, os erros serão enviados com seus respectivos nomes de propriedade. Os jogadores que foram validados corretamente começarão a ser processados em segundo plano e serão salvos no banco de dados.
Compressão
Para reduzir o tamanho dos dados e acelerar a transferência de dados, os dados devem ser compactados usando Gzip ou Brotli. O cabeçalho Content-Encoding é especificado na solicitação:
- Accept-Encoding: gzip
- Accept-Encoding: br
Feedback da Migração de Jogadores (Fluxo Contínuo)
Assim que nossa plataforma terminar de processar qualquer lote único, você pode buscar o status ou os detalhes de erro para validar se o processo foi concluído corretamente.
Essa API retorna os detalhes de erro após a execução da tarefa de migração. Essa chamada retorna uma lista de jogadores com detalhes específicos dos erros detectados durante o processo de migração, por exemplo, validações DTO, formato e erros gerais que não estão em conformidade com os esquemas de dados de jogadores da plataforma Gamanza Player Engagement. O conteúdo do corpo da resposta é compactado em gzip.
The API Specification check the status of a Migration Task is described here: Players Migration Feedback
Essa API retorna um JSON em fluxo contínuo com os detalhes da migração.