Рефералдық байланыстардың архитектурасы

1) Не үшін экожүйеге рефералдық байланыстар

• атрибуция мен төлемдердің болжамдылығы;
• әріптестердің онбординг және масштабтау жылдамдығы;
• қауіпсіздік/құпиялылық (PII-минимизация, RG-guardrails);
• экономика (адал сплит, Cost-to-Serve, ROI арналар).

2) Рефералдық байланыстардың модельдері

2. 1 Тереңдігі бойынша

Бір деңгейлі (L1): мақсатты оқиға үшін бастапқы реферердің сыйақысы (FTD/депозит/миссияны белсендіру).
Көп деңгейлі (L2 +): төлем үлестері рефералдар ағашының бойымен жоғары кетеді; деңгей/капиталар/комиссиялар бойынша шектеу қолданылады.
Гибрид: L1 фикс + L2 бойынша шағын «жұқа құйрық».

2. 2 Әсер жеткізгіші бойынша

Аффилиат/медиа (желілер, паблишерлер, стримерлер).
User-to-User (ойыншылардың рефералдық кодтары/сілтемелері).
Ко-бренд/В2В (серіктес брендтер/операторлар, кросс-тізбекті өткелдер).

2. 3 Алмасу топологиясы бойынша

Hub & Spoke: атрибуция мен постбектердің бірыңғай орталығы - конформанстан оңай.
Mesh (федерация): тізбектер арасындағы тікелей байланыстар - оқиғалар мен қолдардың қатаң каноникасын талап етеді.
Layer-to-Layer: медиа → оффер → төлемдер/ҚҰС → ойын (нақты домендер мен шлюздер).

3) Онтология және сәйкестендіргіштер

3. 1 Негізгі мәні

`referrerId`, `referralId`, `playerId` (псевдоним), `affiliateId`, `campaignId`, `offerId`, `routeId`, `operatorId`, `providerId`, `traceId`.

3. 2 Байланыстылық және құпиялылық

PII сейф-аймақтарда, айырбастауда - тек токендер/бүркеншік атаулар ғана сақталады.
Кликтің оқиғамен байланысы: 'traceId' кликтен/сілтемеден тіркеуге/депозитке/ойынға дейін созылады.
Рефкодтар токендеріне арналған TTL/expiry; құрылғыларды қайта байланыстырудан қорғау.

4) Оқиғалық модель және деректер келісімшарттары

4. 1 Оқиғалар жиыны

`ref_click`, `deep_link_open`, `session_start`, `registration`, `kyc_status`, `deposit`, `ftd`, `bet/spin`, `mission_progress`, `reward_granted`, `ref_postback_received`, `fraud_signal`.

4. 2 Оқиғаларға қойылатын талаптар

Схемалардың семантикалық нұсқалары (Schema Registry), міндетті өрістер және жарамды мәндер.
«eventId» + дедупликация терезесі арқылы сәйкестігі (± 5 мин).
Уақыт белдеулері - UTC/ISO-8601, барлық сомалар мен валюталар с 'currency'.

5) Хаттамалар: сілтемелер, дипломинкалар, SmartLink, постбектер

5. 1 Реф-линктерді генерациялау

Параметрлері: 'rid' (реферер), 'cid' (кампания), 'oid' (оффер), 'sub1.. sub5', 'utm _', 'traceId'.
Параметрлердің қолтаңбасы (JWS/HMAC), TTL, ауыстырудан қорғау ('kid', 'timestamp').

5. 2 SmartLink/Deep Link

SmartLink төлем бағыттарының SLO гео/юрисдикциясы/құрылғысы/жай-күйі бойынша қайта бағыттайды.
Deep Link нақты ойынды/лендингті/миссияны жүргізеді (аймақ/лицензия бойынша қолжетімділікті тексеру).

5. 3 Бекеттер (S2S)

Қол қойылған вебхактар: 'signature', 'eventId', 'timestamp', 'rid/cid/oid', 'traceId'.
Джиттермен және backoff ретрайлері; қайта ойнатуға арналған тізілім; тарихты курстық түсіру.

6) Атрибуция және коллизиялар

6. 1 Атрибуция ережелері

Last eligible touch юрисдикциялар мен арналар бойынша терезелері бар.
Келісілген токендер/фингерпринттер арқылы кросс-девайс ститчинг (шикі PII-сыз).
Көп сатылы бағыттар кезінде - салымдардың салмағы (төменде сплиттерді қараңыз).

6. 2 Коллизияларды шешу

Егер L1 терезесі белсенді болса, пайдаланушының тікелей рефералының медиа-түймешіктен артықшылығы.
Фрод/невалид: «disputed» белгісі, reconciliation-ға дейінгі төлемдердің холды.

7) Антифрод және рефералдық трафиктің сапасы

Сигналдар: device farm, табиғи емес CTR/CR, кликтердің/тіркеулердің жылдам циклдері, гео/ASN сәйкес келмеуі, brand-bidding, контент түріндегі ынталандыру трафигі.
Әрекеттер: автоматты салқындату, линк/оффер үзілісі, кілттерді қайтару, blacklist алаңдары, реферерді қайта верификациялау.
Scorecard сапасы: LTV/FTD, ұстап тұру, chargeback/bonus-abuse, нақтылығы/уақытылы пост.

8) Төлемдер мен сплиттерді есептеу

8. 1 Негізгі модельдер

CPA/CPL (оқиға үшін фикс, мысалы FTD/тіркеу).
RevShare (терезе бойынша Net Revenue үлесі).
Гибрид (фикс + үлес).
Көп деңгейлі сплит (L1/L2... қақпақтары/табалдырықтары бар).

8. 2 Формулалар (жеңілдетілген)

[
share_i=\frac{W_i \cdot Q_i}{\sum_j W_j \cdot Q_j}
]

мұнда (W_i) - қадамның салмағы (L1> L2... (Q_i) - сапа коэффициенті (SLI жеткізу, постбектердің дәлдігі, фродтың/RG-жалаулардың болмауы).

[
payout_i = share_i \times (Base\ Reward \ \text{или} \ Net\ Revenue \times rate) \times Adjustments
]

'Adjustments': SLO үшін кредиттер/пенальти, даулы жағдайлар үшін ұстап қалу, RG/санкциялық түзетулер.

8. 3 Шектеулер мен қауіптер

Тоқсандық/айлық лимиттер; ең төменгі төлем; даулы оқиғалардың даусымен холд; юрисдикция және төлем мәртебесі бойынша кесінділер.

9) Қауіпсіздік, құпиялылық және RG

Zero Trust: mTLS S2S үшін, қысқа өмір сүретін токендер, egress-allow-list.
PII-барынша азайту: реф-трафикте - тек токендер/бүркеншік атаулар; детокенизация қатаң түрде сейф-аймақтарда жүргізіледі.
RG-guardrails: осал сегменттер бойынша қарқындылықты шектеу; міндетті дисклеймерлер; тыйым салынған өңірлерде оффераларға тыйым салу.
DPA/DPIA және оқшаулау: юрисдикциялар бойынша сақтау және өңдеу, ПДн трансшекаралық экспортына тыйым салу.

10) Дашбордтар және бақылау

10. 1 Рефералдар/аффилиаттар панелі

Кликтер, тіркеулер, KYC, FTD, депозиттер, CR/ARPU/LTV, постбектердің мәртебелері, сплиттер және күтілетін төлемдер, капалар/квоталар.

10. 2 Экожүйе тақтасы

Байланыс картасы (referrer → реферал), когорттар, даулы үлестер, RG/санкциялық фолдар, инциденттер бойынша MTTR, арналар/тізбектер үлесі.

10. 3 SLO

Бекеттерді жеткізу ≥ 99. 9% (p95 ≤ 1-2 с), lag шиналар ≤ 200-500 мс, рендер панельдер p95 ≤ 1. 5–2. 0 с, трассамен жабу ≥ жолдардың 95%.

11) Governance и RACI

12) Операциялық процестер

12. 1 Реферердің онбордингі

KYP/KYB, трафик көздері, юрисдикция, бренд-гид, RG-келісім.
Кілттерді/API/вебхуктарды беру; құмсалғыш және conformance-қол қою/демпотенттілік тестілері.

12. 2 Өзгерістер/релиздер

Change-calendar (жасыл/сары/қызыл терезелер), прогрессивті қосылулар (1% → 5% → 25% → 100%), guardrails және авто-роллбек.

12. 3 Оқиғалар/war-room

P1/P2, тоқтату кнопкалары (трафик/оффер/маршрут), 60-90 с трейс-пакетке SLA, RCA «кінәлілерді іздемей».

12. 4 Reconciliation және төлемдер

Курстық түсіру, оқиғалар хэштерін салыстыру, актілер/инвойстар, NET7/14/30, ұстап қалулар (фрод/чарджбеки/бонус-абьюз), FX-курстар.

13) Экожүйенің қалған қабаттарымен интеграциялау

Төлемдер/АЖО: CR/P95 деградациясы кезіндегі квоталар және cut-over.
KYC/AML: pass-rate және SLA кезеңдері; төменгі тәуекелдерге арналған fast-track.
Контент/миссиялар: RTP/құбылмалылықты және өңірлік шектеулерді тексеретін ойындар/турнирлерге дипломинкалар.
Аналитика/ML: propensity-модельдер, оффераларды ранжирлеу, антифрод-сигналдар.

14) Қарсы үлгілер

«Постбеков хайуанаттар бағы»: түрлі форматтар/қолтаңбалар/терезелер → дубль, жоғалту, даулар.
Offset-оқиғалар тарихының жүктемесі → тесіктер/дубликаттар (тек меңзерлер).
Ретраялар джиттер/лимиттерсіз → дауыл және қосарланған есептеулер.
PII реф-оқиғаларда → ағулар мен бұзушылықтар.
Шектелмеген көп деңгейлі қалдықтар → уытты экономика, бақылаудың мүмкін еместігі.
N + 1/health-flip жоқ бірыңғай SPOF-редирект.
traceId → төлсипатын дәлелдеуге болмайды.

15) Чек парақтары

15. 1 Жобалау

• Онтология және Schema Registry (нұсқалар, міндетті өрістер).
• Постбектердің келісімшарттары және қолдары (JWS/HMAC), дедупликация терезесі.
• SmartLink/Deep Link генератор, TTL және параметрлерін қорғау.
• Атрибуция: ереже, терезе, коллизия басымдықтары, кросс-девайс ститчинг.
• Төлемдер мен сплиттердің модельдері, кепілдер/лимиттер, ұстап қалулар.
• Zero Trust, токенизация, DPIA/DPA, RG-guardrails.
• Дашбордтар/scorecards және SLO, алерталар және war-room.

15. 2 Іске қосу

• Құмсалғыш/конформанс, тест-оқиғалар және салыстыру.
• Прогрессивті релиз, авто-роллбек.
• reconciliation және инвойс-пайплайн теңшелген.

15. 3 Пайдалану

• Апта сайынғы сапа scorecards және SLO.
• Даулы/холдингтік істердің ревю.
• Мерзімді RCA және ережелерді жаңарту.

16) Жетілудің жол картасы

v1 (Foundation): оқиғалар/постбектердің бірыңғай каноникасы, SmartLink, L1-модель, базалық дашбордтар.
v2 (Integration): кросс-тізбекті рефбайланыстар, курсорлық репликалар, гибридтік төлемдер, scorecards және авто-салқындату.
v3 (Automation): ML-офферлерді ранжирлеу, болжамды cut-over төлемдер/АКҚ, SLI/RG бойынша auto-guardrails.
v4 (Networked): желілер арасындағы федеративті атрибуция, ұжымдық миссиялар/турнирлер, DAO-сплиттер ережелері.

17) Жетістік өлшемдері

Бизнес: реф-арналардан uplift FTD/ARPU/LTV, САС/өзін-өзі ақтауы, сапалы көздердің үлесі.
Сапасы: постбектердің дәлдігі/уақтылығы, даулылығы <X%, холды/чарджбеки.
Техника: p95 редакциялар мен постбектер, lag шиналар, инциденттер бойынша MTTR.
Комплаенс/RG: инциденттер ПДн = 0, юрисдикцияларды сақтау, RG-триггерлер/1k белсенді.
Экономика: Cost-to-Serve (per rps/txn/event), кредиттер/пенальти, ROI арналар.

Қысқаша түйіндеме

Рефералдық байланыстардың архитектурасы - бұл сәйкестендіргіштер мен оқиғалардың стандарттары, SmartLink/дипломинкалар және қол қойылған постбектер, адал атрибуция, қатаң құпиялылық және RG, плюс сплиттер мен бақылаудың мөлдір экономикасы. Каноника және SLO жасаңыз, guardrails және reconciliation автоматтандырыңыз - және рефералдық контур бүкіл экожүйенің масштабталатын, қауіпсіз және пайдалы іргетасына айналады.