Moteur de bonus casino : éligibilité, récompenses et suivi
Un moteur de bonus casino ne se limite pas à un champ de code promotionnel ou à un calendrier de campagnes. Il relie le statut du joueur, les règles de l'offre, les événements entrants, les soldes promotionnels, les exclusions, l'attribution et les rapports. Une interface marketing peut sembler correcte alors qu'un avantage est mal accordé : le joueur est exclu, un événement arrive deux fois, une réponse est perdue après écriture ou une annulation intervient plus tard. L'opérateur doit pouvoir expliquer chaque décision pour un couple joueur-campagne, avec les conditions dans leur version applicable et une trace comptable durable. Ce guide détaille les frontières techniques, les contrôles et les essais nécessaires. Il ne remplace pas une analyse juridique propre au marché concerné.
Publié le
Décision d'éligibilité, attribution et suivi doivent rester cohérents même après une livraison répétée.
Sommaire
Quel est le rôle d'un moteur de bonus casino ?
Le moteur transforme une offre validée en décisions exécutables : quel événement la déclenche, quel joueur peut en bénéficier, quel avantage est permis et comment suivre sa vie. Il peut être interne à la plateforme ou intégré par API. Administration des campagnes, contrôle des joueurs, écritures de portefeuille et communication ne doivent pas être confondus.
Une architecture utile comporte un registre de campagnes, un évaluateur de règles, un contrôle d'éligibilité, un registre de récompenses et des événements d'audit. L'API d'Open Loyalty illustre des déclencheurs, des périodes d'activité et des effets sur des portefeuilles. Cet exemple de produit ne garantit pas la conformité d'un casino particulier. [1]
Quelles règles d'éligibilité et exclusions vérifier ?
L'éligibilité est évaluée à un instant donné. Elle peut dépendre du compte vérifié, du territoire, de la marque, des dates, du consentement, du produit, des avantages déjà reçus et des restrictions de protection du joueur. La liste d'audience marketing ne suffit pas. Le moteur doit consulter l'état faisant autorité et conserver la version de règle appliquée à chaque acceptation ou refus.
Famille de règles
Contrôle
Preuve conservée
Périmètre
Marque, pays, produit, dates
Campagne et version
Compte
Vérification et activité
Référence d'état
Exclusions
Auto-exclusion, blocage et risque
Origine et résultat
Plafonds
Quota et bonus précédents
Clé de demande
Conflits
Bonus actif et cumul permis
Règle de priorité
Consentement
Participation et autorisations utiles
Base et horodatage
Si une restriction change entre la prévisualisation et la demande, l'attribution finale doit être réévaluée. Un refus ne doit pas devenir un crédit lors d'un nouveau signal publicitaire. Chaque matrice de règles doit préciser sa juridiction et sa date d'effet. [6] [7]
Comment les événements activent-ils les règles de campagne ?
Les déclencheurs possibles comprennent une inscription validée, une transaction admissible, un jalon autorisé ou une intervention manuelle approuvée. La source doit fournir un identifiant d'événement stable, le joueur concerné, l'opération et la date. Le moteur choisit une version de la campagne puis évalue les conditions avant de déclencher un effet. Tous ces déclencheurs ne sont pas adaptés ou autorisés partout.
Distinguer le fait observé de l'effet promotionnel éventuellement accordé.
Interpréter les périodes dans un fuseau connu et figer la version de règles.
Filtrer source, type et joueur ; rejeter les événements non conformes.
Enregistrer la raison d'accord, de refus, d'expiration ou de doublon.
Amazon EventBridge documente le filtrage selon les attributs d'un événement ; Open Loyalty distingue campagnes et progression d'objectifs plus longs. Ces modèles sont utiles, mais les règles de règlement, de remboursement et les responsabilités du fournisseur doivent être vérifiées dans le contrat réel. [2] [4]
Comment attribuer une récompense dans le portefeuille ?
Une décision positive doit créer une instruction identifiée : joueur, campagne, récompense, motif, montant ou droit non monétaire, devise si nécessaire et échéance. Un portefeuille ou un registre d'avantages confirme l'écriture sous sa propre référence. Un événement envoyé au CRM ou une réponse HTTP réussie ne prouvent pas que le solde a été modifié.
Valider l'événement entrant et charger la version immuable de la campagne.
Recontrôler restrictions, incompatibilités et budget avant réservation.
Créer une récompense à clé unique et inscrire son effet autorisé une seule fois.
Publier le résultat confirmé pour l'interface, l'analyse et les états ultérieurs.
⊕Agrandir le schémaLa récompense relie la version des règles, l'événement source et l'effet enregistré.
Un avantage peut être un crédit soumis à conditions, des tours gratuits, des points ou un autre droit admis. Le contrat du fournisseur et celui du portefeuille doivent préciser sa consommation, son expiration et son annulation. Un champ unique bonus_balance ne suffit généralement pas. [1]
Quels états exposer pour le bonus et la progression ?
Un bonus suit plusieurs états : proposé, demandé, réservé, crédité, actif, partiellement utilisé, achevé, expiré ou annulé. Lorsque des exigences de mise sont autorisées, la progression doit provenir uniquement d'événements admissibles et réglés, avec la possibilité de la recalculer à partir du registre source.
État
Sens comptable
Affichage joueur
Proposé
Aucune écriture
Conditions disponibles
Demandé
Contrôle et réservation
Confirmation attendue
Crédité
Droit enregistré
Avantage visible
Achevé
Conditions traitées et finalisées
Résultat explicite
Expiré / annulé
Clôture liée à l'origine
Date et motif
Mises annulées, résultats tardifs, contribution des jeux et précision des devises sont traités selon les seules conditions approuvées. Il n'existe pas de multiplicateur universel : la Gambling Commission britannique encadre notamment les exigences de mise et certains regroupements de produits. [6]
Comment éviter les doubles crédits et gérer les annulations ?
Un événement peut être livré deux fois ; une requête peut aussi expirer après que la récompense a été créditée. Le moteur doit imposer une clé d'attribution unique, liée à l'opération source, au joueur et à la version de campagne. La contrainte doit être persistante : un simple cache en mémoire ne résiste pas aux redémarrages.
Une attribution conserve son identifiant ; un nouvel essai renvoie le résultat stocké.
Le même identifiant avec une autre valeur ou devise devient un conflit à examiner.
Toute annulation référence l'attribution et la transaction d'origine.
Avant une correction manuelle, réconcilier registre des bonus et portefeuille.
La documentation DynamoDB décrit des écritures conditionnelles rejetant une clé déjà utilisée. Le principe peut aussi s'appuyer sur une contrainte unique SQL ou un registre transactionnel. Un accusé de réception perdu ne doit jamais doubler l'avantage. [3]
Comment combiner conditions de bonus et protection du joueur ?
La conformité doit faire partie de l'autorisation avant le crédit, pas seulement des mentions légales. Le joueur doit pouvoir consulter les conditions importantes. Les auto-exclusions, blocages, plafonds et restrictions locales doivent s'appliquer quel que soit le canal de campagne. Une promotion ne peut pas contourner les protections indépendantes du compte.
Versionner produits admis, dates, actes qualifiants, exclusions et retrait des fonds.
Gérer les politiques par pays et date d'effet après validation juridique.
Appliquer les mêmes refus sur web, application, CRM et outils de support.
Tracer l'approbation des changements et leur effet sur les demandes existantes.
En Grande-Bretagne, le code de la Gambling Commission sur les récompenses traite de transparence et de certaines pratiques interdites ; RTS 12 encadre les limites financières. Ce sont des références nationales, non des règles mondiales identiques. [6] [7]
Quels événements et indicateurs suivre dans les rapports ?
La mesure doit distinguer exposition, éligibilité, demande, attribution confirmée, utilisation, achèvement, expiration, annulation et litige. Le nombre de clics ne correspond pas au nombre de crédits. Les compteurs marketing ne peuvent pas remplacer le registre financier. Il faut des identifiants cohérents et des définitions stables pour chaque étape.
Indicateur
Source principale
Erreur fréquente
Décisions positives
Évaluateur de règles
Assimiler audience et éligibilité
Demandes
Action du joueur enregistrée
Compter un clic comme crédit
Récompenses attribuées
Registre des écritures
Compter deux fois un renvoi
Bonus achevés
Transition validée
Confondre activité et règlement
Expirations / annulations
Écritures de clôture
Masquer les annulations
Braze décrit les événements personnalisés utilisés pour la segmentation et l'analyse de campagnes. C'est une destination aval des résultats confirmés, pas une source comptable autorisée. Le transfert des données doit respecter la portée de l'identité et de la confidentialité. [5]
Comment auditer et réconcilier les campagnes de bonus ?
Chaque récompense contestée doit pouvoir être expliquée depuis l'événement initial, la version de règle et la décision jusqu'à l'écriture, puis au statut final. Conservez aussi les restrictions applicables au moment de l'attribution. Une réconciliation compare des sources faisant autorité ; un événement émis n'est pas nécessairement une écriture validée.
Conserver le journal des modifications avec approbateur, période, marché et version.
Comparer récompenses et écritures de portefeuille, ainsi que les droits non utilisés.
Alerter sur les attributions manquantes ou anormales et les annulations en échec.
Limiter les corrections manuelles avec acteur, justification et référence initiale.
Un tableau de bord positif ne garantit pas l'intégrité des comptes individuels. Support, risques, conformité et ingénierie doivent partager les mêmes éléments vérifiables.
Quels tests réaliser avant la mise en production ?
La recette couvre configuration, ingestion des événements, décisions, comptabilité, affichage joueur et reprise après incident. Chaque type de bonus doit être testé dans les marchés et produits visés. La validation juridique et celle du jeu responsable précèdent l'ouverture des campagnes réelles.
Tester joueurs autorisés et exclus, puis modifier un blocage entre aperçu et crédit.
Livrer deux fois le déclencheur, perdre la confirmation et constater une seule écriture.
Annuler une transaction, laisser expirer un droit inutilisé et rapprocher les soldes.
Comparer rapports, CRM, registre et interface à l'aide des mêmes références.
Le critère décisif n'est pas le catalogue de tours gratuits ou de cashback. La plateforme doit prouver qui était autorisé, quelles règles s'appliquaient, ce qui a été attribué une seule fois, utilisé ou annulé, et comment les écarts sont détectés. [1] [3] [6]