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:
  • 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.

3. Integración de API y Webhook

REST API:
  • `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.

4. Informes e interfaces

Dashboard de socios:
  • 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.

5. Anti-fraud y protección del sistema

Detection:
  • 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.

6. Escalabilidad y tolerancia a fallas

Arquitectura de microservicios: AFF-Service separado del núcleo, escalado por carga de seguimiento.

Message Broker (Kafka):
  • 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.

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.

Caswino Promo