S2S-treking we postbekler nähili işleýär

1) S2S näme we näme üçin zerur?

S2S (server-to-server) treking - bu, brauzer kuklalaryna we blokirlemelerine garamazdan, traffik çeşmesi serwerleriniň (re directorissýoryňyz/trekeriňiz/toruňyz) we operatoryň (kazino) serwerleriniň arasynda wakalaryň alyş-çalşygydyr.

Postbek - iberijiniň arkandyndan alyjynyň URL-sine waka (reg/KYC/FTD/2nd_dep/...) bilen gidýän HTTP-haýyş.

Artykmaçlyklary:

Adblock/ITP/şahsy usullar sebäpli maglumatlar ýitirilmeýär.
Atributyň takyklygy we billingiň hili ýokarlanýar.
Pul/walýuta we gulluk baýdaklary howpsuz geçirilip bilner.

2) Esasy zynjyr we rollar

1. Basmak: ulanyjy mahabaty basýar → re directorissýoryňyz 'click _ id' döredýär we parametrleri (utm, geo, device, sub_id).

2. Redirekt: ulanyjy operatoryň ýerine gidýär, 'click _ id' URL-e goýberildi ýa-da şifrlendi.

3. Hasaba alyş/KCS/goýumlar operatorda geçirilýär.

4. Postbekler: Operatoryň serweri 'registration', 'kyc _ approved', 'deposit _ success' we ş.m. wakalary yzarlaýjyňyza iberýär.

5. BI/Hasabat: Siz wakalary UTM/creative/geo/device bölekleri boýunça jemleýärsiňiz, CPA/ROAS/LTV hasaplaýarsyňyz.

Tekst shemasy:


Ad → Click → [Redaktoryňyz: click_id döredýär] → LP/App → (Reg/KYC/FTD operatoryň tarapynda)
↑             │
└──────── Postback (S2S) ─┘

3) Wakalaryň kesgitleýjileri we baglanyşygy

click_id (ýüki) - ilkinji degmegiň özboluşly şahsyýeti; atributyň açary.

event_id - her wakanyň özboluşly şahsyýeti (idempotentlik üçin).

user_id/ account_id (ops.) - Operatoryň tarapynda oýunçynyň şahsyýeti (diňe S2S-e berilýär).

session_id - UX/tizlik derňewi üçin.

aff_sub/campaign/ creative_id - analitika üçin bölekler.

Düzgün: click_id döredilýär; operator öz tarapynda mapping 'click _ id user/account' saklaýar.

4) Wakalaryň ugurlary: iň az düzümi

4. 1. Registration

json
{
"event": "registration",  "event_id": "reg_8f9...",  "click_id": "clk_123...",  "account_id": "u_456...",  "geo": "BR",  "device": "android",  "ts_event": "2025-10-21T14:54:12Z",  "ip": "203. 0. 113. 7",  "ua": "Mozilla/5. 0",  "signature": "hmac_sha256(payload)"
}

4. 2. KYC Approved

json
{
"event": "kyc_approved",  "event_id": "kyc_b21...",  "click_id": "clk_123...",  "account_id": "u_456...",  "ts_event": "2025-10-21T15:10:05Z",  "kyc_level": "basic    full",  "signature": "..."
}

4. 3. Deposit (FTD/Repeat)

json
{
"event": "deposit_success",  "event_id": "dep_9aa...",  "click_id": "clk_123...",  "account_id": "u_456...",  "amount": 100. 00,  "currency": "USD",  "is_ftd": true,  "payment_method": "card    pix    crypto    wallet",  "ts_event": "2025-10-21T15:12:31Z",  "signature": "..."
}

Hökmany meýdanlar: 'event', 'event _ id', 'click _ id', 'ts _ event' (UTC), 'signature'.

Pul meýdançalary elmydama 'currency' (ISO-4217) bilen we setirler hökmünde däl.

5) Howpsuzlyk: gollar we elýeterlilik

Подпись (HMAC-SHA256): `signature = HMAC(secret, canonical_payload)`; meýdanlaryň tertibini kanonlaşdyryň → durnukly barlag.

Gysga ömürli bellikler (JWT/opaque) ygtyýarnama derejesinde: TTL 5-15 minut.

Idempotentlik: şol bir 'event _ id' bilen gaýtalanýan POST '200 OK' bermeli.

IP allow-list we mTLS (mümkin bolsa).

Rate limiting: endpoint-i "burst" we botlardan goraň.

HTTP-redaktorlary postbek-endpointden gadagan etmek; diňe göni jogaplar.

6) Ygtybarlylyk: retralar, nobatlar we tertip

(Kafka/RabbitMQ/SQS) wakany kabul etmek bilen hasabatlary gaýtadan işlemegiň arasynda nobat - piklerde maglumatlary ýitirmezlik üçin.

Eksponensial arakesme we backoff-jitter bilen retralar; synanyşyk çäkleri we DLQ (dead-letter queue).

Tertip hökman däl, ýöne BI sortlamak üçin 'ts _ event' bolmagy islenýär.

Haýyş/jogap ýazgylary (duýgur maglumatlarsyz), 'event _ id' bilen baglanyşyk.

7) Wagtlaýyn zolaklar, walýuta we yzygiderlilik

Ähli wagt bellikleri UTC-de ('2025-10-21T15: 12: 31Z').

Hasabatda taslamanyň timezone görkeziň, ýöne wakalary UTC-de saklaň.

Pullary geleşigiň walýutasynda saklaň we hasabatyň walýutasynda ygtybarly kurs (data-time-based FX) arkaly köpeldiň.

8) De-duplikasiýa we işewürlik düzgünleri

event_id boýunça meňzeşlik: → "eýýäm işlenildi".

Ätiýaçlyk mehanizm hökmünde (click_id + wakanyň görnüşi + ts-penjire) boýunça duplikasiýa.

FTD-iň ygtybarlylyk düzgünleri: iň az goýum, bonus "nol" goşundylarsyz; şertnamada belläň.

"Chargeback/Refund" - dogruçyl NGR üçin "negatiw girdejiniň" aýry-aýry wakalary.

9) Gizlinlik we gabat gelmek

PII-ni URL-e we öň tarapa geçirmäň; S2S - duýgur meýdanlar üçin ýer.

Consent/razyçylygy (analytics/ads) saklaň we wersiýa ediň.

Meýdanlary azaldyň: diňe atributiýa we billing üçin zerur zat.

Sahypalaryň retention syýasatlaryny yzygiderli gözden geçiriň.

10) Web2App we mobaýl-hakykatlar

Programmalar üçin MMP/SDK tarapynda 'click _ id' 'install _ id' baglanyşdyryň.

Kesgitlenen ID (iOS gizlinlik) ýok bolsa - ähtimallyk oýnuny + serwer düzgünlerini ulanyň, S2S bolsa billing üçin "hakykat" bolup galýar.

11) Gözegçilik we SLA

Metrikler:

Üstünlikli/ýalňyş postbekler (%/min), p95 latency, retraýlaryň paýy, dublikatlaryň paýy.
Taraplaryň arasyndaky wakalaryň gije-gündiziň dowamynda tapawudy (operator vs tracker).
Eltmegiň gijikdirilmegi (ingestion lag) we sagatlar boýunça "şowsuzlyklar".

SLA (mysal):

Postbekleri kabul etmegiň elýeterliligi ≥ 99. 5 %/aý.
DWH ýazgysyna çenli ortaça gijä galmak ≤ 60 sek; API jogap p95 ≤ 500 ms.
Maglumat rasinhrony> 3% → 5 iş gününiň dowamynda çig ýazgylary hökmany barlamak.

12) Çek-listler

12. 1. Başlamazdan ozal çek

click_id we loglar bilen redaksiýa.
Postbekleriň sany: TLS, HMAC, JWT, IP allow-list, idempotency.
Tölegleriň shemalary we meýdanlaryň kanoniki tertibi resminamalaşdyrylýar.
Nobatlar + DLQ, retralar, ýalňyşlyklar/gijikdirmeler sebäpli aladalar.
UTC-wagt, ISO-walýuta, FTD/Refund/Chargeback düzgünleri.
Standart ýazgylary düzmek bilen sandbox-da geçişler.

12. 2. Amal çeki (her hepde)

Wakalaryň mukdary we mukdary boýunça "operator tracker" barlagy.
Dublikatlary we "ýitirilen" wakalary seljermek; retraýlaryň barlagy.
Açarlary/bellikleri, ömrüni we aýlanyşyny barlamak.
Wakalary görmek we düzgünleri düzetmek.

13) Ýygy-ýygydan ýalňyşlyklar we olardan nädip gaça durmaly

1. Retralarda idempotency → FTD jübüti ýok. → 'event _ id' we "seen" ammaryny giriziň.

2. Dürli wagt guşaklary → "ýüzdi" D0/D1. → Elmydama wakalar magazineurnalynda UTC.

3. Setirli summalar/vergul → parsing ýalňyşlyklary. → Sanlary nokat we ISO-walýuta bilen geçiriň.

4. "Çig" JSON → goly açarlaryň tertibinden döwülýär. → Kanonlaşdyryň.

5. DLQ/retrailer ýok → mikroskoplarda wakalaryň ýitmegi. → Nobat + backoff + alertler.

6. Gowşak şahsyýet → galp postbekler. → HMAC + JWT + mTLS/IP-sanawy.

7. FTD düzgünleriniň ýoklugy → billing jedelleri. → Şertnamadaky kesgitlemeleri düzüň.

14) Haýyşlaryň we jogaplaryň mysallary

14. 1. POST/postback (operator → tracker)


POST /postback HTTP/1. 1
Content-Type: application/json
Authorization: Bearer eyJhbGciOi...
X-Signature: sha256=ab12...

{ "event":"deposit_success","event_id":"dep_9aa",  "click_id":"clk_123","account_id":"u_456",  "amount":100. 00,"currency":"USD","is_ftd":true,  "ts_event":"2025-10-21T15:12:31Z" }

Jogap:


200 OK
{ "status":"ok", "idempotent": false }

Şol bir 'event _ id' bilen gaýtadan ibermek:


200 OK
{ "status":"ok", "idempotent": true }

14. 2. Gol hatasy


403 Forbidden
{ "error":"signature_invalid", "hint":"check canonical order" }

15) Wakalar we seljermeler

Simptom: FTD = 120 operatorda, sizde - 117.

Meýilnama:

1. Wagt aralygyny (UTC) we walýutalary deňeşdirmek.

2. Çig loglary 'event _ id '/' click _ id' boýunça boşatmak.

3. Gol/TTL sebäpli ret edilen nyşany/idempotentligi gözläň.

4. DLQ-den "dykylan" wakalary goşmaça tabşyrmak, barlamak aktlary.

16) 30-60-90 girizmek meýilnamasy

0-30 gün - Kontur MVP

Redaktory 'click _ id' we loglar bilen başla.

Postbekleri kabul etmek: HMAC, JWT, idempotency, nobatlar, DLQ, alertler.

Sandbox götermek, synag jemleri bilen reg/FTD ahyrky ssenarisini sürmek.

Şemalary we meýdançalaryň kanonizasiýasyny resminamalaşdyrmak.

31-60 gün - Hil we masştab

Pul hadysalaryny we iki walýuta hasabyny goşuň (txn & report).

p95 latency, gapma-garşylyklary we retraýlary sazla.

SLA/hadysalaryň proseduralaryna gol çekmek; çargeback/refund wakalary goşuň.

BI-de penjireleri ýygnamak: FTD, Payback, D7/D30 ARPU.

61-90 gün - Durnuklylyk we audit

Syrlaryň/şahadatnamalaryň aýlanmagyny, şowsuzlyga çydamlylyk synaglaryny girizmek.

Ýükleýji synaglary we "gyssagly maşklary" geçirmek (nobatyň düşmegi/DB).

FTD shemalarynyň/düzgünleriniň barlagy we çärýekleýin auditini resmileşdirmek.

17) Jemleýji

S2S-tracking - dogruçyl atributyň we billingiň "gerşi": click_id esasy açar, goralýan postbekler, idempotentlik, retrailer we berk wagt/walýuta arassaçylygy. Muňa aç-açan FTD tassyklama düzgünlerini, chargeback-wakalary we kämillik monitoringini goşuň - her öwrülişik serwer tarapyndan tassyklanan we hasabatlarda bir sente çenli jemlenen ygtybarly ulgam alarsyňyz.