Pular para o conteúdo principal

Gamificação e Fidelidade

O objetivo desses módulos do sistema é permitir que o Operador de Cassino inclua sua base de usuários em um programa de fidelidade. Este sistema fornece um backend totalmente funcional, permitindo que o Operador tenha a flexibilidade de decidir como os usuários ganham pontos de experiência e moeda virtual, bem como como os usuários gastam essa moeda.

Começando

Os módulos de Gamificação e Fidelidade da PEP são projetados para funcionar com uma integração mínima, o que significa que você não precisa fornecer uma integração extensa para implementar a Plataforma de Gamificação e Fidelidade da Gamanza. Vamos do básico a uma integração mais detalhada.

Transações de Cassino e Esportes

Os dados mínimos necessários para que a Gamificação e Fidelidade funcionem são as Transações de Jogos de Cassino ou Transações de Esportes. Uma vez que você começar a transmitir esses eventos para nossa API, nossa plataforma poderá começar a processar esses eventos e, com base em suas regras de contribuição de fidelidade, seus jogadores poderão começar a ganhar pontos de XP, Tokes, concluir missões ou competir em um torneio.

Transações de Jogos de Cassino

Uma transação de jogo de cassino é definida como uma rodada, composta por uma aposta e um ganho no mesmo pedido. Nossa API suporta o recebimento de uma matriz para uma rodada de jogador de jogo, mas se sua operação não suportar rodadas, você pode enviar uma solicitação separada para uma aposta e um ganho.

dica

Você pode encontrar a especificação da API Aberta para uma Rodada de Transação de Jogo de Cassino aqui: Evento de Transação de Jogo

Considerações Importantes

  • O realMoneyAmount e o bonusMoneyAmount são obrigatórios condicionais, o que significa que pelo menos um dos dois precisa ser maior que zero. Se um for maior que zero, a outra propriedade pode ser definida como zero

  • A taxa de câmbio é calculada com base na moeda padrão definida em sua instância do PEP. Se sua moeda padrão for o EUR e a transação for definida nessa moeda, você precisa definir aqui um valor constante como 1. Para mais detalhes sobre as taxas de câmbio, dê uma olhada no documento anexo Taxas de Câmbio

  • O transactionStatus usado para Lealdade e Gamificação é APPROVED, os outros status de transação são ignorados, portanto, você pode enviar apenas transações com status APPROVED.

  • Se você não tiver gameSessionId para agrupar todas as transações de uma sessão de jogo do jogador, você pode enviar o valor como o transactionId.

  • Nas transações de ganho, o betAmount é obrigatório porque, para algumas regras de gamificação (missões), você pode especificar objetivos com base em multiplicadores para o valor do ganho, com base no valor da aposta. Se você não tiver esse valor, pode enviar zero, mas esse tipo de regras de gamificação não funcionará.

  • Em relação às propriedades adicionais do jogo: gameCategoryId, gameCategoryName, gameProviderId, gameProviderName, gameId, gameName essas propriedades são muito importantes para a Gamificação e Fidelidade da PEP, pois com base nessas propriedades os Operadores de Cassino podem definir mecânicas ricas. Se você não tiver identificadores exclusivos, poderá enviar valores textuais que representem o identificador exclusivo, mas precisa garantir que esses valores nunca mudem. Por exemplo

Se você tiver identificadores exclusivos internos para o fornecedor de jogos Pragmatic e em seu banco de dados você tiver esse provedor sob o id: Q84OTBmVVj e o nome do provedor de jogos é Pragmatic, você precisa passar esses valores. Mas vamos imaginar que você não tenha essa informação, mas pelo menos saiba que o provedor para essa transação de jogo é Pragmatic, você pode enviar o mesmo valor no ID como o nome, mas sempre enviar o mesmo valor, o sistema é sensível a maiúsculas e minúsculas, e qualquer alteração no ID faz com que nossa plataforma detecte um provedor de jogos completamente diferente.

Se você quiser ver todos os metadados de jogos gerados pelo Gamanza PEP, verifique seu site Administrativo em Configurações -> Catálogo de Cassino

Catálogo de CassinoCatálogo de Cassino

Transações de Esportes

No contexto das apostas esportivas, os termos BET, SETTLEMENT e CASHOUT se referem a diferentes estágios de uma transação de apostas e seu ciclo de vida. Usamos esses ciclos de vida para permitir que você implemente mecânicas de Gamificação e Fidelidade.

dica

Você pode encontrar a especificação da API Aberta para uma Transação Esportiva aqui: Evento de Transação Esportiva

Definições

Uma "aposta" é uma aposta feita por um apostador sobre o resultado de um evento específico, como um jogo esportivo, uma partida ou uma corrida. Ela envolve prever o resultado de um evento e comprometer uma certa quantidade de dinheiro com base nas odds fornecidas pela casas de apostas.

  • LIQUIDAÇÃO:

"Liquidação" se refere ao processo de determinar o resultado de uma aposta e ajustar a conta do apostador de acordo com o resultado do evento.

"Retirada" é um recurso oferecido por muitos livros de esportes que permite aos apostadores liquidar sua aposta antecipadamente, seja para travar um lucro ou minimizar possíveis perdas, antes que o evento seja concluído.

Considerações Importantes

  • transactionId é o identificador exclusivo de um registro de transação esportiva, e é obrigatório.
  • transactionIdReference É o id da transação de referência para a aposta de origem, obrigatório se o tipo de transação for SETTLEMENT ou CASHOUT
  • A exchangeRate é calculada com base na moeda padrão definida em sua instância do PEP. Se sua moeda padrão é o EUR e a transação é definida nessa moeda, você precisa definir aqui um valor constante como 1. Para mais detalhes sobre taxas de câmbio, dê uma olhada no documento anexo Exchange Rates
  • Quando a plataforma está configurada para contribuir com Apostas Liquidadas, no tipo de transação SETTLEMENT, o realMoneyBalance precisa ser maior que o valor realMoneyBalanceBefore para instruir a plataforma de que o jogador ganhou e aplicar corretamente a regra de contribuição definida.

Conclusões

Para ter a plataforma de Gamificação & Fidelidade em funcionamento, você só precisa implementar duas integrações de API: Transações de Jogos de Cassino e Transações Esportivas. Assim que você começar a transmitir esses eventos para nossa API, a plataforma automaticamente começará a processá-los de acordo com suas regras de fidelidade, permitindo que os usuários ganhem pontos de experiência, moeda virtual e participem de missões ou torneios. A integração é projetada para ser mínima, porém flexível, permitindo que você engaje rapidamente sua base de usuários em um programa de fidelidade com configuração mínima.

Destaques🤗
  1. Duas Integrações de API Simples: Implemente Transações de Jogos de Cassino e Transações Esportivas para colocar a plataforma em funcionamento.
  2. Integração Mínima Necessária: Um processo simplificado com esforço mínimo necessário para começar a usar os recursos de Gamificação & Fidelidade.
  3. Engajamento do Usuário: Recompense facilmente os usuários com pontos de experiência, moeda virtual e mais, com base em suas regras de fidelidade.
  4. Flexibilidade: O sistema oferece flexibilidade para definir como os usuários ganham e gastam recompensas, aumentando as opções de personalização.
  5. Configuração Rápida: A plataforma é projetada para rápida implantação, permitindo que você engaje os usuários imediatamente.

Na próxima seção, você pode encontrar mais detalhes sobre como enviar mais eventos para enriquecer as Mecânicas de Gamificação