Was sind Application Callbacks in Post Affiliate Pro?
Erfahren Sie, wie Application Callbacks in Post Affiliate Pro funktionieren. Entdecken Sie anpassbare Ereignistrigger für Verkäufe, Leads und Affiliate-Anmeldun...
7 Min. Lesezeit
Verfügbar in:
Post Affiliate Pro , Post Affiliate Pro Ultimate , Post Affiliate Network
Was sind Webhooks & Callbacks?
Webhooks (auch Application Callbacks oder Postback-URLs genannt) sind automatisierte HTTP-Benachrichtigungen, die Post Affiliate Pro an externe Systeme sendet, wenn bestimmte Ereignisse auftreten. Anstatt ständig nach Updates zu fragen, erhalten Ihre verbundenen Systeme sofortige Benachrichtigungen, sobald etwas in Ihrem Partnerprogramm passiert.
Diese Funktion ist essentiell für:
- CRM-Integration - Automatisch Ihre Kundendatenbank aktualisieren, wenn Verkäufe stattfinden
- E-Mail-Automatisierung - E-Mail-Sequenzen basierend auf Partneraktionen auslösen
- Buchhaltungssysteme - Transaktionsdaten mit Ihrer Finanzsoftware synchronisieren
- Benutzerdefinierte Dashboards - Echtzeit-Reporting-Dashboards erstellen
- Drittanbieter-Tracking - Externe Tracking-Plattformen über Konversionen benachrichtigen
Arten von Webhooks
Post Affiliate Pro unterstützt zwei Haupttypen von Webhooks:
Verkaufs-Tracking-Webhooks
Diese Webhooks werden durch transaktionsbezogene Ereignisse ausgelöst:
| Auslöser-Ereignis | Beschreibung |
|---|---|
| Bei Erstellung | Wird sofort ausgelöst, wenn eine neue Transaktion (Verkauf, Aktion, Lead) aufgezeichnet wird |
| Bei Genehmigung | Wird ausgelöst, wenn eine ausstehende Transaktion genehmigt wird |
| Bei Ablehnung | Wird ausgelöst, wenn eine Transaktion abgelehnt wird |
| Bei Rückerstattung/Rückbuchung | Wird ausgelöst, wenn eine Rückerstattung oder Rückbuchung verarbeitet wird |
Sie können einen einzelnen Webhook für mehrere Ereignisse konfigurieren oder separate Webhooks für jeden Ereignistyp erstellen.
Partner-Registrierungs-Webhooks
Diese Webhooks werden durch Partner-Registrierungsereignisse ausgelöst:
| Auslöser-Ereignis | Beschreibung |
|---|---|
| Bei Registrierung | Wird sofort ausgelöst, wenn ein neuer Partner das Registrierungsformular abschließt |
| Bei Genehmigung | Wird ausgelöst, wenn ein ausstehender Partner von einem Händler genehmigt wird |
Anfragetypen
Post Affiliate Pro unterstützt drei HTTP-Anfragetypen für Webhooks:
GET-Anfrage
Parameter werden als Query-String-Parameter an die URL angehängt.
https://your-system.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456
POST-Anfrage (Form-Urlencoded)
Parameter werden im Anfrage-Body mit Standard-Formular-Kodierung gesendet.
Content-Type: application/x-www-form-urlencoded
transactionid=abc123&commission=50.00&orderid=ORD-456
POST JSON-Anfrage
Parameter werden als JSON-Objekt im Anfrage-Body gesendet.
Content-Type: application/json
{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}
Verfügbare Variablen für Verkaufs-Webhooks
Sie können dynamische Variablen in Ihren Webhook-URLs verwenden, die automatisch durch tatsächliche Werte ersetzt werden. Verwenden Sie das Format ${#variablenname#}, um eine Variable einzubinden.
Transaktionsdaten
| Variable | Beschreibung |
|---|---|
${#transactionid#} | Eindeutige Transaktionskennung |
${#visitorid#} | Besucher-ID (Tracking-Cookie) |
${#commission#} | Provisionsbetrag |
${#totalcost#} | Gesamtbestellwert |
${#fixedcost#} | Fixkostenbetrag |
${#orderid#} | Bestell-ID aus Ihrem E-Commerce-System |
${#productid#} | Produkt-ID |
${#dateinserted#} | Datum und Uhrzeit der Transaktionserstellung |
${#dateapproved#} | Datum und Uhrzeit der Transaktionsgenehmigung |
${#tier#} | Provisionsstufe |
${#status#} | Transaktionsstatus (Genehmigt, Ausstehend, Abgelehnt) |
${#statuscode#} | Statuscode (A, P, D) |
${#type#} | Transaktionstyp (Verkauf, Aktion, etc.) |
Kampagnen- und Bannerdaten
| Variable | Beschreibung |
|---|---|
${#campaignid#} | Kampagnenkennung |
${#campaignname#} | Kampagnenname |
${#bannerid#} | Bannerkennung |
${#channel#} | Kanalname |
${#channel_code#} | Kanalcode |
${#coupon_code#} | Verwendeter Gutscheincode |
Partnerdaten
| Variable | Beschreibung |
|---|---|
${#userid#} | Partner-Benutzer-ID |
${#refid#} | Partner-Empfehlungs-ID |
Klickdaten
| Variable | Beschreibung |
|---|---|
${#firstclicktime#} | Erster Klick Zeitstempel |
${#firstclickreferer#} | Erster Klick Referrer-URL |
${#firstclickip#} | Erster Klick IP-Adresse |
${#firstclickdata1#} | Erster Klick benutzerdefinierte Daten 1 |
${#firstclickdata2#} | Erster Klick benutzerdefinierte Daten 2 |
${#lastclicktime#} | Letzter Klick Zeitstempel |
${#lastclickreferer#} | Letzter Klick Referrer-URL |
${#lastclickip#} | Letzter Klick IP-Adresse |
${#lastclickdata1#} | Letzter Klick benutzerdefinierte Daten 1 |
${#lastclickdata2#} | Letzter Klick benutzerdefinierte Daten 2 |
Benutzerdefinierte Transaktionsdaten
| Variable | Beschreibung |
|---|---|
${#saledata1#} | Transaktions-benutzerdefiniertes Datenfeld 1 |
${#saledata2#} | Transaktions-benutzerdefiniertes Datenfeld 2 |
${#saledata3#} | Transaktions-benutzerdefiniertes Datenfeld 3 |
${#saledata4#} | Transaktions-benutzerdefiniertes Datenfeld 4 |
${#saledata5#} | Transaktions-benutzerdefiniertes Datenfeld 5 |
Geografische und technische Daten
| Variable | Beschreibung |
|---|---|
${#ip#} | IP-Adresse des Kunden |
${#countrycode#} | Ländercode basierend auf IP |
${#refererurl#} | Referrer-URL |
Währungsdaten
| Variable | Beschreibung |
|---|---|
${#originalcurrency#} | Ursprünglicher Währungsname |
${#originalcurrencyvalue#} | Ursprünglicher Währungswert |
${#originalcurrencyrate#} | Verwendeter Wechselkurs |
Notizen
| Variable | Beschreibung |
|---|---|
${#merchantnote#} | Für Partner sichtbare Notiz |
${#systemnote#} | Nur für Händler sichtbare Notiz |
${#actionName#} | Aktions-Provisionstyp-Name |
${#actionCode#} | Aktions-Provisionstyp-Code |
Verfügbare Variablen für Registrierungs-Webhooks
Für Partner-Registrierungs-Webhooks können Sie Partnerprofil-Variablen verwenden:
| Variable | Beschreibung |
|---|---|
${#username#} | Partner-E-Mail/Benutzername |
${#firstname#} | Partner-Vorname |
${#lastname#} | Partner-Nachname |
${#name#} | Vollständiger Name (Vor- + Nachname) |
${#userId#} | Partner-Benutzer-ID |
| Benutzerdefinierte Felder | Jedes benutzerdefinierte Profilfeld nach seinem Code |
Multi-Tier-Unterstützung
Standardmäßig werden Webhooks nur für Tier 1 (direkte) Provisionen ausgeführt. Sie können die Option “Für jede Stufe ausführen” aktivieren, um Webhooks für alle Stufenebenen in Multi-Tier-Provisionsstrukturen auszulösen.
Dies ist nützlich, wenn:
- Sie Provisionen auf allen Ebenen Ihrer Partnerhierarchie verfolgen müssen
- Ihr externes System über Sub-Partner-Einnahmen informiert werden muss
- Sie umfassende Berichte erstellen, die alle Provisionsstufen einschließen
Webhook-Filteroptionen
Sie können Webhooks spezifischer konfigurieren:
Nach Provisionstyp
Beschränken Sie den Webhook auf einen bestimmten Provisionstyp (z.B. nur für “Premium-Verkäufe”-Aktionsprovisionen).
Nach Partner
Erstellen Sie Webhooks, die nur für einen bestimmten Partner ausgelöst werden. Dies ist nützlich für:
- Partner, die ihre eigenen Tracking-Systeme verwenden
- Spezielle Integrationen für Top-Partner
- Testen von Webhooks mit einem einzelnen Partner vor der Einführung
Nach Konto (Netzwerk-Modus)
In Post Affiliate Network können Sie kontospezifische Webhooks erstellen.
Webhook-Log & Überwachung
Post Affiliate Pro führt ein umfassendes Protokoll aller Webhook-Ausführungen, zugänglich im Händler-Panel unter Tools > Callbacks-Log.
Das Protokoll zeigt:
- Log-ID - Eindeutige Kennung für jede Webhook-Ausführung
- Callback-ID - Welche Webhook-Konfiguration verwendet wurde
- Anfrage-URL - Die vollständige URL, die aufgerufen wurde (mit ersetzten Variablen)
- Erstellt am - Wann der Webhook in die Warteschlange gestellt wurde
- Letzter Versuch - Wann der letzte Ausführungsversuch stattfand
- Versuchsnummer - Wie oft das System versucht hat, auszuführen
- Status - Ausstehend, Gesendet oder Fehler
- Fehlermeldung - Details, wenn der Webhook fehlgeschlagen ist
Automatische Wiederholung
Wenn ein Webhook fehlschlägt (z.B. Ihr Server ist vorübergehend nicht verfügbar), wird Post Affiliate Pro die Anfrage automatisch wiederholen. Dies gewährleistet zuverlässige Zustellung auch bei vorübergehenden Ausfällen.
Protokollaufbewahrung
Webhook-Logs werden automatisch nach einer konfigurierbaren Anzahl von Tagen bereinigt (Standard: 60 Tage). Sie können dies unter Konfiguration > Funktionen > Application Callbacks anpassen.
Webhook-Verwaltung
Genehmigungsworkflow
Standardmäßig erfordern von Partnern erstellte Webhooks die Händlergenehmigung, bevor sie aktiv werden. Händler können:
- Automatische Genehmigung aktivieren - Alle neuen Webhooks automatisch genehmigen
- Manuell überprüfen - Jeden Webhook einzeln genehmigen oder ablehnen
Statusverwaltung
Webhooks haben drei mögliche Status:
- Genehmigt - Aktiv und wird bei Auslösung ausgeführt
- Ausstehend - Wartet auf Händlergenehmigung
- Abgelehnt - Abgelehnt und wird nicht ausgeführt
Händler können den Webhook-Status jederzeit vom Webhooks-Verwaltungsbildschirm aus ändern.
E-Mail-Benachrichtigungen
Post Affiliate Pro kann E-Mail-Benachrichtigungen für webhook-bezogene Ereignisse senden:
Händler-Benachrichtigungen
- Neuer Webhook von Partner erstellt
Partner-Benachrichtigungen (Optional)
- Webhook-Status geändert (genehmigt/abgelehnt)
- Webhook vom Händler geändert
- Webhook vom Händler gelöscht
Diese Benachrichtigungen können unter Konfiguration > E-Mail-Benachrichtigungen aktiviert oder deaktiviert werden.
Beispiel-Anwendungsfälle
1. CRM-Integration
Neue Verkaufsdaten an Ihr CRM senden, wenn eine Transaktion genehmigt wird:
https://crm.example.com/api/sales?customer_order=${#orderid#}&value=${#totalcost#}&affiliate=${#refid#}
2. Slack-Benachrichtigung
Ihr Team-Channel benachrichtigen, wenn sich ein neuer Partner registriert:
https://hooks.slack.com/services/xxx/yyy?text=Neuer+Partner:+${#firstname#}+${#lastname#}
3. E-Mail-Plattform-Trigger
Kunden nach dem Kauf zu einer E-Mail-Sequenz hinzufügen:
POST https://email.example.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}
4. Buchhaltungssoftware-Sync
Provisionszahlungen in Ihrem Buchhaltungssystem aufzeichnen:
https://accounting.example.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}
Webhook einrichten
- Melden Sie sich in Ihrem Händler-Panel an
- Navigieren Sie zu Konfiguration > Funktionen
- Aktivieren Sie die Application Callbacks-Funktion
- Gehen Sie zu Kampagnen > [Kampagne auswählen] > Callbacks oder zum globalen Callbacks-Manager
- Klicken Sie auf Neuen Callback hinzufügen
- Konfigurieren Sie:
- Name - Ein beschreibender Name für den Webhook
- Typ - Verkaufs-Tracking oder Partner-Registrierung
- Ausführung - Wann auslösen (bei Erstellung, Genehmigung, Ablehnung, Rückerstattung)
- Anfragetyp - GET, POST oder POST JSON
- URL - Ihr Endpunkt mit Variablen
- Für jede Stufe ausführen - Ja/Nein
- Webhook speichern
Sicherheitsüberlegungen
- HTTPS-Endpunkte für sichere Datenübertragung verwenden
- Erwägen Sie, einen geheimen Parameter hinzuzufügen, um die Webhook-Quelle zu verifizieren
- Ratenbegrenzung auf Ihrem empfangenden Endpunkt implementieren
- Eingehende Daten vor der Verarbeitung validieren
- Webhook-Logs für Audit-Zwecke aufbewahren
Verwandte Funktionen
- S2S Tracking - Server-zu-Server-Tracking für genaue Konversionen
- API - Vollständiger programmatischer Zugriff auf Post Affiliate Pro
- API v3 - Moderne RESTful API mit OAuth 2.0
