Şahamça ulgamy we traffigi

1) Hyzmatdaşlygyň rollary we modelleri

Affiliates: webmasterler, media-baerler, mazmun saýtlary, täsir edijiler, programmalar, agregatorlar.
Tor dolandyryjysy (platforma): düzgünler, döredijilik, yzarlamak, PRM, tölegler.

• CPA - tassyklanan hereket üçin töleg (hasaba alyş/goýum/satyn almak).
• CPL - kwalifikasiýa bilen lid (form/anketa) üçin töleg.
• RevShare - marjanyň/girdejiniň% -i (köplenç uzyn guýruk).
• Hybrid — CPA + RevShare; käwagt iň az kepillikler bilen.
• Maliýe parametrleri: hold/validasiýa penjiresi, clawback (frod/refand), caps (gündelik/hepdelik çäkler), töleg zolaklary.

2) Treking we atributlaryň arhitekturasy

2. 1 Waka modeli

Esasy ädimler: 'click → visit → signup → qualify → target_action (e. g., FT, purchase) → retention events`.

json
{
"event_id": "uuid",
"occurred_at_utc": "2025-10-31T12:45:10Z",
"type": "affiliate.target_action.v1",
"affiliate_id": "aff_001",
"campaign_id": "cmp_42",
"click_id": "c_abc123",
"user_pseudo_id": "u_... (hashed)",
"amount": 49.90,
"currency": "EUR",
"status": "qualified",
"signature": "base64/Ed25519",
"version": 1
}

2. 2 Atributiýa

Penjire: 7-30 gün (ýa-da rugsat berilse 24-72 sagat).
Model: last-click köplenç; uly torlar üçin data-driven rugsat berilýär.
Kanallaryň ileri tutulmagy: tölegli/marka/organika - ileri tutulýan matrisa bilen düzetmek.
De-duplikasiýa: 'event _ id '/' click _ id' + sessiýanyň yzy, serwer otagy (S2S).

2. 3 S2S postbackler we c2s-wakalar

S2S postback: maksatly hereketi düzetmek üçin serwer-k-serwer (ygtybarlylyk, gizlinlik).
c2s-akym: Müşderi wakalary → Siziň arkaňyz → kadalaşmak → Hyzmatdaşyňyza (gol çekildi).
Idempotentlik: idempotentlik açary = 'affiliate _ id + click_id + action_type'.

POST https://aff.example/postback
Headers:
X-Signature: ed25519:...
X-Timestamp: 1730388405
Body:
click_id=c_abc123&status=qualified&amount=49.90&currency=EUR&event_id=uuid

3) Antifrod we hil gözegçiligi

Wektorlar: botlar, incentivized/pes hilli traffik, kukiler stuffing, ugrukdyryjy çalyşmak, proksi/emulýatorlar, hasaba alyş "fermalary".

• Alamatlar we abraý: device signals, ASN/proksi-listler, velocity-çek, özüni alyp baryş metrikleri (dwell time, scroll, focus).
• Quality score (q-score): композит `q = w1cohort_retention + w2FT_rate + w3refund_rate^-1 + w4fraud_signals^-1`.
• Çäklendirmeler we gaplar: barlagdan geçýänçä "tizlenmek"; partlamalarda awtomatiki berkitmek.
• Gijikdirilen kwalifikasiýa (cool-off): N işjeňlik günlerinden soň CPA-ny tassyklamak/chargebacksiz.
• Honey-tokens: parserleri we klik botlaryny tapmak üçin/SDK lendinglerinde "duzaklar".
• Razylyk we gizlinlik: cookie bannerleri/CMPl, 3rd-party cookie-siz re modeim → S2S ünsi jemleýär.

4) Döredijilik, lending we UX

Döredijilik katalogy: wersiýalar/lokalizasiýa, marka düzgünleri, UTM parametrleri, deeplink şablonlary.
Lendingler: fast TTV (ýönekeý görnüş, sosial giriş), A/B synaglary, geo/enjam mazmuny.
Syýasatçylar: gadagan edilen dik/sözler, ýaş çäklendirmeleri baradaky bellikler, ýalňyş döredijilik üçin jogapkärçilik.
Tizligi: LCP <2. 5s; p95 landing taýmingleri - affiliat üçin SLO-nyň bir bölegi.

5) PRM-prosesleri (Partner Relationship Management)

5. 1 Onbording

Anketa, KUS/sanksiýalar, traffigiň, domenleriň/programmalaryň çeşmelerini tassyklamak.
Ylalaşyklar: MSA/IO, mazmun syýasaty, DPA (eger PD bar bolsa), atributiýa düzgünleri.
Tehniki başlangyç: API açarlary, sandyk gutusy, postback synag haltalary.

5. 2 Amallar

QBR/MBR (review), maksatlar we kaplar, döredijilik kitaphanasy, sapport biletleri.
Kampaniýalardaky üýtgeşmeler: wersiýalar, kanar uçuşlary, freeze-döwürler uly neşirlerde.
Sanksiýalar/blokirlemek: frod bosagasy → awto-pause, derňew, hasabatlar.

5. 3 Çykmak/üýtgetmek

Açarlary aýlamak/bellikleri yzyna almak, kampaniýalary ýapmak, hasabatlary düşürmek, jemleýji hasaplamalar.

6) Metrika we analitika

• CR (visit→signup, signup→action)
• ARPU/LTV affiliates/kampaniýalar/geo eCPA/eCPL/eROAS
• FT rate / Repeat rate / Retention w4/w8
• Refund/Chargeback rate, Clawback%
• q-score çeşmesine görä, "ýylylyk kartoçkalary"

utm_source=aff_network&utm_medium=cpa&utm_campaign=cmp_42&utm_content=ban_01&utm_term=kw aff_id=aff_001&click_id=c_abc123&geo=TR&lang=tr

sql
SELECT cohort_week,
aff_id,
COUNT(DISTINCT user_id) AS users,
SUM(first_deposit_amount) AS gmv,
SUM(margin) AS net_rev,
SUM(payout) AS payout,
SUM(margin) - SUM(payout) AS contrib
FROM fact_users
GROUP BY 1,2;

7) Hasaplaşyklar, reconciliation we tölegler

7. 1 Hasaplaşyk kadalary

Töleg binýady: net-basis (komissiýalardan/salgytlardan/bonuslardan soň) ýa-da gross - aýdyň görkeziň.
Penjireler: T + N (günler/hepdeler), walýutalar, konwersiýa hümmeti, invoice/credit note.
Clawback: penjiräniň içinde frod/charjbacklerde öçürmek.

7. 2 Reconciliation

Iki taraplaýyn hasabatlar (siziň faktyňyz vs affiliat hasabaty), ε rugsat, "event _ id" boýunça dedup.
SLA gapma-garşylyklary ýapmak (mysal üçin, 5 iş gününden ≤), teswirler magazineurnaly.

sql
SELECT a.event_id
FROM partner_report a
LEFT JOIN internal_events b ON a.event_id = b.event_id
WHERE a.date BETWEEN:from AND:to
AND b.event_id IS NULL;

8) Kod hökmünde syýasatlar (gate's)

rego package affiliate.policies

deny["Weak signature"] {
input.webhook.signature.alg not in {"HMAC-SHA256","Ed25519"}
}

deny["No attribution window"] {
not input.campaign.attribution.window_days
}

deny["Fraud spike"] {
input.metrics.fraud_rate > 0.7 input.metrics.signup_to_action_cr < 0.05
}

deny["PII in logs"] {
some f f:= input.logs[_]
contains(f, "ssn") # пример
}

9) Gabat gelmek we gizlinlik

Aç-açanlyk: mahabat materiallary üçin disclosure, ýaş çäkleri, ýerli mahabat kadalary.
Gizlinlik: hyzmatdaşlara berlen maglumatlary minimallaşdyrmak (lakamlary, agregatlary), aýyrmak hukugy, TTL.
Hukuk ugurlary: geo-targeting, çäklendirmeleri bolan sebitlerden traffigi gadagan etmek, rugsat berilýän ýerlerde saklamak.
Anti-zorlamak: "zäherli" täsirleri (ýalňyş) gadagan etmek.
Giriş žurnallary: kim haýsy maglumatlary, audit hasabatlaryny gördi.

10) Şablonlar we mysallar

10. 1 Affiliate pasport (YAML)

yaml affiliate_id: "aff_001"
name: "Acme Media"
regions: ["EU","TR","LATAM"]
traffic_sources: ["SEO","Content","Push"]
contracts:
model: "Hybrid"
cpa: 60 revshare: "20% of net"
hold_days: 14 attribution:
window_days: 30 priority_matrix: ["affiliate>paid>brand>organic"]
tech:
postback_url: "https://acme.example/postback"
signature: "Ed25519"
test_click_id: "TEST123"
policies:
caps: { daily: 200, weekly: 1000 }
banned_keywords: ["free money", "no risk"]
quality:
min_q_score: 0.6 cool_off_days: 7 status: "active"
owner: "aff-team-emea"

10. 2 Postback walidator (psevdokod)

python def verify_postback(req, key):
ts = int(req.h["X-Timestamp"])
if abs(now()-ts) > 300: return 401 if not ed25519_ok(req.body, req.h["X-Signature"], key): return 401 if seen(req.form["event_id"]): return 200 save_event(req.form); mark_seen(req.form["event_id"]); return 200

10. 3 Formula q-score (mysal)

python q = 0.35retention_w4 + 0.25ft_rate + 0.2(1-refund_rate) + 0.2(1-fraud_score)

10. 4 De-duplikasiýa düzgünleri

dedupe_key = SHA256(affiliate_id    click_id    action_type    user_pseudo_id    date)

11) Anti-patternler

Diňe S2S → atributy ýitirmezden cookie-treking.
Hil gözegçiligi bolmazdan "körler" CPA/retention → býudjetiň tükenmegi.
hold/cool-off → artykmaç tölegler we jedeller.
Hasaplamalarda gross/net garyşyk → baky gapma-garşylyklar.
Ýeke-täk aşa uly affiliat → konsentrasiýa töwekgelçiligi.
Frod → köpçülikleýin hasapdan çykarylanda awto-çäklendirmeler ýok.
PII loglarda/webhuklarda → gizlinlik töwekgelçiligi we jerimeler.

12) Arhitektoryň çek-sanawy

1. Töleg modeli, hasaplama bazasy we penjireler hasaba alyndy (hold, clawback)?
2. Gol we idempotentlik bilen S2S treking amala aşyryldymy?
3. Atributiýa penjireleri we kanallaryň ileri tutulmagy kesgitlenildi, dedup işleýärmi?
4. Antifrod signallary we q-score gurlan, kaplar we awto-pause işleýär?
5. PRM-prosesleri: onbording/KUS, döredijilik, sandyk gutusy, postbackleriň synag ýagdaýlary?
6. Daşbordlar: CR, eCPA, LTV, retention, refund/clawback, q-score?
7. Reconciliation: ikitaraplaýyn hasabatlar, ε - rugsat, jedelleriň ýapylmagy SLA?
8. CI/CD/PRM kody ýaly syýasatlar (gollar, penjireler, gadagan sanawy)?
9. Gizlinlik: iň az PD, lakamlar, TTL, aýyrmak hukugy?
10. Wakalaryň meýilnamasy: frod-spike, postbackleriň durmagy, hasabatlaryň bölünişi?

Netije

Güýçli affiliatiýa ulgamy diňe marketing däl, inženerçilik ulgamydyr. Serwer atributy aç-açan we aç-açan bolanda, traffigiň hili ölçelýär we dolandyrylýar, PRM amallary standartlaşdyrylýar we hasaplamalar subutnamalar bazasy we "syýasatlar kody" bilen tassyklanýar, kanal çak edilip bilinýär: eCPA durnukly, LTV ösýär, jedeller seýrek, hyzmatdaşlar bolsa traffigiňize höwes bilen maýa goýýarlar.