Система аффилиатного управления (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. Масштабируемость и отказоустойчивость

Микросервисная архитектура: AFF-Service отдельно от core, масштабируется по нагрузке трекинга.

Message Broker (Kafka):
  • Обработка событий регистрации и депозитов в реальном времени.
Cache Layer (Redis):
  • Быстрый lookup `affiliateId` по `playerId` и UTM.
High Availability:
  • Kubernetes с HPA для AFF-Service и Leaderboard Service, Sentinel-кластеры Redis.

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

Аутентификация: OAuth2 для партнёров, API-ключи с ограничением IP.

Шифрование: TLS для всех каналов, Vault-хранение секретов.

GDPR/CCPA: право на удаление данных партнёра и игроков, возможность anonymize.

Заключение

Встроенная система аффилиатного управления обеспечивает партнёрам полноценный инструмент привлечения и монетизации трафика: от уникальных ссылок и трекинга до автоматического расчёта multi-tier комиссий, real-time дашбордов и надёжной защиты от мошенничества. Масштабируемая микросервисная архитектура и API-интеграции гарантируют рост партнёрской сети без потери производительности и безопасности.

Caswino Promo