Როგორ მუშაობს S2S ტრეკინგი და პოსტბეკი

1) რა არის S2S და რატომ არის ეს საჭირო

S2S (სერვერის სერვერი) ტრეკინგი არის ღონისძიებების გაცვლა ტრაფიკის წყაროს სერვერებს შორის (თქვენი რედაქტორი/ტრეკერი/ქსელი) და ოპერატორის (კაზინო) სერვერებს შორის, ბრაუზერის ქუქი-ფაილებისა და საკეტების მიხედვით.

Postbeck არის HTTP მოთხოვნა ღონისძიებასთან (reg/KYC/FTD/2nd _ dep/...) გამგზავნის ეკრანიდან URL მიმღებამდე.

უპირატესობები:

მონაცემები არ იკარგება adblock/ITP/პირადი რეჟიმების გამო.
იზრდება ატრიბუტის სიზუსტე და ბილინგის ხარისხი.
შეგიძლიათ უსაფრთხოდ გადაიტანოთ თანხა/ვალუტა და ოფიციალური დროშები.

2) ძირითადი ჯაჭვი და როლები

1. დაწკაპუნება: მომხმარებელი დააჭერს რეკლამას, თქვენი რედაქტორი ქმნის 'click _ id' და ახდენს პარამეტრებს (utm, geo, მოწყობილობა, sub _ id).

2. რედიქტი: მომხმარებელი მიდის ოპერატორის ლანდინგზე, 'click _ id' იშლება URL- ში ან დაშიფრულია.

3. რეგისტრაცია/KUS/ანაბრები ხდება ოპერატორთან.

4. პოსტბეკი: ოპერატორის სერვერი აგზავნის მოვლენებს 'registration', 'kyc _ approved', „deposit _ success“ და ა.შ., რომელიც აკავშირებს მათ თავდაპირველ „click _ id“.

5. BI/მოხსენება: თქვენ აერთიანებთ მოვლენებს UTM/კრეატიული/geo/მოწყობილობების მიხედვით, CPA/ROAS/LTV.

ტექსტის სქემა:


Ad - Click - [თქვენი რედაქტორი: წარმოქმნის click _ id] - LP/App- ს (Reg/KYC/FTD ოპერატორის მხარეს)
↑             │
└──────── Postback (S2S) ─┘

3) იდენტიფიკატორები და მოვლენების კავშირი

click _ id (.) - პირველი შეხების უნიკალური ID; ატრიბუტის გასაღები.

event _ id (სასურველია). - თითოეული მოვლენის უნიკალური ID (იდემპოტენტურობისთვის).

user _ id/account _ id (opc.) - მოთამაშის ID ოპერატორის მხარეს (გადადის მხოლოდ S2S- ში).

session _ id (opc.) - UX/სიჩქარის ანალიზისთვის.

aff _ sub/campaign/creative _ id - ჭრილობები ანალიტიკოსებისთვის.

წესი: click _ id იქმნება თქვენში; ოპერატორი თავის მხარეს ინახავს mapping 'click _ id' user/account '.

4) მოვლენების ველები: მინიმალური შემადგენლობა

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": "..."
}

სავალდებულო ველები: 'event', 'event _ id', 'click _ id', 'ts _ event' (UTC), 'signature'.

ფულადი ველები ყოველთვის ერთად 'currency' (ISO-4217) და, როგორც რიცხვები, არ არის ხაზები.

5) უსაფრთხოება: ხელმოწერები და წვდომა

Подпись (HMAC-SHA256): `signature = HMAC(secret, canonical_payload)`; შეამოწმეთ ველების პროცედურა და სტაბილური შემოწმება.

მოკლემეტრაჟიანი ნიშნები (JWT/opaque) ავტორიზაციის დონეზე: TTL 5-15 წუთი.

Idempotence: განმეორებითი POST იგივე 'event _ id' უნდა მისცეს '200 OK "დუბლის გარეშე.

IP allow-list და mTLS (თუ ეს შესაძლებელია) გაყიდვაში.

Rate limiting: დაიცავით endpoint „bursts“ და ბოტებისგან.

HTTP რედაქტორების აკრძალვა პოსტბეკის ენდპოინტიდან; მხოლოდ პირდაპირი პასუხები.

6) საიმედოობა: რელეები, რიგები და წესრიგი

რიგები (Kafka/RabbitMQ/SQS) ღონისძიების მიღებასა და ანგარიშების დამუშავებას შორის - ისე, რომ არ დაკარგოთ მონაცემები მწვერვალების დროს.

Retrai ექსპონენციალური პაუზით და backoff-gitter; მცდელობების ლიმიტი და DLQ (dead-letter queue).

ბრძანება არ არის სავალდებულო, მაგრამ მიზანშეწონილია BI- ში დახარისხების „ts _ event“.

თხოვნის/პასუხის ლოგოები (მგრძნობიარე მონაცემების გარეშე), 'ღონისძიების _ id' კორელაცია.

7) დროებითი ზონები, ვალუტა და თანმიმდევრულობა

UTC- ს ყველა დროის ეტიკეტი ('2025-10-21T15: 12: 31Z').

მოხსენებებში მიუთითეთ პროექტის timezone, მაგრამ შეინახეთ მოვლენები UTC- ში.

შეინახეთ თანხები გარიგების ვალუტაში და დუბლირება მოახდინეთ ანგარიშის ვალუტაში საიმედო კურსის საშუალებით (მონაცემთა დრო-ბარიერი FX).

8) დედუპლიკაცია და ბიზნესის წესები

Idempotention event _ id: გამეორება „უკვე დამუშავებულია“.

Deduplication (click _ id + ტიპის მოვლენა + ts ფანჯარა), როგორც სათადარიგო მექანიზმი.

FTD სავალდებულო წესები: მინიმალური ანაბარი, ბონუსის „ნულოვანი“ შევსების გარეშე; ჩაწერეთ ხელშეკრულებაში.

Chargeback/Refund არის „უარყოფითი შემოსავლის“ ცალკეული მოვლენები გულწრფელი NGR- სთვის.

9) კონფიდენციალურობა და შესაბამისობა

ნუ გადაიტანთ PII URL- ს ფრონტზე; S2S არის მგრძნობიარე ველების ადგილი.

შეინახეთ consent/consent (ads) და დაამატეთ ისინი.

მინიმუმამდე დაიყვანეთ ველები: მხოლოდ ის, რაც აუცილებელია ატრიბუტისა და ბილინგისთვის.

რეგულარულად შეამოწმეთ ლოგოების რეპენტაციის პოლიტიკა.

10) Web2App და მობილური რეალობა

პროგრამებისთვის დააკავშირეთ 'click _ id' install _ id 'MMP/SDK მხარეს.

როდესაც არ არსებობს დეტერმინირებული ID (iOS კონფიდენციალურობა) - გამოიყენეთ სავარაუდო მატჩი + სერვერის წესები, ხოლო S2S რჩება ბილინგის „ჭეშმარიტება“.

11) მონიტორინგი და SLA

მეტრიკა:

წარმატებული/მცდარი პოსტბეკები (%/წთ), p95 ლატენტობა, რეაგირების წილი, დუბლიკატების წილი.
მხარეებს შორის მოვლენების შეუსაბამობა (vs ტრეკერის ოპერატორი) დღის განმავლობაში.
ადგილზე მიტანის შეფერხება და საათების „წარუმატებლობა“.

SLA (მაგალითი):

პოსტბეკების მიღების ხელმისაწვდომობა 99 ევროა. 5 %/თვე.
DWH- ში ჩაწერამდე საშუალო შეფერხება 60 წამია; p95 API პასუხი 500 ms.
მონაცემთა რასინქრონი> 3% - ნედლეული ლოგების სავალდებულო შერწყმა 5 სამუშაო დღის განმავლობაში.

12) ჩეკის ფურცლები

12. 1. ჩეკი გაშვებამდე

რედაქტორი click _ id და ლოგოების წარმოქმნით.
პოსტბეკების Endpoint: TLS, HMAC, JWT, IP allow list, idempotence.
დაფიქსირებულია payload სქემები და ველების კანონიკური რიგი.
რიგები + DLQ, რეტრაები, შეცდომები/შეფერხებები.
UTC დრო, ISO ვალუტა, წესები FTD/Refund/Chargeback.
Grogons in sandbox, საცნობარო ლოგოების ფიქსაციით.

12. 2. ოპერაციული ჩეკი (ყოველ კვირას)

„ოპერატორის - ტრეკერის“ შერწყმა მოვლენების და თანხების თვალსაზრისით.
დუბლიკატების და „დაკარგული“ მოვლენების ანალიზი; Retrai- ს აუდიტი.
გასაღებების/ნიშნების შემოწმება, სიცოცხლის ხანგრძლივობა და როტაცია.
ინციდენტების ყურება და წესების კორექტირება.

13) ხშირი შეცდომები და როგორ მოვერიდოთ მათ

1. არ არსებობს idempotence - FTD დუბლირების დროს. შეიყვანეთ 'event _ id' და საცავი „seen“.

2. სხვადასხვა დროის ზონებმა „ბანაობა“ D0/D1. - ყოველთვის UTC ღონისძიების ჟურნალში.

3. სიმებიანი თანხები/მძიმეა პარსინგის შეცდომები.) გადასცეს ნომრები წერტილებით და ISO ვალუტით.

4. JSON- ის „ნედლეულის“ ხელმოწერა იშლება კლავიშების შეკვეთით.

5. არ არსებობს DLQ/retrais - მიკრობების დროს მოვლენების დაკარგვა.

6. სუსტი ავთენტიფიკაცია - ყალბი პოსტბეკები. HMAC + JWT + mTLS/IP სია.

7. FTD- ს წესების არარსებობა არის დავა ბილინგის შესახებ. - განსაზღვრეთ ხელშეკრულებაში.

14) კითხვებისა და პასუხების მაგალითები

14. 1. POST/postback (ოპერატორი - ტრეკერი)


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" }

პასუხი:


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

ხელახალი გაგზავნა იგივე 'event _ id':


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

14. 2. ხელმოწერის შეცდომა


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

15) ინციდენტები და ანალიზი

სიმპტომი: ოპერატორს FTD = 120, თქვენ გაქვთ 117.

გეგმა:

1. დროის დიაპაზონის (UTC) და ვალუტების შერწყმა.

2. უმი ლოგოების გადმოტვირთვა 'event _ id '/' click _ id' მიხედვით.

3. ხელმოწერის გამო უარყოფილი ძებნა/TTL ნიშანი/idempotence.

4. DLQ- დან „ჩარჩო“ მოვლენების დამატებითი მიტანა, შერიგების აქტები.

16) 30-60-90 განხორციელების გეგმა

0-30 დღე - MVP მიკროსქემის

რედაქტორის გაშვება 'click _ id' და ლოგოებით.

პოსტბეკების მიღების განხორციელება: HMAC, JWT, პირადობის მოწმობა, რიგები, DLQ, ალერტები.

აიღეთ sandbox, გადაიტანეთ reg/FTD სცენარი ტესტის თანხებით.

განსაზღვრეთ სქემები და ველების კანონიზაცია.

31-60 დღე - ხარისხი და მასშტაბები

ჩართეთ ფულადი მოვლენები და ორმაგი ვალუტის აღრიცხვა (txn & ანგარიში).

დააკონტროლეთ p95 ლატენტობა, განსხვავებები და ჭიდაობა.

ხელი მოაწერეთ SLA/ინციდენტის პროცედურებს; დაამატეთ chargeback/refund მოვლენები.

BI- ში შეაგროვეთ ფანჯრები: კოჰორტები FTD, Payback, D7/D30 ARPU.

61-90 დღე - სტაბილურობა და აუდიტი

შემოიღეთ საიდუმლოების/სერთიფიკატების როტაცია, საწინააღმდეგო წინააღმდეგობის ტესტები.

ჩაატარეთ დატვირთული ტესტები და „გადაუდებელი სავარჯიშოები“ (ხაზის დაკარგვა/BD).

FTD სქემების შერიგებისა და კვარტალური აუდიტის ფორმირება.

17) შედეგი

S2S ტრეკინგი არის გულწრფელი ატრიბუტისა და ბილინგის „ქედი“: click _ id, როგორც პირველადი გასაღები, დაცული პოსტბეკები, idempotence, retray და დროის/ვალუტის მკაცრი ჰიგიენა. ამას დაამატეთ FTD- ის შესაბამისობის გამჭვირვალე წესები, chargeback მოვლენები და სექსუალურ მონიტორინგი - და მიიღებთ საიმედო სისტემას, სადაც თითოეული კონვერტაცია დადასტურებულია სერვერის მიერ და თანხვედრა ანგარიშებში ცენტრამდე.