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

1) Эмне үчүн экосистема шилтемелер

• атрибуциянын жана төлөмдөрдүн болжолдонушу;
• өнөктөштөрдүн онбординг жана масштабдоо ылдамдыгы;
• коопсуздук/купуялуулук (PII-минималдаштыруу, RG-guardrails);
• экономика (чынчыл split, Cost-to-Serve, ROI каналдар).

2) Рефералдык байланыштардын моделдери

2. 1 тереңдик боюнча

Бир баскычтуу (L1): максаттуу иш-чара (FTD/депозиттик/миссиясын жандандыруу) үчүн баштапкы реферердин сыйлыгы.
Көп баскычтуу (L2 +): төлөмдөрдүн үлүштөрү дарактын жолдомо боюнча кетет; деңгээл/капам/комиссиялар боюнча чектөө колдонулат.
Гибрид: L1 fix + L2 боюнча кичинекей "жука куйрук".

2. 2 таасир алып жүрүүчүсү боюнча

Аффилиат/медиа (тармактар, коомдук, стримерлер).
User-to-User (жолдомо коддору/оюнчу шилтемелер).
Co-бренд/B2B (өнөктөш бренддер/операторлор, кросс-чынжыр өтүү).

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

Hub & Spoke: атрибуция жана пост-бекеттердин бирдиктүү борбору - ыңгайлуу.
Mesh (Киргизия): чынжыр ортосундагы түздөн-түз байланыштар - катуу канондук окуялар жана кол талап кылат.
Layer-to-Layer: медиа → offer → төлөмдөр/CUS → оюн (так домендер жана кулпулар).

3) Онтология жана идентификаторлор

3. 1 Негизги нерселер

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

3. 2 Байланыш жана купуялык

PII сейф-зоналарда сакталат, алмашуу - токендер/псевдонимдер гана.
Окуя менен Click байланыш: 'traceId' Click/Link тартып каттоо/депозиттик/оюнга чейин созулат.
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, postbeky

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 менен Retray; кайталоо үчүн реестр; тарыхтын курстук түшүрүлүшү.

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

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

Last eligible touch менен терезелер боюнча юрисдикциялар жана каналдар.
Cross-түзмөк макулдашылган токендер/Fingerprints аркылуу stitching (чийки PII жок).
Көп баскычтуу каттамдарда - депозиттердин салмагы (төмөндөгү сплиттерди караңыз).

6. 2 Чыр-чатактарды чечүү

Эгер L1 терезеси активдүү болсо, медиа чыкылдатуу боюнча колдонуучунун түз рефералынын артыкчылыгы.
Фрод/Невалид: "disputed" деген белгилер, reconciliation чейин төлөөлөр холд.

7) Антифрод жана сапаттуу рефералдык трафик

Сигналдар: device farm, табигый эмес CTR/CR, тез басуу/каттоо айлампалары, geo/ASN, brand-bidding, мазмун түрүндөгү стимулдаштыруучу трафик.
Иш-аракеттер: auto-муздатуу, тыныгуу link/offer, ачкычтарды чакыртып алуу, blacklist сайттар, кайра текшерүү реферер.
Scorecard сапаты: LTV/FTD, сактоо, chargeback/bonus-abuse, тактык/өз убагында пост.

8) Төлөмдөрдү эсептөө жана сплиттер

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

CPA/CPL (FTD/каттоо сыяктуу окуя үчүн fix).
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 жана локализациялоо: юрисдикциялар боюнча сактоо жана иштетүү, эрежеден тышкары PDn чек ара экспортуна тыюу салуу.

10) Dashbord жана байкоо

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

Click, каттоо, KYC, FTD, депозиттер, CR/ARPU/LTV, postbekov статусу, split жана күтүлүп жаткан төлөмдөр, капка/квота.

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/вебхуктарды берүү; Sandbox жана conformance кол тесттер/демпотенттик.

12. 2 өзгөртүүлөр/релиздер

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

12. 3 окуялар/war-room

P1/P2, токтотуу баскычтары (Traffic/Offer/каттам), 60-90s соода пакети боюнча SLA, RCA "эч кандай күнөөлүү".

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

Курстук жүктөмөлөр, окуялардын хэштерин салыштыруу, актылар/инвойстор, NET7/14/30, кармоо (фрод/чарджбеки/бонус-кыянаттык), FX курстары.

13) Экосистеманын калган катмарлары менен интеграция

Төлөмдөр/ARM: квоталар жана CR/P95 деградациясында cut-over.
KYC/AML: pass-rate жана SLA этаптары; төмөнкү тобокелдик үчүн fast-track.
Контент/миссиялар: RTP/туруксуздукту жана аймактык чектөөлөрдү текшерүү менен оюндар/турнирлерге диплинкалар.
Analytics/ML: propensity-моделдер, offers ранжирлөө, антифрод сигналдары.

14) Анти-үлгүлөрү

"Зоопарк postbekov": ар кандай форматтар/кол тамгалар/терезелер → дубль, жоготуулар, талаш-тартыштар.
Offset-pagination окуяларды жүктөө → тешиктер/кайталап (гана курсор).
Jitter/чеги жок Retrais → бороон жана кош эсептер.
PII реф-окуялар → агып жана бузууларды.
Чексиз көп баскычтуу куйруктары → уулуу экономика, көзөмөлдөө мүмкүн эмес.
N + 1/health-flip жок бирдиктүү SPOF-redirect.
Жок traceId → атрибутика далилдөө мүмкүн эмес.

15) Чек баракчалары

15. 1 долбоорлоо

• Онтология жана Schema Registry (версиялары, милдеттүү талаалар).
• Postbekov келишимдери жана кол тамгалар (JWS/HMAC), деэптификациялоо терезе.
• SmartLink/Deep Link генератор, TTL жана параметрлерин коргоо.
• Атрибуция: эреже, терезелер, карама-каршылыктардын артыкчылыктары, кросс-түзмөк ститчинг.
• Төлөмдөрдүн жана сплиттердин моделдери, капкалар/лимиттер, чегерүүлөр.
• Zero Trust, tokenization, DPIA/DPA, RG-guardrails.
• Dashboard/scorecards жана SLO, Алерт жана war-room.

15. 2 ишке киргизүү

• Sandbox/conformation, сыноо окуялар жана салыштыруу.
• прогрессивдүү релиз, auto-rollbek.
• reconciliation жана invoys-paypline туураланган.

15. 3 Иштетүү

• Жума сапаты scorecards жана SLO.
• Талаш-тартыштарды/холдинг учурларда Review.
• Мезгил-мезгили менен RCA жана эрежелерди жаңыртуу.

16) Жетилүү жол картасы

v1 (Foundation): окуялардын/постбектердин бирдиктүү каноникасы, SmartLink, L1-модель, базалык дашборддор.
v2 (Integration): кайчылаш чынжыр Refs, курсордук реплика, гибриддик төлөмдөр, scorecards жана auto-муздатуу.
v3 (Automation): SLI/RG боюнча ML-offers, алдын ала cut-over төлөмдөр/CUS, auto-guardrails.
v4 (Networked): тармактардын ортосундагы федералдык атрибуция, жамааттык миссиялар/турнирлер, DAO-split эрежелери.

17) Ийгиликтин метрикасы

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

Кыскача резюме

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