Mik azok az alkalmazás visszahívások a Post Affiliate Pro-ban?
Ismerje meg, hogyan működnek az alkalmazás visszahívások a Post Affiliate Pro-ban. Fedezze fel a testreszabható eseményindítókat az eladásokhoz, leadekhez és pa...
7 perc olvasás
Elérhető:
Post Affiliate Pro , Post Affiliate Pro Ultimate , Post Affiliate Network
Mik azok a webhookok és visszahívások?
A webhookok (más néven alkalmazás visszahívások vagy Postback URL-ek) automatizált HTTP értesítések, amelyeket a Post Affiliate Pro küld külső rendszereknek, amikor meghatározott események történnek. A folyamatos frissítéslekérdezés helyett a csatlakoztatott rendszerek azonnali értesítéseket kapnak abban a pillanatban, amikor valami történik a partnerprogramjában.
Ez a funkció elengedhetetlen:
- CRM integráció - Automatikusan frissítse az ügyfél adatbázisát, amikor eladások történnek
- E-mail automatizálás - Váltson ki e-mail sorozatokat partner műveletek alapján
- Könyvelési rendszerek - Szinkronizálja a tranzakciós adatokat a pénzügyi szoftverével
- Egyedi műszerfalak - Építsen valós idejű jelentési műszerfalakat
- Harmadik fél követés - Értesítse a külső követési platformokat a konverziókról
Webhook típusok
A Post Affiliate Pro két fő webhook típust támogat:
Eladás követési webhookok
Ezeket a webhookokat tranzakcióval kapcsolatos események váltják ki:
| Kiváltó esemény | Leírás |
|---|---|
| Létrehozáskor | Azonnal aktiválódik, amikor új tranzakció (eladás, művelet, lead) rögzítésre kerül |
| Jóváhagyáskor | Aktiválódik, amikor egy függőben lévő tranzakció jóváhagyásra kerül |
| Elutasításkor | Aktiválódik, amikor egy tranzakció elutasításra kerül |
| Visszatérítéskor/Visszaterheléskor | Aktiválódik, amikor visszatérítés vagy visszaterhelés feldolgozásra kerül |
Konfigurálhat egyetlen webhookot, amely több eseménynél aktiválódik, vagy létrehozhat külön webhookokat minden eseménytípushoz.
Partner feliratkozási webhookok
Ezeket a webhookokat partner regisztrációs események váltják ki:
| Kiváltó esemény | Leírás |
|---|---|
| Regisztrációkor | Azonnal aktiválódik, amikor új partner befejezi a feliratkozási űrlapot |
| Jóváhagyáskor | Aktiválódik, amikor egy függőben lévő partnert a kereskedő jóváhagy |
Kérés típusok
A Post Affiliate Pro három HTTP kéréstípust támogat webhookhoz:
GET kérés
A paraméterek lekérdezési karakterlánc paraméterekként kerülnek hozzáfűzésre az URL-hez.
https://az-on-rendszere.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456
POST kérés (Form-Urlencoded)
A paraméterek a kérés törzsében kerülnek elküldésre standard űrlap kódolással.
Content-Type: application/x-www-form-urlencoded
transactionid=abc123&commission=50.00&orderid=ORD-456
POST JSON kérés
A paraméterek JSON objektumként kerülnek elküldésre a kérés törzsében.
Content-Type: application/json
{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}
Elérhető változók eladási webhookhoz
Dinamikus változókat használhat a webhook URL-ekben, amelyek automatikusan tényleges értékekre cserélődnek. Használja a ${#valtozonev#} formátumot a változó befoglalásához.
Tranzakciós adatok
| Változó | Leírás |
|---|---|
${#transactionid#} | Egyedi tranzakció azonosító |
${#visitorid#} | Látogató azonosító (követési süti) |
${#commission#} | Jutalék összeg |
${#totalcost#} | Teljes rendelési érték |
${#fixedcost#} | Fix költség összeg |
${#orderid#} | Rendelés azonosító az e-kereskedelmi rendszeréből |
${#productid#} | Termékazonosító |
${#dateinserted#} | A tranzakció létrehozásának dátuma és időpontja |
${#dateapproved#} | A tranzakció jóváhagyásának dátuma és időpontja |
${#tier#} | Jutalék szint |
${#status#} | Tranzakció státusz (Jóváhagyott, Függőben, Elutasított) |
${#statuscode#} | Státuszkód (A, P, D) |
${#type#} | Tranzakció típus (Eladás, Művelet, stb.) |
Kampány és banner adatok
| Változó | Leírás |
|---|---|
${#campaignid#} | Kampány azonosító |
${#campaignname#} | Kampány neve |
${#bannerid#} | Banner azonosító |
${#channel#} | Csatorna neve |
${#channel_code#} | Csatornakód |
${#coupon_code#} | Használt kuponkód |
Partner adatok
| Változó | Leírás |
|---|---|
${#userid#} | Partner felhasználói azonosító |
${#refid#} | Partner ajánló azonosító |
Kattintás adatok
| Változó | Leírás |
|---|---|
${#firstclicktime#} | Első kattintás időbélyege |
${#firstclickreferer#} | Első kattintás hivatkozó URL |
${#firstclickip#} | Első kattintás IP cím |
${#firstclickdata1#} | Első kattintás egyedi adat 1 |
${#firstclickdata2#} | Első kattintás egyedi adat 2 |
${#lastclicktime#} | Utolsó kattintás időbélyege |
${#lastclickreferer#} | Utolsó kattintás hivatkozó URL |
${#lastclickip#} | Utolsó kattintás IP cím |
${#lastclickdata1#} | Utolsó kattintás egyedi adat 1 |
${#lastclickdata2#} | Utolsó kattintás egyedi adat 2 |
Egyedi tranzakciós adatok
| Változó | Leírás |
|---|---|
${#saledata1#} | Tranzakció egyedi adatmező 1 |
${#saledata2#} | Tranzakció egyedi adatmező 2 |
${#saledata3#} | Tranzakció egyedi adatmező 3 |
${#saledata4#} | Tranzakció egyedi adatmező 4 |
${#saledata5#} | Tranzakció egyedi adatmező 5 |
Földrajzi és technikai adatok
| Változó | Leírás |
|---|---|
${#ip#} | Az ügyfél IP címe |
${#countrycode#} | Országkód IP alapján |
${#refererurl#} | Hivatkozó URL |
Pénznem adatok
| Változó | Leírás |
|---|---|
${#originalcurrency#} | Eredeti pénznem neve |
${#originalcurrencyvalue#} | Eredeti pénznem értéke |
${#originalcurrencyrate#} | Használt átváltási árfolyam |
Megjegyzések
| Változó | Leírás |
|---|---|
${#merchantnote#} | Partner számára látható megjegyzés |
${#systemnote#} | Csak kereskedő számára látható megjegyzés |
${#actionName#} | Művelet jutaléktípus neve |
${#actionCode#} | Művelet jutaléktípus kódja |
Elérhető változók feliratkozási webhookhoz
Partner feliratkozási webhookhoz partner profil változókat használhat:
| Változó | Leírás |
|---|---|
${#username#} | Partner e-mail/felhasználónév |
${#firstname#} | Partner keresztneve |
${#lastname#} | Partner vezetékneve |
${#name#} | Teljes név (kereszt + vezeték) |
${#userId#} | Partner felhasználói azonosító |
| Egyedi mezők | Bármely egyedi profil mező a kódja alapján |
Többszintű támogatás
Alapértelmezés szerint a webhookok csak az 1. szintű (közvetlen) jutalékokhoz hajtódnak végre. Engedélyezheti az “Végrehajtás minden szinthez” opciót, hogy a webhookok minden szinten aktiválódjanak többszintű jutalékstruktúrákban.
Ez hasznos, amikor:
- Nyomon kell követnie a jutalékokat a partner hierarchia minden szintjén
- A külső rendszernek tudnia kell az al-partner bevételekről
- Átfogó jelentéseket épít, amelyek minden jutalékszintet tartalmaznak
Webhook szűrési beállítások
Konfigurálhatja a webhookokat, hogy specifikusabbak legyenek:
Jutaléktípus szerint
Korlátozza a webhookot egy adott jutaléktípusra (pl. csak “Prémium eladások” művelet jutalékokhoz).
Partner szerint
Hozzon létre webhookokat, amelyek csak egy adott partnerhez aktiválódnak. Ez hasznos:
- Saját követési rendszert használó partnerekhez
- Speciális integrációk a legjobban teljesítő partnerekhez
- Webhookok tesztelése egyetlen partnerrel a bevezetés előtt
Fiók szerint (Hálózat mód)
Post Affiliate Networkben fiók-specifikus webhookokat hozhat létre.
Webhook napló és megfigyelés
A Post Affiliate Pro átfogó naplót vezet minden webhook végrehajtásról, amely elérhető a kereskedői panelben az Eszközök > Visszahívások napló alatt.
A napló mutatja:
- Napló azonosító - Egyedi azonosító minden webhook végrehajtáshoz
- Visszahívás azonosító - Melyik webhook konfiguráció került használatra
- Kérés URL - A teljes URL, amelyet meghívtak (változókkal helyettesítve)
- Létrehozás dátuma - Mikor került a webhook sorba
- Utolsó újrapróbálkozás - Mikor történt az utolsó végrehajtási kísérlet
- Újrapróbálkozások száma - Hányszor kísérelte meg a rendszer a végrehajtást
- Státusz - Függőben, Elküldve vagy Hiba
- Hibaüzenet - Részletek, ha a webhook sikertelen volt
Automatikus újrapróbálkozás
Ha egy webhook sikertelen (pl. a szervere átmenetileg nem elérhető), a Post Affiliate Pro automatikusan újrapróbálja a kérést. Ez biztosítja a megbízható kézbesítést még átmeneti kimaradások esetén is.
Napló megőrzés
A webhook naplók automatikusan törlődnek konfigurálható számú nap után (alapértelmezett: 60 nap). Ezt módosíthatja a Konfiguráció > Funkciók > Alkalmazás visszahívások menüpontban.
Webhook kezelés
Jóváhagyási munkafolyamat
Alapértelmezés szerint a partnerek által létrehozott webhookok kereskedői jóváhagyást igényelnek, mielőtt aktívvá válnának. A kereskedők:
- Engedélyezhetik az automatikus jóváhagyást - Automatikusan jóváhagynak minden új webhookot
- Manuálisan tekinthetik át - Egyenként hagynak jóvá vagy utasítanak el minden webhookot
Státusz kezelés
A webhooknak három lehetséges státusza lehet:
- Jóváhagyott - Aktív és végrehajtásra kerül, ha aktiválódik
- Függőben - Kereskedői jóváhagyásra vár
- Elutasított - Visszautasított és nem kerül végrehajtásra
A kereskedők bármikor módosíthatják a webhook státuszt a webhookok kezelési képernyőről.
E-mail értesítések
A Post Affiliate Pro e-mail értesítéseket küldhet webhook-kapcsolatos eseményekről:
Kereskedő értesítések
- Partner által létrehozott új webhook
Partner értesítések (opcionális)
- Webhook státusz megváltozott (jóváhagyva/elutasítva)
- Webhook kereskedő által módosítva
- Webhook kereskedő által törölve
Ezek az értesítések engedélyezhetők vagy letilthatók a Konfiguráció > E-mail értesítések menüpontban.
Példa felhasználási esetek
1. CRM integráció
Új eladás adatok küldése a CRM-jébe, amikor egy tranzakció jóváhagyásra kerül:
https://crm.pelda.com/api/sales?customer_order=${#orderid#}&value=${#totalcost#}&affiliate=${#refid#}
2. Slack értesítés
Csapatcsatorna értesítése, amikor új partner regisztrál:
https://hooks.slack.com/services/xxx/yyy?text=Uj+partner:+${#firstname#}+${#lastname#}
3. E-mail platform trigger
Ügyfelek hozzáadása e-mail sorozathoz vásárlás után:
POST https://email.pelda.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}
4. Könyvelési szoftver szinkronizálás
Jutalék kifizetések rögzítése a könyvelési rendszerben:
https://konyveles.pelda.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}
Hogyan állítsunk be webhookot
- Jelentkezzen be a kereskedői panelbe
- Navigáljon a Konfiguráció > Funkciók menüpontra
- Aktiválja az Alkalmazás visszahívások funkciót
- Lépjen a Kampányok > [Kampány kiválasztása] > Visszahívások vagy a globális visszahívások kezelőbe
- Kattintson az Új visszahívás hozzáadása gombra
- Konfigurálja:
- Név - Leíró név a webhooknak
- Típus - Eladás követés vagy Partner feliratkozás
- Végrehajtás - Mikor aktiválódjon (létrehozáskor, jóváhagyáskor, elutasításkor, visszatérítéskor)
- Kérés típus - GET, POST vagy POST JSON
- URL - A végpontja változókkal
- Végrehajtás minden szinthez - Igen/Nem
- Mentse a webhookot
Biztonsági szempontok
- Használjon HTTPS végpontokat a biztonságos adatátvitelhez
- Fontolja meg titkos paraméter hozzáadását a webhook forrás ellenőrzéséhez
- Implementáljon sebességkorlátozást a fogadó végpontján
- Validálja a bejövő adatokat feldolgozás előtt
- Tartsa meg a webhook naplókat auditálási célokra
Kapcsolódó funkciók
- S2S követés - Szerver-szerver követés pontos konverziókhoz
- API - Teljes programozási hozzáférés a Post Affiliate Pro-hoz
- API v3 - Modern RESTful API OAuth 2.0-val
