Hoe een externe API te informeren wanneer een prestatiebeloning wordt geactiveerd in Post Affiliate Pro

Probleemdefinitie

Affiliate programma managers hebben vaak de behoefte dat Post Affiliate Pro automatisch externe systemen—zoals API’s, CRM’s of maatwerkapplicaties—informeert wanneer specifieke Prestatiebeloningsregels worden geactiveerd (bijvoorbeeld wanneer een affiliate een bepaald aantal sub-affiliates werft of een verkoopdoel behaalt). Post Affiliate Pro biedt echter geen ingebouwde functie om direct vanuit een Prestatiebeloningsregel een externe API aan te roepen.

Om dit gat te dichten, kunnen er verschillende flexibele oplossingen worden geïmplementeerd om automatisering en externe meldingen te creëren met minimale verstoring van je affiliateworkflow.

Gebruik van een verborgen profielveld en Affiliate Profile Change Webhook (Aanbevolen en onzichtbaar voor affiliates)

1. Werk een verborgen profielveld bij via Prestatiebeloning:

   • Selecteer in het gedeelte “Acties” van je Prestatiebeloningsregel “Update gebruiker” en kies een profielveld om bij te werken.
   • Stel dit profielveld in als Verborgen in je affiliateprofielinstellingen, zodat het niet zichtbaar is voor affiliates en alleen wordt gebruikt voor interne automatisering.

2. Configureer de Affiliate Profile Change Webhook-plugin:

   • Installeer en configureer de Affiliate Profile Change Webhook-plugin .
   • Stel deze in om het verborgen profielveld dat je bijwerkt te monitoren.
   • Wanneer het veld verandert, stuurt de plugin een webhook (HTTP POST) met affiliategegevens naar je externe API-endpoint.

Deze aanpak zorgt ervoor dat alleen jouw systeem wordt geïnformeerd en affiliates niet op de hoogte zijn van het bestaan of de wijziging van het veld.

Oplossing 1: Gebruik van “Stuur e-mail naar”-actie en Emails Callback Webhook

1. Dupliceer de Prestatiebeloningsregel:

   • Maak een duplicaat van je oorspronkelijke Prestatiebeloningsregel met dezelfde voorwaarden.
   • Kies bij de actie “stuur e-mail naar” en stuur een e-mail naar de merchant.

2. Stel de Emails Callback Webhook-plugin in:

   • Installeer en configureer de Emails Callback Webhook-plugin .
   • Deze plugin verwerkt alle uitgaande e-mails en stuurt ze als HTTP-verzoeken door naar je externe endpoint.

3. Detecteer en verwerk de melding:

   • Je extern systeem kan de specifieke e-mails die door je Prestatiebeloningsregel worden verzonden filteren en de bijbehorende workflows activeren.

Deze methode is eenvoudig en maakt gebruik van e-mailinfrastructuur voor meldingen.

Oplossing 2: Gebruik van €0 Actiecommissie, Algemene Callback-URL en Applicatie Callbacks

1. Dupliceer de Prestatiebeloningsregel:

   • Dupliceer je Prestatiebeloningsregel zoals hierboven, maar wijzig de actie naar “actiecommissiebonus toevoegen” en selecteer een actiecommissie van €0 (zie Actiecommissies ).

2. Algemene Callback-URL (Alle accounts):

   • Ga naar Configuratie > Trackinginstellingen > Callback tracking.
   • Stel de Algemene Callback-URL in om meldingen te ontvangen van elke getrackte commissie (verkoop of actie).
   • Luister op je endpoint alleen naar de specifieke actiecommissies van €0 die door je Prestatiebeloningsregel worden geactiveerd.

3. Applicatie Callbacks (Alleen Ultimate/Network-plannen):

   • Ga naar Configuratie > Callbacks en gebruik de optie “Verkooptracking callback toevoegen”.
   • Selecteer je actiecommissie van €0 onder “Commission type” en geef je endpoint-URL op.
   • Zo wordt alleen het geselecteerde commissietype gebruikt om de callback te activeren.

4. Schakel affiliate e-mailmeldingen voor €0-commissies uit:

   • Standaard zien affiliates deze actiecommissies van €0 in hun panel.
   • Om te voorkomen dat ze e-mailmeldingen ontvangen, ga naar Configuratie > E-mailmeldingen > Affiliate-meldingen en vink het vakje “Standaardwaarde voor affiliate” aan naast “Schakel nul commissie meldingen uit bij verkoop/lead.”

Let op: Het belangrijkste nadeel van deze aanpak is dat affiliates deze €0-commissies nog steeds in hun dashboard zien (maar niet per e-mail als meldingen zijn uitgeschakeld).

Best practices voor automatisering en API-meldingen in Post Affiliate Pro

• Gebruik speciale of verborgen velden voor automatiseringstriggers om verwarring of onbedoelde wijzigingen te voorkomen.
• Documenteer duidelijk alle automatiseringsworkflows en welke velden of plugins worden gebruikt voor meldingen.
• Beveilig je webhook- en callback-endpoints om alleen vertrouwde verzoeken te accepteren.
• Test elke oplossing grondig om te verzekeren dat meldingen naar verwachting worden afgeleverd.
• Controleer regelmatig de Prestatiebeloningsregels, plugin-instellingen en campagneconfiguraties op blijvende betrouwbaarheid.

Wat zijn Prestatiebeloningen in Post Affiliate Pro?

Prestatiebeloningen zijn krachtige regels die automatisch bonussen toekennen, affiliateprofielen bijwerken of aangepaste acties activeren wanneer affiliates specifieke mijlpalen bereiken, zoals een vastgesteld aantal verkopen, verwijzingen of andere getrackte activiteiten. Acties kunnen bestaan uit het toekennen van bonussen, het wijzigen van commissiegroepen, het verzenden van meldingen of het bijwerken van (ook verborgen) profielvelden.

Hoe configureer en kies je de beste oplossing

• Voor onzichtbare, interne meldingen: Gebruik het verborgen profielveld en de Affiliate Profile Change Webhook.
• Voor e-mailgebaseerde verwerking: Gebruik de actie “stuur e-mail naar” met de Emails Callback Webhook-plugin.
• Voor op commissies gebaseerde meldingen: Gebruik een actiecommissie van €0 met Algemene Callback-URL of Applicatie Callbacks, met inachtneming van de zichtbaarheid voor affiliates in hun panel.

Stapsgewijze handleiding: Voorbeeld van verborgen profielveld + webhook

1. Ga naar Configuratie > Prestatiebeloningen.
2. Bewerk of maak een regel aan en selecteer “Update gebruiker” bij de acties.
3. Kies (of maak) een profielveld, stel het in als Verborgen.
4. Stel de waarde in die jouw workflow moet activeren.
5. Installeer en configureer de Affiliate Profile Change Webhook-plugin om dat veld in de gaten te houden.
6. Vul je externe API-endpoint in bij de plugin-instellingen.
7. Test de workflow door aan de Prestatiebeloningsvoorwaarden te voldoen en te controleren of de webhook wordt verstuurd.

Stapsgewijze handleiding: Voorbeeld van €0 actiecommissie + Algemene Callback-URL

1. Dupliceer je Prestatiebeloningsregel, stel de actie in op “actiecommissiebonus toevoegen” en kies een commissietype van €0.
2. Stel Algemene Callback-URL in onder Configuratie > Trackinginstellingen > Callback tracking.
3. Filter inkomende callbacks op je endpoint voor jouw specifieke commissietype van €0.
4. Schakel eventueel affiliate e-mailmeldingen voor nulcommissies uit.
5. Test door de beloning te activeren en het gedrag van de callback en het endpoint te controleren.

Samenvatting

Post Affiliate Pro biedt geen directe API-meldingen vanuit Prestatiebeloningsregels, maar met deze bewezen oplossingen—verborgen profielveld plus webhook, e-mailcallback, of €0-actiecommissie met callback—kun je betrouwbaar externe meldingen en integraties automatiseren die aansluiten bij jouw affiliatebeheer.