S2S Postback Haladó Affiliate Beállítás HMAC-SHA256-tal

Doğa egy performance marketing ügynökséget vezet Şişli-ben, Isztambulban, és affiliate-ként 38 éttermet visz a thMenu-hoz. A manuális riportokról S2S postback-re váltva ROI-ja 220 %-kal nőtt, mert minden jutalék-esemény automatikusan beérkezik az attribúciós platformjába.

Miért S2S Postback

Az S2S postback egy közvetlen, böngésző nélküli adatcsatorna a tracking-szervered és a thMenu jutalék-motorja között. A pixel-trackinggel ellentétben immunis a cookie-vesztésre, hirdetésblokkolókra és az Apple ITP-re. Doğa havi 1 200+ eseményt generál.

A thMenu Phase 3-ban minden esemény — created, refunded, released — POST-ot küld a regisztrált URL-re. A payload HMAC-SHA256-tal aláírt, a X-thMenu-Signature headerben.

Dashboard beállítás

Három lépés a Settings → Postback alatt:

1. Illeszd be az endpoint-ot a Postback URL mezőbe (HTTPS kötelező). 2. Kapcsold be az Enabled kapcsolót; a rendszer 64 karakteres secret-et generál. 3. Másold a secret-et egyetlen alkalommal — frissítés után nem jelenik meg újra.

Doğa Vercel környezeti változóként tárolja THMENU_POSTBACK_SECRET néven. Az endpoint ellenőrzi az aláírást, Postgres-be ír, érvénytelen esetén 401-et ad.

Payload és retry

A JSON tartalmazza: event_type, affiliate_id, commission_id, amount_cents, currency, timestamp, valamint idempotency_key a duplikáció ellen.

Hiba esetén a thMenu 5× próbál exponenciális backoff-fal (1p, 5p, 30p, 2ó, 12ó), majd "dead"-ként jelöl és super-admin riasztást küld.

FAQ

Hogyan ellenőrzöm az aláírást? Számold ki a nyers body HMAC-SHA256-ját a secret-tel, és timing-safe módon hasonlítsd a headerhez.

Mi van, ha elveszítem a secret-et? Kapcsold ki és újra be a postback-et — új secret azonnal generálódik.

Mely tier-ek? Minden aktív affiliate, tier-korlátozás nélkül.

Hasznosnak találtad? Oszd meg.