Система аффилиатного управления (AFF-модули) в платформах онлайн-казино

Введение

Система аффилиатного управления (AFF-модуль) позволяет партнёрам привлекать игроков и получать комиссию от их активности. Встроенный в платформу AFF-модуль обеспечивает генерацию реферальных ссылок, трекинг регистраций и депозитов, автоматический расчёт вознаграждений, multi-tier структуру комиссий и детализированную отчётность.

1. Генерация и трекинг реферальных ссылок

Уникальные токены: для каждого партнёра создаётся `affiliateId` и набор реферальных ссылок вида

```
https: //casino.example.com/?aff=abc123
```
Cookie- и session-tracking: при переходе по ссылке в cookie сохраняется `aff=abc123` на configurable TTL (30–90 дней).
Server-side attribution: если игрок регистрируется вне cookie-срока, fallback по IP и рекламным тегам UTM.

2. Модуль расчёта комиссий

1. Виды вознаграждений:

Revenue share: процент от GGR (обычно 20–40 %).
CPA: фиксированная плата за регистрацию + первый депозит.
HybrID:сочетание CPA и RS.

2. Multi-tier программы:

Tier 1: прямые рефералы.
Tier 2+: рефералы рефералов с пониженной комиссией (5–10 %).
3. Период расчёта: ежедневно/еженедельно/ежемесячно в зависимости от соглашения.

4. Автоматизация:

`POST /affiliate/compute?period=2025-07` запускает job расчёта.
ACID-транзакции: начисление в Ledger Service, создание payout-запроса.

3. API и Webhook-интеграции

REST API:

`GET /affiliate/{id}/stats?from=&to=` → регистрации, депозиты, GGR, commission.
`POST /affiliate/{id}/payout` → создание выплаты на указанные реквизиты.

Webhooks:

События: `player.registered`, `player.deposited`, `affiliate.commission.awarded`.
Payload содержит `affiliateId`, `playerId`, суммы и ставки.

4. Отчётность и интерфейсы

Партнерский дашборд:

В реальном времени отображает: новых игроков, суммы депозитов, GGR, начисленные комиссии, статус выплат.
Фильтры по периодам, странам, трафиковым источникам (UTM).
Экспорт: CSV/PDF по расписанию и по запросу.
API-доступ для BI: интеграция с внешними системами через secure REST.

5. Anti-fraud и защита системы

Detection:

Блокировка self-referral (same IP/device).
Velocity checks: более N регистраций в минуту с одного токена.

Blacklist/Whitelist:

Админ-панель для ручного управления.

Audit-лог:

Immutable запись всех событий трекинга и расчётов в WORM-хранилище.

6. Масштабируемость и отказоустойчивость

Message Broker (Kafka):

Обработка событий регистрации и депозитов в реальном времени.

Cache Layer (Redis):

Быстрый lookup `affiliateId` по `playerId` и UTM.

High Availability:

Kubernetes с HPA для AFF-Service и Leaderboard Service, Sentinel-кластеры Redis.

7. Безопасность и комплаенс

Заключение