Wie benachrichtige ich eine externe API, wenn eine Performance-Belohnung in Post Affiliate Pro ausgelöst wird?

Problemstellung

Affiliate-Programm-Manager benötigen oft, dass Post Affiliate Pro externe Systeme – wie APIs, CRMs oder eigene Anwendungen – automatisch benachrichtigt, wenn bestimmte Performance-Belohnungsregeln ausgelöst werden (z.B. wenn ein Affiliate eine bestimmte Anzahl an Sub-Affiliates wirbt oder einen Verkaufsmeilenstein erreicht). Allerdings bietet Post Affiliate Pro keine eingebaute Funktion, um direkt aus einer Performance-Belohnungsregel heraus eine externe API aufzurufen.

Um diese Lücke zu schließen, können verschiedene flexible Workarounds implementiert werden, um Automatisierungen und externe Benachrichtigungen mit minimalen Störungen Ihres Affiliate-Workflows zu ermöglichen.

Verwendung eines versteckten Profilfeldes und Affiliate Profile Change Webhook (Empfohlen & für Affiliates unsichtbar)

1. Verstecktes Profilfeld über Performance-Belohnung aktualisieren:

   • Wählen Sie im Bereich „Aktionen“ Ihrer Performance-Belohnungsregel “Benutzer aktualisieren” und wählen Sie ein Profilfeld zur Aktualisierung aus.
   • Stellen Sie dieses Profilfeld in den Affiliate-Profil-Einstellungen als Versteckt ein, sodass es für Affiliates nicht sichtbar ist und nur für interne Automatisierungen dient.

2. Affiliate Profile Change Webhook-Plugin konfigurieren:

   • Installieren und konfigurieren Sie das Affiliate Profile Change Webhook-Plugin .
   • Stellen Sie das Plugin so ein, dass es das aktualisierte versteckte Profilfeld überwacht.
   • Sobald sich das Feld ändert, sendet das Plugin einen Webhook (HTTP POST) mit Affiliate-Details an Ihren externen API-Endpunkt.

Mit diesem Ansatz wird nur Ihr System benachrichtigt – Affiliates bemerken das Feld oder dessen Änderungen nicht.

Workaround 1: Verwendung der Aktion “E-Mail senden an” und Emails Callback Webhook

1. Duplizieren Sie die Performance-Belohnungsregel:

   • Erstellen Sie eine Kopie Ihrer ursprünglichen Performance-Belohnungsregel mit denselben Bedingungen.
   • Wählen Sie als Aktion “E-Mail senden an” und richten Sie den Versand an den Händler ein.

2. Emails Callback Webhook-Plugin einrichten:

   • Installieren und konfigurieren Sie das Emails Callback Webhook-Plugin .
   • Dieses Plugin verarbeitet alle ausgehenden E-Mails und leitet sie als HTTP-Anfragen an Ihren externen Endpunkt weiter.

3. Benachrichtigung erkennen und verarbeiten:

   • Ihr externes System kann gezielt die von Ihrer Performance-Belohnungsregel versendeten E-Mails filtern und entsprechende Workflows auslösen.

Diese Methode ist einfach und nutzt die bestehende E-Mail-Infrastruktur für Benachrichtigungen.

Workaround 2: Verwendung von $0-Aktionsprovision, Allgemeiner Callback-URL und Application Callbacks

1. Performance-Belohnungsregel duplizieren:

   • Duplizieren Sie Ihre Performance-Belohnungsregel wie zuvor, ändern Sie aber die Aktion auf “Aktionsprovisionsbonus hinzufügen” und wählen Sie eine $0-Aktionsprovision aus (siehe Aktionsprovisionen ).

2. Allgemeine Callback-URL (alle Accounts):

   • Navigieren Sie zu Konfiguration > Tracking-Einstellungen > Callback-Tracking.
   • Richten Sie die Allgemeine Callback-URL ein, um Benachrichtigungen für jede erfasste Provision (Verkauf oder Aktion) zu erhalten.
   • Filtern und verarbeiten Sie auf Ihrem Endpunkt nur die spezifischen $0-Aktionsprovisionen, die durch Ihre Regel ausgelöst werden.

3. Application Callbacks (nur Ultimate-/Network-Pläne):

   • Gehen Sie zu Konfiguration > Callbacks und nutzen Sie die Option “Verkaufstracking-Callback hinzufügen”.
   • Wählen Sie Ihre $0-Aktionsprovision unter „Provisionstyp“ und geben Sie Ihre Endpunkt-URL an.
   • So wird der Callback nur vom gewählten Provisionstyp ausgelöst.

4. Affiliate-E-Mail-Benachrichtigungen für $0-Provisionen unterdrücken:

   • Affiliates sehen diese $0-Aktionsprovisionen standardmäßig in ihrem Panel.
   • Um E-Mail-Benachrichtigungen zu verhindern, gehen Sie zu Konfiguration > E-Mail-Benachrichtigungen > Affiliate-Benachrichtigungen und aktivieren Sie das Feld “Standardwert für Affiliate” neben “Benachrichtigungen für Nullprovisionen bei Verkauf/Lead deaktivieren”.

Hinweis: Der Hauptnachteil dieses Ansatzes ist, dass Affiliates diese $0-Provisionen weiterhin im Dashboard sehen (wenn auch nicht per E-Mail, falls Benachrichtigungen deaktiviert wurden).

Best Practices für Automatisierung und API-Benachrichtigungen in Post Affiliate Pro

• Nutzen Sie dedizierte oder versteckte Felder für Automatisierungstrigger, um Verwirrung oder versehentliche Änderungen zu vermeiden.
• Dokumentieren Sie alle Automatisierungs-Workflows sowie die verwendeten Felder und Plugins klar und nachvollziehbar.
• Sichern Sie Ihre Webhook- und Callback-Endpunkte so ab, dass nur vertrauenswürdige Anfragen akzeptiert werden.
• Testen Sie jeden Workaround gründlich, um sicherzustellen, dass Benachrichtigungen wie erwartet zugestellt werden.
• Überprüfen Sie regelmäßig Performance-Belohnungsregeln, Plugin-Einstellungen und Kampagnenkonfigurationen auf Zuverlässigkeit.

Was sind Performance Rewards in Post Affiliate Pro?

Performance Rewards sind leistungsstarke Regeln, die automatisch Boni vergeben, Affiliate-Profile aktualisieren oder benutzerdefinierte Aktionen auslösen, wenn Affiliates bestimmte Meilensteine erreichen – z.B. eine festgelegte Anzahl von Verkäufen, Empfehlungen oder andere getrackte Aktivitäten. Die Aktionen können das Vergeben von Boni, das Ändern von Provisionsgruppen, das Versenden von Benachrichtigungen oder das Aktualisieren (auch versteckter) Profilfelder umfassen.

So konfigurieren und wählen Sie den besten Workaround

• Für unsichtbare, interne Benachrichtigungen: Verwenden Sie das versteckte Profilfeld und das Affiliate Profile Change Webhook.
• Für E-Mail-basierte Verarbeitung: Nutzen Sie die Aktion “E-Mail senden an” mit dem Emails Callback Webhook-Plugin.
• Für provisionsbasierte Benachrichtigungen: Nutzen Sie eine $0-Aktionsprovision mit allgemeiner Callback-URL oder Application Callbacks, unter Berücksichtigung der Sichtbarkeit im Affiliate-Panel.

Schritt-für-Schritt-Anleitung: Beispiel Verstecktes Profilfeld + Webhook

1. Gehen Sie zu Konfiguration > Performance Rewards.
2. Bearbeiten oder erstellen Sie eine Regel und wählen Sie bei den Aktionen “Benutzer aktualisieren”.
3. Wählen (oder erstellen) Sie ein Profilfeld und setzen Sie es als Versteckt.
4. Legen Sie den Wert fest, der Ihren Workflow auslösen soll.
5. Installieren und konfigurieren Sie das Affiliate Profile Change Webhook-Plugin für die Überwachung dieses Feldes.
6. Tragen Sie Ihren externen API-Endpunkt in den Plugin-Einstellungen ein.
7. Testen Sie den Workflow, indem Sie die Bedingungen der Performance-Belohnung erfüllen und prüfen, ob der Webhook ausgelöst wird.

Schritt-für-Schritt-Anleitung: Beispiel $0-Aktionsprovision + Allgemeine Callback-URL

1. Duplizieren Sie Ihre Performance-Belohnungsregel, setzen Sie die Aktion auf “Aktionsprovisionsbonus hinzufügen” und wählen Sie einen $0-Provisionstyp.
2. Richten Sie die Allgemeine Callback-URL unter Konfiguration > Tracking-Einstellungen > Callback-Tracking ein.
3. Filtern Sie auf Ihrem Endpunkt eingehende Callbacks für Ihren spezifischen $0-Provisionstyp.
4. Optional: Deaktivieren Sie Affiliate-Benachrichtigungs-E-Mails für Nullprovisionen.
5. Testen Sie, indem Sie die Belohnung auslösen und das Verhalten von Callback und Endpunkt überprüfen.

Zusammenfassung

Post Affiliate Pro bietet keine direkte API-Benachrichtigung aus Performance-Belohnungsregeln, aber mit diesen bewährten Workarounds – verstecktes Profilfeld plus Webhook, E-Mail-Callback oder $0-Aktionsprovision mit Callback – können Sie zuverlässig externe Benachrichtigungen und Integrationen automatisieren, um Ihre Anforderungen im Affiliate-Management zu erfüllen.