S2S Postback: Edistynyt affiliate-asetus HMAC-SHA256:lla

Doğa johtaa performance-markkinointitoimistoa Şişlissä Istanbulissa ja ohjaa affiliateina 38 ravintolaa thMenuun. Siirryttyään manuaalisesta raportoinnista S2S postbackiin hänen ROI nousi 220 %, koska jokainen komissio-tapahtuma virtaa nyt automaattisesti hänen attribuutioalustaansa.

Miksi S2S Postback

S2S postback on suora, selaimeton tietosilta trackingpalvelimesi ja thMenu-komissiomoottorin välillä. Toisin kuin pikseli, se kestää evästetappiot, mainoseston ja Applen ITP:n. Doğa tuottaa 1 200+ tapahtumaa kuukaudessa.

thMenu Phase 3 lähettää jokaisesta tapahtumasta — created, refunded, released — POSTin rekisteröityyn URL:iin. Payload allekirjoitetaan HMAC-SHA256:lla otsikossa X-thMenu-Signature.

Dashboard-asetus

Kolme askelta Settings → Postback:

1. Liitä endpoint kenttään Postback URL (HTTPS pakollinen). 2. Aktivoi Enabled; järjestelmä luo 64-merkkisen secretin. 3. Kopioi secret vain kerran — päivityksen jälkeen sitä ei näytetä uudelleen.

Doğa tallentaa secretin Vercel-ympäristömuuttujaksi THMENU_POSTBACK_SECRET. Endpoint todentaa allekirjoituksen, kirjoittaa Postgresiin ja palauttaa 401 jos epäkelpo.

Payload ja uudelleenyritykset

JSON-payload sisältää event_type, affiliate_id, commission_id, amount_cents, currency, timestamp ja idempotency_key duplikaatteja vastaan.

Virheissä thMenu yrittää 5 kertaa eksponentiaalisella backoffilla (1m, 5m, 30m, 2h, 12h), sitten "dead"-merkintä ja super-admin-hälytys.

FAQ

Miten varmistan allekirjoituksen? Laske HMAC-SHA256 raakapyynnön rungosta secretillä ja vertaa timing-safe-otsikkoon.

Jos kadotan secretin? Sammuta ja käynnistä postback uudelleen — uusi secret luodaan välittömästi.

Mitkä tierit? Kaikki aktiiviset affiliatet ilman tier-rajoitusta.

Oliko tästä hyötyä? Jaa se.