Bônus
O evento de bónus permitir-lhe-á ver os custos reais de bónus associados às suas campanhas. Também permitirá ativar atividades em mudanças de estado de bónus, por exemplo, se for perdido muito rapidam
REST API
RabbitMQ Connector
Kafka Connector
⬆️ POST /v1/integration/bonus
Propriedades da Mensagem RabbitMQ
| key | value |
|---|---|
type | BONUS |
O tipo é esperado como uma propriedade (mas não no payload) da Mensagem RabbitMQ. Qualquer cabeçalho será ignorado.
Cabeçalhos da Mensagem Kafka
| key | value |
|---|---|
type | BONUS |
Regras de Negócio:
- Cada bónus criado precisa de ter a sua conclusão [Completed, AutoCompleted, Forfeited, Expired ou Lost].
- Um user_bonus_id dentro de um status deve ser único.
- É importante que apenas um evento seja enviado quando o estado do bónus é alterado. Múltiplos eventos do mesmo estado resultarão em dados de segmentação incorretos.
Pedido
Ao enviar bónus de 'rodadas grátis', esperamos que o primeiro evento de bónus seja enviado uma vez que as rodadas de rodadas grátis tenham sido concluídas e com a "quantia" correlativa que foi ganha.
Se desejar enviar dados quando as rodadas grátis foram emitidas, pode enviar isto como um 'Evento Personalizado'.
Propriedades obrigatórias são marcadas com *
Chave | Tipo | Descrição |
amount * | float | A quantia atribuída ao bónus. |
bonus_code | string | Indicação quanto à natureza da promoção ex. "WELCOME100" |
bonus_id * | string | Identificador único para cada campanha de bónus. |
bonus_turned_real | float | Quantia de bónus convertida em dinheiro real, se a apostagem estiver terminada |
currency * | string
Formato: ISO4217 | Moeda do jogador |
exchange_rate * | float | A taxa de câmbio no momento do timestamp |
locked_amount | float | Quantia de bónus bloqueada para apostagem |
meta | object | Se dados meta forem requeridos para serem enviados |
origin * | string | Este valor pode ser usado para identificar a marca ou jurisdição em que o jogador está jogando |
product * | string
Valores Aceites:
"Casino"
"Sportsbook"
"Lotto"
"Poker"
"Live Casino" | Define o produto associado ao bónus |
required_wagering_amount | float | Quantia de apostagem requerida do bónus |
status * | string
Valores Aceites:
"Created"
"Completed"
"AutoCompleted"
"Forfeited"
"Expired"
"Lost" | O estado atribuído ao bónus no momento do evento em tempo real ser enviado. |
timestamp * | string
Formato: RFC3339 | Timestamp do evento sendo enviado. Tempo preciso ao milissegundo é requerido aqui para garantir precisão. |
type * | string
Valores Aceites: "NoDeposit"
"WelcomeBonus"
"CashbackBonus"
"ReloadBonus" "WagerFree"
"FreeSpins" "RiskFreeBet" "Undefined" | Tem de ser um dos valores especificados na lista. Se não, por favor envie "Undefined". Podemos ajudar no mapeamento dos seus tipos de bónus atuais para a lista definida aqui. |
user_bonus_id | string | Identificador único do bónus creditado a um jogador. Pode ser definido como um valor aleatório, sugestão é ser id do utilizador + id do bónus. |
user_id * | string | ID do utilizador do jogador a quem o bónus foi creditado. |
is_free_money | boolean | Indica se a transação é feita ou não usando uma carteira de jogo gratuito, tal como Gold Coins ou qualquer outra moeda virtual.
Se a propriedade não estiver incluída no payload, será por defeito false |
fasttrack_references | object | Dados fornecidos pelo Fast Track em quaisquer pedidos de crédito de bónus. Estes dados são usados para atualizar a quantia de bónus concedida e quantia de bónus convertida em real nos relatórios de conversão de atividade. |
Boas Práticas - Tipo de Bónus
Ao mapear o seu tipo de bónus para um dos valores aceites pelo Greco, pode ser uma tarefa desafiante. Tenha em mente que o Greco opera através de vários operadores, e trabalhamos com os tipos mais comuns na indústria.
Tente evitar enviar um tipo de bónus "Undefined".
Descrições de estado
Estado | Descrição |
Created | Quando o bónus foi reclamado e os fundos são adicionados à conta do jogador. |
Completed | Se o requisito de apostagem for cumprido e os fundos de bónus forem convertidos em fundos reais. |
AutoCompleted | Se o seu sistema remove automaticamente o bónus com uma definição geral.
ex. Bónus são auto-completados se o saldo atingir abaixo de €0.10 |
Forfeited | Se o bónus foi perdido. |
Expired | Se o período de validade do bónus expirou. |
Lost | Se o jogador ficou sem saldo de bónus. |
Sequência de Eventos
O bonus_id e o user_bonus_id juntos fazem uma chave única. Cada bónus Created precisa de ter a sua conclusão: Completed, AutoCompleted, Forfeited, Expired ou Lost. Então se um {bonus_id:1, user_bonus_id:1, status:Created} for enviado, em algum momento um {bonus_id:1, user_bonus_id:1, status:Completed} precisa de ser enviado.
Cenário A - Bónus Criado e Concluído
Evento de Bónus - Criado
Primeiro, devemos receber um Evento de Bónus com o seu bonus_id e user_bonus_id tendo o seu estado como Created
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Created, ...}
Evento de Bónus - Concluído
Uma vez que o bónus seja concluído, devemos então receber um Evento de Bónus com o seu bonus_id e user_bonus_id tendo o seu estado como Completed
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Completed, ...}
Cenário A - Bónus Criado e Expirado
Evento de Bónus - Criado
Primeiro, devemos receber um Evento de Bónus com o seu bonus_id e user_bonus_id tendo o seu estado como Created
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Created, ...}
Evento de Bónus - Expirado
Uma vez que o bónus seja concluído, devemos então receber um Evento de Bónus com o seu bonus_id e user_bonus_id tendo o seu estado como Expired
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Expired, ...}
O mesmo deve ser seguido para AutoCompleted, Forfeited ou Lost status
Se o user_bonus_id for enviado com o mesmo estado, mesmo com um bonus_id e quantias diferentes, será considerado um evento duplicado, e o último será descartado, uma vez que o user_bonus_id é a identificação de crédito de bónus do utilizador.