Панель афіліату і трекінг трафіку

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 Комісія = Ставка _ СРА × кількість валідних 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» з швидким фільтром і закрепом колонок.
Майстер-генератор посилань: Вибір offera→lendinga→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. дозволяє діяти: міняти посилання і креативи, налаштовувати постбеки, керувати фінансами і дотримуватися комплаєнсу - швидко, прозоро і безпечно.