Bono
El evento de bonus te dará la capacidad de ver los costos reales de bonus asociados a tus campañas. También te permitirá activar actividades en cambios de estado de bonus, por ejemplo, si se pierde de
REST API
RabbitMQ Connector
Kafka Connector
⬆️ POST /v1/integration/bonus
Propiedades de Mensaje RabbitMQ
| clave | valor |
|---|---|
type | BONUS |
El tipo se espera como una propiedad (pero no en la carga útil) del Mensaje RabbitMQ. Cualquier encabezado será ignorado.
Encabezados de Mensaje Kafka
| clave | valor |
|---|---|
type | BONUS |
Reglas de Negocio:
- Todo bonus creado necesita tener su conclusión [Completed, AutoCompleted, Forfeited, Expired o Lost].
- Un user_bonus_id dentro de un status debe ser único.
- Es importante que solo se envíe un evento cuando el estado del bonus cambie. Múltiples eventos del mismo estado resultarán en datos de segmentación incorrectos.
Solicitud
Al enviar bonus de 'giros gratis', esperamos que el primer evento de bonus se envíe una vez que las rondas de giros gratis hayan sido completadas y con el "amount" correlacionado que fue ganado.
Si deseas enviar datos cuando se hayan emitido los giros gratis, puedes enviar esto como un 'Evento Personalizado'.
Las propiedades requeridas están marcadas con *
Clave | Tipo | Descripción |
amount * | float | El monto asignado al bonus. |
bonus_code | string | Indicación sobre la naturaleza de la promoción ej. "WELCOME100" |
bonus_id * | string | Identificador único para cada campaña de bonus. |
bonus_turned_real | float | Monto de bonus convertido a dinero real, si la apuesta es completada |
currency * | string
Formato: ISO4217 | Moneda del jugador |
exchange_rate * | float | La tasa de cambio en el timestamp |
locked_amount | float | Monto de bonus bloqueado para apuestas |
meta | object | Si se requiere enviar meta datos |
origin * | string | Este valor puede ser usado para identificar la marca o jurisdicción en la que el jugador está jugando |
product * | string
Valores Aceptados:
"Casino"
"Sportsbook"
"Lotto"
"Poker"
"Live Casino" | Define el producto asociado al bonus |
required_wagering_amount | float | Monto de apuesta requerido del bonus |
status * | string
Valores Aceptados:
"Created"
"Completed"
"AutoCompleted"
"Forfeited"
"Expired"
"Lost" | El estado asignado al bonus en el momento del evento en tiempo real siendo enviado. |
timestamp * | string
Formato: RFC3339 | Timestamp del evento siendo enviado. Tiempo preciso a milisegundos es requerido aquí para asegurar precisión. |
type * | string
Valores Aceptados: "NoDeposit"
"WelcomeBonus"
"CashbackBonus"
"ReloadBonus" "WagerFree"
"FreeSpins" "RiskFreeBet" "Undefined" | Debe ser uno de los valores especificados en la lista. Si no, por favor envía "Undefined". Podemos asistir en mapear tus tipos de bonus actuales a la lista definida aquí. |
user_bonus_id | string | Identificador único del bonus acreditado a un jugador. Puede ser establecido como un valor aleatorio, la sugerencia es que sea user id + bonus id. |
user_id * | string | ID de usuario del jugador al cual el bonus ha sido acreditado. |
is_free_money | boolean | Indica si la transacción se realiza usando una billetera gratuita, como Gold Coins o cualquier otra moneda virtual.
Si la propiedad no está incluida en la carga útil, por defecto será false |
fasttrack_references | object | Datos proporcionados por Fast Track en cualquier solicitud de acreditación de bonus.
Lee más sobre la implementación aquí. |
Buenas Prácticas - Tipo de Bonus
Al mapear tu tipo de bonus a uno de los valores aceptados por Greco, puede ser una tarea desafiante. Ten en cuenta que Greco opera a través de varios operadores, y trabajamos con los tipos más comunes en la industria.
Trata de evitar enviar un tipo de bonus "Undefined".
Descripciones de estados
Estado | Descripción |
Created | Cuando el bonus ha sido reclamado y los fondos son añadidos a la cuenta del jugador. |
Completed | Si el requisito de apuesta es cumplido y los fondos del bonus son convertidos en fondos reales. |
AutoCompleted | Si tu sistema automáticamente remueve el bonus con una configuración general.
ej. Los bonus son autocompletados si el balance llega bajo €0.10 |
Forfeited | Si el bonus ha sido perdido. |
Expired | Si el período de validez del bonus ha expirado. |
Lost | Si el jugador se ha quedado sin balance de bonus. |
Secuencia de Eventos
El bonus_id y el user_bonus_id juntos forman una clave única. Todo bonus Created necesita tener su conclusión: Completed, AutoCompleted, Forfeited, Expired o Lost. Entonces si un {bonus_id:1, user_bonus_id:1, status:Created} es enviado, en algún punto un {bonus_id:1, user_bonus_id:1, status:Completed} necesita ser enviado.
Escenario A - Bonus Creado y Completado
Evento de Bonus - Creado
Primero, deberíamos recibir un Evento de Bonus con su bonus_id y user_bonus_id teniendo su estado como Created
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Created, ...}
Evento de Bonus - Completado
Una vez que el bonus es completado, deberíamos entonces recibir un Evento de Bonus con su bonus_id y user_bonus_id teniendo su estado como Completed
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Completed, ...}
Escenario A - Bonus Creado y Expirado
Evento de Bonus - Creado
Primero, deberíamos recibir un Evento de Bonus con su bonus_id y user_bonus_id teniendo su estado como Created
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Created, ...}
Evento de Bonus - Expirado
Una vez que el bonus es completado, deberíamos entonces recibir un Evento de Bonus con su bonus_id y user_bonus_id teniendo su estado como Expired
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Expired, ...}
Lo mismo debe ser seguido para estado AutoCompleted, Forfeited o Lost
Si el user_bonus_id es enviado con el mismo status, incluso con un bonus_id y montos diferentes, será considerado un evento duplicado, y el último será descartado, una vez que el user_bonus_id es la identificación de acreditación de bonus del usuario.