Панель аффилиата и трекинг трафика

1) Цель и принципы

• Прозрачная атрибуция трафика (click → reg → KYC → FTD → депозитная активность).
• Быстрая оптимизация: креативы, лендинги, гео, устройства, времена суток.
• Контроль качества и комплаенса: антифрод, geo/funnel-соответствие, бренд-гайды.
• Финансовая ясность: модели выплат (CPA/CPL/RevShare/Hybrid), документы, график.

• Time-to-insight < 10 сек: пресеты фильтров, «закрепленные» представления.
• Сигналы > сырье: подсветка аномалий CTR/CR/FTD-Rate, burn-down бюджета.
• Объяснимость: «Почему просело?» — вклад гео/креатива/источника/устройства.
• Ролевой доступ: аффилиат, аккаунт-менеджер, финансы, комплаенс — разные права.

2) Роли и сценарии

Аффилиат: видеть эффективность по subid/гео/креативам, выгружать отчеты, управлять постбеками, запрашивать выплаты.
Аккаунт-менеджер: мониторить портфель аффилиатов, KPI по договорам, санкции/бонусы, коммуникации.
Финансы: начисления, корректировки (chargeback/clawback), инвойсы, статусы выплат.
Комплаенс/Brand: трекинг нарушений, разрешенные гео/каналы, список стоп-слов/креативов.
Техподдержка: интеграции постбеков, тест-клики, валидация пикселей/UTM.

3) Информационная архитектура (IA)

1. Глобальные фильтры (верхняя панель): период, программа/бренд, гео, устройство/ОС/браузер, источник/канал, субаккаунты (subid1..subid5), креативы, лендинги, offer id.
2. Главная («Сегодня»): KPI-сводка + алерты/аномалии.
3. Трафик: источники, UTM/Ref, SmartLink-маршрутизация, позиции креативов.
4. Воронка: clicks → registrations → KYC pass → FTD → повторные депозиты.
5. Финансы: модель выплат, ставки, начисления, коррекции, выплаты.
6. Инструменты: генератор ссылок, постбеки (S2S/Client), API-доступ, экспорты.
7. Комплаенс: разрешенные гео/каналы, бренд-гайд, тикеты нарушений.

4) KPI и формулы

4.1 Трафик и конверсия

Impressions (Imp) — показы.
Clicks (Clk) — клики.
CTR = Clk / Imp.
Visits/Landing CR = LP уникальные посетители / Clk.
Registration (Reg) — регистраций.
CR(Clk→Reg) = Reg / Clk.
KYC Pass Rate = KYC_approved / Reg.
FTD — First-Time Depositors.
FTD Rate = FTD / Reg.
Depositors — депонировавшие в период (вкл. повторные).
AFTD (Average FTD Deposit) = Sum(1й депозит) / FTD.

4.2 Монетизация

Stake Sum / Payout Sum (по игрокам аффилиата).
GGR = Stake − Payout.
Promo Cost (бонусы, FS в ден. экв.).
Platform/PSP Fees — сборы платформы и платежей.
NGR = GGR − Promo − Fees.
RevShare Комиссия = NGR × RevShare%.
CPA Комиссия = Ставка_CPA × кол-во валидных FTD (по правилам качества).
Hybrid = RevShare Комиссия + CPA Комиссия.
EPC (Earnings per Click) = Выплаты / Clk.
RPA (Revenue per Acquisition) = Выплаты / FTD.
LTV (к оговоренному окну) = NGR_per_user_cumulative / Users.

4.3 Качество трафика

Invalid Click Rate = (бот/дубликаты/пустые субиды)/Clk.
Early Churn % = игроки без активностей после D1/D7.
Chargeback/Clawback % = обратные корректировки / начисления.
Complaints Rate = тикеты/1000 регистраций.

5) Атрибуция и маршрутизация

UTM/Ref структура: `utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`, `subid1..subid5` (свободная таксономия).
Deeplink Builder: выбор языка/валюты/категории/игры; автодобавление параметров.
SmartLink: правила роутинга по гео/устройству/времени/истории перформанса; fallback-лендинг.
Модели атрибуции: Last Click (дефолт), First Click (для бренд-кампаний), Time-decay (оговоренный half-life).
Lookback windows: клики (X дней), view-through (Y часов, опционально и аккуратно).
Дедупликация: по user_id/фингерпринту/куки + S2S подтверждения.

6) Постбеки, пиксели и API

S2S Postback: `/conversion?click_id={click_id}&status=ftd&amount=...¤cy=...&ts=...&sig=...`

Подпись HMAC, allowlist IP, retry-логика, идемпотентность.
Client Pixel (fallback): только для просмотрных событий, без чувствительных данных.
Тест-утилита: «Отправить тестовый постбек» → лог статуса/ответа.
API аффилиата: отчеты по дням/субидам, списки креативов, статусы выплат.
Webhooks: начисление/коррекция/выплата; алерт о низком качестве или всплеске отказов.

7) Виджеты и отчеты (рекомендуемый набор)

Главная («Сегодня»)

Revenue Pulse: выплаты за период vs план/прошлая неделя.
Funnel Pulse: Clk→Reg→KYC→FTD (узкие места подсвечены).
Quality Monitor: Invalid Clicks, Early Churn, Clawback% — светофор.
Top Movers: субиды/креативы с наибольшим ростом/падением EPC/FTD Rate.

Трафик

Source Matrix: `source × geo × device` с CTR/CR/FTD Rate/EPC.
Карта гео: клики, регистрации, FTD, NGR; фильтр по разрешенным рынкам.
Креатив-таб: превью, формат, позиция, CTR, CR, FTD Rate, EPC.

Воронка

Когhort Retention (FTD-cohort): D1/D7/D30.
Path Analysis: landing → action → reg → kyc → deposit.

Финансы

Модель выплат: текущая ставка (CPA/RevShare/Hybrid) и условия качества.
Accruals & Adjustments: начисления, chargebacks/clawbacks, пояснения.
Payouts: статусы (Pending/Approved/Paid/Hold), способ, график.

Комплаенс

Allowed/Restricted: гео, каналы (например, контекст/соцсети/тик-ток/стримы), словарь запретов.
Brand Watch: нарушения (логотип, claims «без KYC», «моментальный вывод» и т. п.), тикеты и дедлайны.

8) Данные и витрины

События (минимальный контракт)

`click` (click_id, ts, ip, ua, geo, utm, subid, device, referer).
`landing_view` (session_id, ts, lp_id, performance timings).
`registration` (user_id, ts, click_id?).
`kyc_status` (user_id, ts, status).
`deposit` (user_id, ts, amount, currency, method, is_first).
`bet_result` (user_id, ts, stake, win).
`payout_update` (affiliate_id, ts, amount, status).
user_id псевдонимизирован.

Витрины

Fact_Clicks (grain: click_id).
Fact_Users (user_id, first_click_id, first_reg_ts, first_deposit_ts).
Fact_Finance (affiliate × day: начисления, корректировки, выплаты).
Fact_Perf (affiliate × subid × day: CTR/CR/FTD Rate/EPC).
Dim_Affiliate/Offer/Landing/Creative/Geo/Device.

9) Качество данных и антифрод

Детекция ботов: скорость кликов, повтор IP/UA, невалидные рефереры, JS-чек исполнения.
Гео-несоответствие: клики из запрещенного гео → авто-фильтр и тикет.
Аномалии: всплеск Reg без FTD, EPC→0, FTD Rate >> медианы (возможный инсент).
Контроль UTM/subid: обязательные поля, whitelist символов, дедупликация.
Логи S2S: идемпотентность (event_id), retry с экспоненциальной задержкой.

10) Выплаты и документы

Модели: CPA, CPL, RevShare, Hybrid.
Порог качества (для CPA): KYC pass, минимальные ставки/депозиты, отсутствие фрода.
График: еженедельно/ежемесячно/нетт-30; статусы по инвойсам.
Методы: банковский перевод, SEPA/SWIFT, e-wallets, крипто (если разрешено юрисдикцией).
Документы: договор, KYC аффилиата, налоговые формы, счет-фактура/акт.
Корректировки: chargeback (платеж), clawback (качество лида), hold (расследование).
История и экспорт: CSV/XLSX/JSON; журнал комментариев менеджера.

11) Комплаенс и приватность

RBAC: аффилиат видит только свои данные; менеджер — портфель; финансы — суммы без ПДн игроков.
PII-минимизация: аффилиату не показываются персональные данные игроков; только агрегаты и анонимные идентификаторы.
Политики гео/каналов: whitelist/blacklist, авто-санкции и эскалации.
Хранение событий: срок ретенции, право на удаление агрегатов после закрытия договора (по контракту).
Лог действий: кто что выгружал/менял (постбеки, ключи API).

12) UX-паттерны

Карточки KPI с трендами и доверительными коридорами.
Таблица «subid leaderboard» с быстрым фильтром и закрепом колонок.
Мастер-генератор ссылок: выбор оффера→лендинга→deeplink→UTM/subid.
«Explain this drop»: вклад гео/креативов/времени суток в падение CR/FTD Rate.
Центр креативов: превью, статусы модерации, авто-генерация размеров, UTM шаблоны.
Ночной режим, быстрые клавиши, сохраненные отчеты и шэринг пресетов.

13) A/B-эксперименты (со стороны аффилиата)

Гипотеза: креатив/лендинг/заголовок/формат.
Цель: EPC/FTD Rate/CR(Clk→Reg).
Дизайн: равномерное распределение по subid/креативу; длительность до MDE.
Guardrails: Invalid Click Rate, Complaints Rate, CR(KYC), latency лендинга.
Отчет: uplift, доверительный интервал, риск деградации.

14) Алерты и нотификации

EPC ↓ > X% к 7-дневной медиане.
CR(Clk→Reg) или FTD Rate провалились ниже порога качества.
Invalid Click Rate ↑ или geo-несоответствие.
Порог выплат достигнут / инвойс отклонен / начислена корректировка.
Истечение ключа API или ошибка постбека.

15) Чек-лист внедрения (по спринтам)

Спринт 1: события кликов/регистраций/депозитов, витрины Fact_Clicks/Fact_Perf, главная «Сегодня».
Спринт 2: генератор ссылок, SmartLink, базовые отчеты subid/гео, экспорт.
Спринт 3: постбеки S2S, логи и тестер, антифрод-правила, алерты.
Спринт 4: финансы (начисления, корректировки, выплаты), инвойсы, журнал.
Спринт 5: комплаенс-центр, бренд-модерация креативов, RBAC, audit log.
Спринт 6: A/B-модуль, explainers, рекомендации оптимизации.

16) Глоссарий (кратко)

UTM — метки кампаний; subid — доп. параметры партнера.
CPA/CPL/RevShare/Hybrid — модели выплат.
EPC — доход на клик. RPA — доход на лид/FTD.
Clawback — обратная корректировка за некачественный лид.
SmartLink — динамическая маршрутизация трафика на лучший оффер/лендинг.
KYC Pass — верификация игрока. FTD — первый депозит.

17) Антипаттерны

Смешение PII игроков в панели аффилиата.
«Темные» KPI без формул и источников.
Отсутствие тест-инструментов для постбеков и журнала интеграций.
Нет объяснения падений/ростов (слепые цифры без вкладов).
Жесткие отчеты без сохраненных представлений и API.

18) Итог

1. показывает эффективность и качество по каждому источнику/субиду,

2. объясняет почему меняется EPC/CR/FTD Rate и где «закупорка» воронки,

3. позволяет действовать: менять ссылки и креативы, настраивать постбеки, управлять финансами и соблюдать комплаенс — быстро, прозрачно и безопасно.