Système de contrôle d'affiliation (modules AFF)
Introduction
Le système de gestion d'affiliation (module AFF) permet aux partenaires d'attirer les joueurs et de recevoir une commission de leur activité. Le module AFF intégré à la plate-forme permet la génération de liens de référence, le suivi des enregistrements et des dépôts, le calcul automatique des récompenses, la structure multi-tier des commissions et la comptabilité détaillée.
1. Génération et suivi des liens de référence
Jetons uniques : Pour chaque partenaire, vous créez un 'affiliateId' et un ensemble de liens de référence de vue
```
https: //casino. example. com/?aff=abc123
```
Cookie- et session-tracking : lorsque vous suivez le lien, le cookie enregistre 'aff = abc123' sur la TTL configurable (30-90 jours).
Attribution server-side : si le joueur s'enregistre en dehors de la période de cookie, fallback par IP et les étiquettes publicitaires UTM.
2. Module de calcul des commissions
1. Types de récompenses :
Le système de gestion d'affiliation (module AFF) permet aux partenaires d'attirer les joueurs et de recevoir une commission de leur activité. Le module AFF intégré à la plate-forme permet la génération de liens de référence, le suivi des enregistrements et des dépôts, le calcul automatique des récompenses, la structure multi-tier des commissions et la comptabilité détaillée.
1. Génération et suivi des liens de référence
Jetons uniques : Pour chaque partenaire, vous créez un 'affiliateId' et un ensemble de liens de référence de vue
```
https: //casino. example. com/?aff=abc123
```
Cookie- et session-tracking : lorsque vous suivez le lien, le cookie enregistre 'aff = abc123' sur la TTL configurable (30-90 jours).
Attribution server-side : si le joueur s'enregistre en dehors de la période de cookie, fallback par IP et les étiquettes publicitaires UTM.
2. Module de calcul des commissions
1. Types de récompenses :
- Partager le revenu : pourcentage de GGR (habituellement 20-40 %).
- CPA : frais d'inscription fixes + premier dépôt.
- HybrID : combinaison de CPA et RS. 2. Programmes multi-tier :
- Tier 1 : renvois directs.
- Tier 2 + : renvois avec commission réduite (5-10 %).
- 3. Période de calcul : journalière/hebdomadaire/mensuelle selon l'accord. 4. Automatisation :
- `POST /affiliate/compute? period = 2025-07 'déclenche le calcul job.
- Transactions ACID : facturation dans Ledger Service, création d'une requête payout.
- `GET /affiliate/{id}/stats? from = & to = '→ d'enregistrement, dépôts, GGR, commission.
- 'POST/affiliate/{ id }/payout '→ créer un paiement pour les détails spécifiés. Webhooks:
- Événements : 'player. registered`, `player. deposited`, `affiliate. commission. awarded`.
- Payload contient 'affiliateId', 'playerId', les montants et les paris.
- Affiche en temps réel : nouveaux joueurs, montants des dépôts, GGR, honoraires, état des paiements.
- Filtres par période, pays, sources de trafic (UTM).
- Exportation : CSV/PDF selon les horaires et sur demande.
- Accès API pour BI : intégration avec des systèmes externes via secure REST.
- Verrouillage self-referral (same IP/device).
- Velocity checks : plus de N enregistrements par minute à partir d'un seul token. Blacklist/Whitelist:
- Panneau admin pour la commande manuelle. Audit-log :
- Enregistrez tous les événements de suivi et de calcul dans le stockage WORM.
- Traitement des événements d'inscription et de dépôt en temps réel. Cache Layer (Redis):
- Lookup rapide 'affiliateId' par 'playerId' et UTM. High Availability:
- Kubernetes avec HPA pour AFF-Service et Leadership Service, les clusters Sentinel Redis.
3. API et intégration Webhook
REST API:
4. Rapports et interfaces
Dashboard partenaire :
5. Anti-fraud et protection du système
Detection:
6. Évolutivité et tolérance aux pannes
Architecture microservices : AFF-Service séparé du core, évolutif en fonction de la charge de traçage.
Message Broker (Kafka):
7. Sécurité et conformité
Authentification : OAuth2 pour les partenaires, clés API avec restriction IP.
Cryptage : TLS pour tous les canaux, stockage de secrets Vault.
GDPR/CCPA : droit de suppression des données du partenaire et des joueurs, possibilité anonymize.
Conclusion
Le système de gestion d'affiliation intégré fournit aux partenaires un outil complet pour attirer et monétiser le trafic, depuis les liens uniques et le suivi jusqu'au calcul automatique des commissions multi-tier, des dashbords en temps réel et une protection fiable contre la fraude. L'architecture microservice évolutive et l'intégration API garantissent la croissance du réseau partenaire sans perte de performances et de sécurité.
