Ako upozorniť externé API, keď sa v Post Affiliate Pro spustí výkonová odmena

Definícia problému

Manažéri affiliate programov často potrebujú, aby Post Affiliate Pro automaticky upozornil externé systémy—napríklad API, CRM alebo vlastné aplikácie—keď sa spustí konkrétne pravidlo výkonovej odmeny (napríklad, keď affiliate získa určitý počet subaffiliate partnerov alebo dosiahne predajný míľnik). Post Affiliate Pro však neponúka vstavanú funkciu na priame volanie externého API z pravidla výkonovej odmeny.

Na preklenutie tejto medzery je možné implementovať niekoľko flexibilných riešení, ktoré umožnia automatizáciu a externé notifikácie s minimálnym zásahom do vašich affiliate procesov.

Použitie skrytého profilového poľa a Affiliate Profile Change Webhook (odporúčané a neviditeľné pre affiliate partnerov)

1. Aktualizujte skryté profilové pole cez výkonovú odmenu:

   • V sekcii „Akcie“ vášho pravidla výkonovej odmeny vyberte “Aktualizovať používateľa” a zvoľte profilové pole na aktualizáciu.
   • Nastavte toto profilové pole ako Skryté v nastaveniach affiliate profilu, aby nebolo viditeľné pre affiliate partnerov a slúžilo iba na internú automatizáciu.

2. Nastavte plugin Affiliate Profile Change Webhook:

   • Nainštalujte a nakonfigurujte plugin Affiliate Profile Change Webhook .
   • Nastavte ho na sledovanie skrytého profilového poľa, ktoré aktualizujete.
   • Pri zmene tohto poľa plugin odošle webhook (HTTP POST) s detailmi affiliate partnera na vaše externé API.

Tento prístup zabezpečí, že informácie dostane len váš systém a affiliate partneri o existencii alebo zmene poľa nevedia.

Riešenie 1: Použitie akcie “Odoslať email na” a pluginu Emails Callback Webhook

1. Duplikujte pravidlo výkonovej odmeny:

   • Vytvorte duplikát pôvodného pravidla s rovnakými podmienkami.
   • V akcii zvoľte “odoslať email na” a nastavte odoslanie emailu obchodníkovi.

2. Nastavte plugin Emails Callback Webhook:

   • Nainštalujte a nakonfigurujte plugin Emails Callback Webhook .
   • Tento plugin spracováva všetky odchádzajúce emaily a preposiela ich ako HTTP požiadavky na váš externý endpoint.

3. Detekujte a spracujte notifikáciu:

   • Váš externý systém môže filtrovať konkrétne emaily odoslané pravidlom výkonovej odmeny a spúšťať podľa nich ďalšie workflowy.

Táto metóda je jednoduchá a využíva existujúcu emailovú infraštruktúru na notifikácie.

Riešenie 2: Použitie $0 akčnej provízie, General Callback URL a Application Callbacks

1. Duplikujte pravidlo výkonovej odmeny:

   • Duplikujte vaše pravidlo výkonovej odmeny ako v predchádzajúcom prípade, ale zmeňte akciu na “pridať bonus za akčnú províziu” a vyberte $0 akčnú províziu (pozri Akčné provízie ).

2. General Callback URL (všetky účty):

   • Choďte do Konfigurácia > Nastavenia sledovania > Callback tracking.
   • Nastavte General Callback URL , aby ste dostávali notifikácie o každej zaznamenanej provízii (predaj alebo akcia).
   • Na vašom endpoint-e spracovávajte len konkrétne $0 akčné provízie spustené vaším pravidlom výkonovej odmeny.

3. Application Callbacks (iba plány Ultimate/Network):

   • Choďte do Konfigurácia > Callbacks a použite možnosť “Pridať spätné volanie na sledovanie predaja”.
   • Vyberte vašu $0 akčnú províziu v poli “Typ provízie” a zadajte URL vášho endpointu.
   • Takto zabezpečíte, že spätné volanie sa spustí len pri vybranom type provízie.

4. Potlačte emailové notifikácie pre affiliate partnerov pri $0 províziách:

   • Štandardne affiliate partneri uvidia tieto $0 akčné provízie vo svojom paneli.
   • Ak im chcete zabrániť v prijímaní emailových notifikácií, choďte do Konfigurácia > E-mailové notifikácie > Affiliate notifikácie a zaškrtnite “Predvolená hodnota pre affiliate” pri možnosti “Zakázať notifikácie o nulových províziách Pri predaji / lead-e”.

Poznámka: Hlavnou nevýhodou tohto riešenia je, že affiliate partneri stále uvidia tieto $0 provízie vo svojom rozhraní (ale nie cez email, ak sú notifikácie vypnuté).

Najlepšie praktiky pre automatizáciu a API notifikácie v Post Affiliate Pro

• Používajte dedikované alebo skryté polia ako spúšťače automatizácie, aby ste predišli nejasnostiam alebo nechceným zmenám.
• Jasne dokumentujte všetky automatizačné workflowy a ktoré polia alebo pluginy používajú na notifikácie.
• Zabezpečte vaše webhook a callback endpointy, aby prijímali len dôveryhodné požiadavky.
• Každé riešenie dôkladne otestujte, aby ste sa uistili, že notifikácie sú doručované podľa očakávania.
• Pravidelne kontrolujte nastavenia výkonových odmien, pluginov a kampaní pre zachovanie spoľahlivosti.

Čo sú výkonové odmeny v Post Affiliate Pro?

Výkonové odmeny sú silné pravidlá, ktoré automaticky udeľujú bonusy, aktualizujú profily affiliate partnerov alebo spúšťajú vlastné akcie, keď affiliate partneri dosiahnu špecifické míľniky, ako je určitý počet predajov, odporúčaní alebo iných sledovaných aktivít. Akcie môžu zahŕňať udeľovanie bonusov, zmenu skupiny provízií, odosielanie notifikácií alebo aktualizáciu (vrátane skrytých) profilových polí.

Ako nastaviť a vybrať najvhodnejšie riešenie

• Pre neviditeľné, interné notifikácie: Použite skryté profilové pole a Affiliate Profile Change Webhook.
• Pre spracovanie cez email: Použite akciu “odoslať email na” s pluginom Emails Callback Webhook.
• Pre notifikácie na základe provízie: Použite $0 akčnú províziu s General Callback URL alebo Application Callbacks, s vedomím, že affiliate partneri ich uvidia v paneli.

Návod krok za krokom: Príklad skrytého profilového poľa + webhook

1. Prejdite do Konfigurácia > Výkonové odmeny.
2. Upravte alebo vytvorte pravidlo a v akciách vyberte “Aktualizovať používateľa”.
3. Vyberte (alebo vytvorte) profilové pole a nastavte ho ako Skryté.
4. Nastavte hodnotu, ktorú chcete použiť na spustenie workflowu.
5. Nainštalujte a nakonfigurujte plugin Affiliate Profile Change Webhook na sledovanie tohto poľa.
6. Zadajte váš externý API endpoint do nastavení pluginu.
7. Otestujte workflow splnením podmienok výkonovej odmeny a overte, že webhook sa spustil.

Návod krok za krokom: Príklad $0 akčnej provízie + General Callback URL

1. Duplikujte vaše pravidlo výkonovej odmeny, nastavte akciu na “pridať bonus za akčnú províziu” a vyberte typ provízie $0.
2. Nastavte General Callback URL v Konfigurácia > Nastavenia sledovania > Callback tracking.
3. Na vašom endpoint-e filtrujte prichádzajúce callbacky pre váš konkrétny typ $0 provízie.
4. Voliteľne vypnite affiliate notifikačné emaily pre nulové provízie.
5. Otestujte spustením odmeny a overením callbacku a správania endpointu.

Zhrnutie

Post Affiliate Pro neposkytuje priamu API notifikáciu z pravidiel výkonových odmien, no s týmito overenými riešeniami—skryté profilové pole plus webhook, emailový callback alebo $0 akčná provízia so spätným volaním—môžete spoľahlivo automatizovať externé notifikácie a integrácie podľa vašich potrieb v affiliate správe.