Affiliate Panel жана Tracking Traffic

1) Максаты жана принциптери

• Трафиктин ачык атрибуциясы (click → reg → KYC → FTD → депозиттик активдүүлүк).
• Fast оптималдаштыруу: Creatives, лендинг, гео, аппараттар, күнү-түнү.
• Сапатты жана комплаенс контролдоо: антифрод, geo/funnel-шайкештик, бренд-гайдалар.
• Финансылык тазалык: төлөм моделдери (CPA/CPL/RevShare/Hybrid), документтер, график.

• Time-to-insight <10 сек: фильтрлердин пресеттери, "бекитилген" көрсөтүүлөр.
• Сигналдар> чийки зат: CTR/CR/FTD-Rate, бурн-down бюджеттин аномалиялар жарык.
• Түшүндүрмө: "Эмне үчүн чөгүп кетти?" - гео/креативдик/булак/түзүлүштүн салымы.
• Ролдук жетүү: аффилиат, аккаунт-менеджер, финансы, комплаенс - ар кандай укуктар.

2) Ролдору жана жагдайлар

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

3) Маалыматтык архитектура (IA)

1. Глобалдык чыпкалар (үстүнкү): мезгил, программа/бренд, гео, түзмөк/OS/браузер, булак/канал, субаккаунттар (subid1.. subid5), креативдер, лендингдер, offer id.
2. үй ("Бүгүн"): KPI-кыскача + Алерт/аномалиялар.
3. Трафик: булактар, UTM/Ref, SmartLink-багыттоо, креативдүү позициялар.
4. Huni: clicks → registrations → KYC pass → FTD → кайталап депозиттер.
5. Финансы: төлөмдөрдүн, ставкалардын, эсептөөлөрдүн, оңдоолордун, төлөмдөрдүн модели.
6. Куралдар: шилтемелер генератор, postbeky (S2S/Клиент), API-жетүү, экспорт.
7. Комплаенс: уруксат GEO/каналдар, бренд-HYDE, мыйзам бузууларды текшерүү.

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 (1th депозит )/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 = (бот/дубликат/бош Subsides )/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: Clicks (X күн), view-through (Y саат, кошумча жана кылдат).
Дедупликация: user_id/фингерпринту/куки + тастыктоо S2S.

6) Postbeky, пиксел жана API

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

Кол HMAC, allowlist IP, retry-логика, боштук.
Client Pixel (fallback): жөн гана көрүү иш-чаралар үчүн, эч кандай сезимтал маалыматтар.
Тест-утилита: "Тест постбек жөнөтүү" → статус/жооп журналы.
Аффилиаттын API: күндөр/соттор боюнча отчеттор, чыгармачылыктын тизмелери, төлөмдөрдүн статусу.
Webhooks: эсептөө/оңдоо/төлөө; сапаты төмөн же ийгиликсиздиктин көтөрүлүшү жөнүндө.

7) Widgets жана отчеттор (сунушталган топтому)

Башкы бет ("Бүгүн")

Revenue Pulse: мезгил үчүн төлөмдөр vs план/өткөн жума.
Funnel Pulse: Clk → Reg → KYC → FTD (тар жерлери жарык).
Quality Monitor: Invalid Clicks, Early Churn, Clawback% - жол чырак.
Top Movers: EPC/FTD баасы ири өсүшү/төмөндөшү менен Subides/чыгармачылык.

Traffic

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

Huni

Ког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-чек аткаруу.
Гео-дал келбестиги: тыюу салынган Гео → auto чыпкасы жана билети чыкылдатуу.
Аномалиялар: FTD жок Reg, EPC → 0, FTD Rate>> медиандар (мүмкүн инсент).
UTM/subid Control: милдеттүү талаалар, whitelist белгилер, deduplication.
Logy S2S: idempotentity (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: аффилиат өзүнүн маалыматтарын гана көрөт; менеджер - портфель; каржы - PDn оюнчусу жок суммалар.
PII-минималдаштыруу: аффилиатка оюнчулардын жеке маалыматтары көрсөтүлбөйт; гана агрегаттар жана анонимдүү идентификаторлор.
Geo/каналдар саясаты: whitelist/blacklist, auto-жаза жана эскалация.
Окуяларды сактоо: ретенциянын мөөнөтү, келишим жабылгандан кийин агрегаттарды алып салуу укугу (контракт боюнча).
Иш-аракеттердин журналы: ким эмне жүктөп/алмаштырды (postbeky, API ачкычтары).

12) UX үлгүлөрү

Тенденциялар жана ишенимдүү коридорлор менен KPI карталары.
стол "subid leaderboard" тез чыпкасы жана мамычаларды бекитүү менен.
Мастер шилтемелер Generator: тандоо offer → лендинг → deeplink → UTM/subid.
"Explain this drop": CR/FTD рейтингинин кулашына гео/чыгармачылардын/сутканын убактысынын салымы.
Creatives борбору: preview, модерация статусу, көлөмдөрү auto-generation, 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 баасы сапат босогосунан төмөн түшүп кеткен.
Invalid Click Rate ↑ же гео-дал келбестик.
Төлөмдөрдүн босогосу жетишилди/инвойс четке кагылды/эсептелди.
API ачкычынын бүтүшү же postback катасы.

15) Киргизүү чек-тизмеси (спринттер боюнча)

Спринт 1: иш-чаралар басуу/каттоо/депозиттер, Fact_Clicks/Fact_Perf, негизги "Бүгүн".
Sprint 2: шилтемелер Generator, SmartLink, негизги отчеттор subid/гео, экспорт.
Спринт 3: постбеки S2S, логи жана тестер, анти-тир эрежелери, алерталар.
Спринт 4: финансы (эсептөөлөр, оңдоолор, төлөмдөр), инвойстар, журнал.
Спринт 5: комплаенс борбору, чыгармачылыктын бренд модерациясы, RBAC, аудит журналы.
Спринт 6: A/B-модулу, explainers, оптималдаштыруу сунуштар.

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

UTM - үгүт белгилери; subid - өнөктөштүн кошумча параметрлери.
CPA/CPL/RevShare/Hybrid - төлөм моделдери.
EPC - чыкылдатуу кирешеси. RPA - lid/FTD боюнча киреше.
Clawback - сапатсыз lid үчүн тескери түзөтүү.
SmartLink - мыкты offer/lending үчүн динамикалык жол багыттоо.
KYC Pass - оюнчу текшерүү. FTD - биринчи депозит.

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

Аффилиат панелиндеги PII оюнчуларды аралаштыруу.
"Караңгы" формулалары жана булактары жок KPI.
Постбектер жана интеграция журналы үчүн тест-инструменттердин жоктугу.
Төмөндөө/өсүү үчүн эч кандай түшүндүрмө жок (депозиттери жок сокур сандар).
сакталган өкүлчүлүктөрү жана API жок катуу отчеттор.

18) Жыйынтык

1. ар бир булак/субид боюнча натыйжалуулугун жана сапатын көрсөтөт,

2. эмне үчүн өзгөрүп жатканын түшүндүрөт EPC/CR/FTD Rate жана кайда "бөгөттөө" воронка,

3. иш-аракет кылууга мүмкүндүк берет: шилтемелерди жана чыгармачылыкты өзгөртүүгө, пост-бекеттерди орнотууга, каржыны башкарууга жана комплаенс сактоого - тез, ачык жана коопсуз.