Sistema de control de afiliación (módulos AFF)
Introducción
El Sistema de Gestión de Afiliados (AFF) permite a los socios atraer jugadores y recibir una comisión de su actividad. El módulo AFF integrado en la plataforma proporciona la generación de referencias de referencia, seguimiento de registros y depósitos, liquidación automática de recompensas, estructura de comisiones multi-tier e informes detallados.
1. Generación y seguimiento de referencias de referencia
Tokens únicos: para cada socio se crea un 'affiliateId' y un conjunto de referencias de referencia de la vista
```
https: //casino. example. com/?aff=abc123
```
Cookie- y session-tracking: al hacer clic en el enlace, la cookie guarda 'aff = albac123' en un TTL configurable (30-90 días).
Attribution Server-side: si el jugador se registra fuera del término de la cookie, fallback por IP y etiquetas promocionales UTM.
2. Módulo de cálculo de comisiones
1. Tipos de recompensas:
El Sistema de Gestión de Afiliados (AFF) permite a los socios atraer jugadores y recibir una comisión de su actividad. El módulo AFF integrado en la plataforma proporciona la generación de referencias de referencia, seguimiento de registros y depósitos, liquidación automática de recompensas, estructura de comisiones multi-tier e informes detallados.
1. Generación y seguimiento de referencias de referencia
Tokens únicos: para cada socio se crea un 'affiliateId' y un conjunto de referencias de referencia de la vista
```
https: //casino. example. com/?aff=abc123
```
Cookie- y session-tracking: al hacer clic en el enlace, la cookie guarda 'aff = albac123' en un TTL configurable (30-90 días).
Attribution Server-side: si el jugador se registra fuera del término de la cookie, fallback por IP y etiquetas promocionales UTM.
2. Módulo de cálculo de comisiones
1. Tipos de recompensas:
- Revenue share: porcentaje de GGR (generalmente 20-40%).
- CPA: tarifa de registro fija + primer depósito.
- HybrID: una combinación de CPA y RS. 2. Programa Multi-tier:
- Tier 1: referencias directas.
- Tier 2 +: referencias de referencias con comisión reducida (5-10%).
- 3. Período de liquidación: diario/semanal/mensual dependiendo del acuerdo. 4. Automatización:
- `POST /affiliate/compute? period = 2025-07 'lanza el job del cálculo.
- Transacciones ACID: acumulando en Ledger Service, creando una consulta de pago.
- `GET /affiliate/{id}/stats? de = & to = '→ de registro, depósitos, GGR, comisión.
- 'POST/affiliate/{ id }/payout' → crear un pago por los datos especificados. Webhooks:
- Eventos: 'player. registered`, `player. deposited`, `affiliate. commission. awarded`.
- Payload contiene 'affiliateId', 'playerId', cantidades y apuestas.
- En tiempo real muestra: nuevos jugadores, cantidades de depósitos, GGR, comisiones acumuladas, estado de pagos.
- Filtros por períodos, países, fuentes de tráfico (UTM).
- Exportación: CSV/PDF programado y bajo petición.
- Acceso API para BI: Integración con sistemas externos a través de secure NAT.
- Bloqueo de self-referral (same IP/device).
- Velocity checks: más de N inscripciones por minuto desde un solo token. Blacklist/Whitelist:
- Panel de administración para control manual. Registro de auditoría:
- Registro immutable de todos los eventos de seguimiento y cálculos en el almacenamiento WORM.
- Procesamiento de eventos de registro y depósitos en tiempo real. Cache Layer (Redis):
- Rápido lookup 'affiliateId' por 'playerId' y UTM. High Availability:
- Kubernetes con HPA para AFF-Service y Leaderboard Service, clústeres Sentinel Redis.
3. Integración de API y Webhook
REST API:
4. Informes e interfaces
Dashboard de socios:
5. Anti-fraud y protección del sistema
Detection:
6. Escalabilidad y tolerancia a fallas
Arquitectura de microservicios: AFF-Service separado del núcleo, escalado por carga de seguimiento.
Message Broker (Kafka):
7. Seguridad y cumplimiento
Autenticación: OAuth2 para socios, claves API con restricción IP.
Cifrado: TLS para todos los canales, almacenamiento de secretos Vault.
GDPR/CCPA: derecho a eliminar los datos de los socios y jugadores, posibilidad de anonymize.
Conclusión
El sistema de gestión de afiliados integrado proporciona a los socios una herramienta completa para atraer y monetizar el tráfico, desde enlaces únicos y rastrear hasta el cálculo automático de comisiones multi-tier, dashboards en tiempo real y protección antifraude segura. La arquitectura de microservicios escalable y la integración de API garantizan el crecimiento de la red de socios sin perder performance ni seguridad.
