Aktivieren Sie Event-Benachrichtigungs-Postbacks für Marken
Eventbenachrichtigungs-Postbacks (Webhooks) benachrichtigen Ihre internen Systeme in Echtzeit, wenn bestimmte Ereignisse auftreten. Obwohl die gesendeten Daten je nach Ereignis variieren, ist der Konfigurationsprozess für alle gleich.
Zugriff auf Event-Benachrichtigungs-Postbacks
Wählen Sie in der oberen Navigationsleiste
[Benutzerprofil] → Einstellungen.Unter den Technisch Bereich, wählen Sie Eventbenachrichtigungen.
Globale Konfigurationsfelder ausfüllen
Bewegen Sie den Mauszeiger über das Ereignis, für das Sie ein Benachrichtigungs-Postback konfigurieren möchten, und wählen Sie
[Bearbeiten].Verwenden Sie die folgende Tabelle, um die Zustellungs-Einstellungen zu konfigurieren:
URL
Der Endpunkt auf Ihrem Server, der die Daten empfängt.
HTTP-Methode
GET: Daten werden der URL als Query-Strings angehängt.
POST: Daten werden im Request-Body gesendet, der verschiedene optionale Parameter enthält, die Sie festlegen können.
Siehe Benachrichtigungsereignisse und Payloads für weitere Informationen zu jedem Ereignis und zum Payload-Inhalt.
HTTP-Header
(Optional) Benutzerdefinierte Header zur Authentifizierung hinzufügen (z. B., Authorization: Bearer token).
Mindestverzögerung
Setzen Sie Mindestverzögerung in Sekunden fest, um Ihren Server vor Lastspitzen zu schützen.
Maximale Anfragen
Setzen Sie Maximale Anfragen pro Sekunde fest, um Ihren Server vor Lastspitzen zu schützen.
Erfolgsantwort
Der konkrete Textstring oder HTTP-Statuscode, den Ihr Server zurückgibt, wenn ein Postback korrekt verarbeitet wurde.
Fehlerantwort
Der Textstring oder Statuscode, der auf einen Fehler hinweist (z. B., ERROR oder 500).
Benachrichtigungsereignisse & Payloads
Jede Ereignisbenachrichtigung sendet einen eindeutigen Satz konfigurierbarer Datenpunkte (z. B., {ActionId}). Lesen Sie die folgenden Ereignisse, um zu erfahren, welche Datenpunkte Sie aus den Payloads extrahieren können.
Ereignisse des Aktions-Lebenszyklus
Action Lifecycle Events sendet eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn eine Aktion erfasst, geändert oder rückgängig gemacht wird.
// Ein POST-Beispiel im JSON-Format
{
"CampaignId": 9876, // Programm-ID
"ActionTrackerId": 12345, // Ereignistyp-ID
"MediaPartnerId": 555, // Partner-ID
"CampaignName": "Spring Global Promotion", // Programmname
"ActionTrackerName": "Standard Sale Tracker", // Name des Ereignistyps
"MediaPartnerName": "Top Tier Affiliates", // Partnername
"ActionId": "ACT-778899", // Aktions-ID
"Status": "MODIFIED", // Aktionsstatus
"StatusDetail": "Artikelrücksendung - Auszahlung angepasst", // Weitere Details zum Aktionsstatus
"AdId": 44332, // Anzeigen-ID
"Payout": 10.50, // Auszahlungsbetrag an den Partner, in der Währung des Partners
"DeltaPayout": -5.00, // Änderung des Auszahlungsbetrags
"IntendedPayout": 15.50, // Der vorgesehene Auszahlungsbetrag für eine Aktion über dem Limit
"Amount": 100.00, // Aktionsbetrag, in der Währung des Kontos
"DeltaAmount": -50.00, // Korrigierter Betrag aus der vorherigen Aktion
"IntendedAmount": 150.00, // Der vorgesehene Verkaufsbetrag für eine Aktion über dem Limit
"Currency": "USD", // Währung für die Aktion
"OriginalCurrency": "USD", // Ursprüngliche (d. h. Warenkorb-)Währung für die Aktion
"OriginalAmount": 100.00, // Ursprünglicher (d. h. Warenkorb-)Betrag für die Aktion
// Sammlung "items": Daten zu einzelnen Artikeln in dieser Aktion
"items": [{join(items, i,
"\{\"sku\":\"{i.sku}\",
\"item_price\":{i.amt},
\"category\":\"{i.cat}\",
\"quantity\":{i.qty},
\"cartamt\":{i.cartamt},
\"rbt\":\"{i.rbt}\",
\"name\":\"{i.name}\"\}")}],
"EventDate": "2026-04-08T09:00:00Z", // Datum der Konvertierung
"CreationDate": "2026-04-08T09:05:00Z", // Datum der Erstellung im System
"LockingDate": "2026-05-08T00:00:00Z", // Datum, an dem die Aktion gesperrt wird
"ClearedDate": "2026-05-15T00:00:00Z", // Geplantes Freigabedatum
"ReferringDomain": "blog.partner.com", // Verweis-Domain
"LandingPageUrl": "https://brand.com/sale", // URL der Zielseite
"RefCustomerArea": "California", // Kundenbereich (aus IP abgeleitet)
"RefCustomerCity": "San Francisco", // Kundenstadt (aus IP abgeleitet)
"RefCustomerRegion": "CA", // Kundenregion (aus IP abgeleitet)
"RefCustomerCountry": "US", // Kundenland (aus IP abgeleitet)
"RefClickId": "CLK9988776655", // Eindeutige Klick-ID
"SharedId": "social_post_01", // Geteilte ID des Partners
"PromoCode": "SAVE20", // Allgemeiner Aktionscode
"CustomerStatus": "EXISTING", // Kundenstatus
"Oid": "ORD-554433", // Bestell-ID
"Note": "Teilrücksendung verarbeitet", // Hinweis, der mit der Aktion übermittelt wird
"CustomerPostCode": "94105", // Kunden-Postleitzahl
"CustomerCity": "San Francisco", // Kundenstadt
"CustomerCountry": "US", // Kundenland
"CustomerRegion": "CA", // Kundenregion
"CustomerId": "CUST-12345", // Kunden-ID
"CustomerEmail": "a665a45920422f9d417...", // Gehashte Kunden-E-Mail
"IpAddress": "192.168.1.1", // IP-Adresse
"CallerId": null, // Telefonnummer des Anrufers
// Benutzerdefinierte Zusatzfelder
"Text1": "Custom Val 1", // Text 1
"Date1": "2026-04-08", // Datum 1
"Money1": 10.00, // Geld 1
"Numeric1": 1, // Numerisch 1
// Geräte- und App-Metadaten
"appPackage": "com.brand.app", // Mobile-App-Paket
"appName": "BrandStore", // Mobile-App-Name
"appVersion": "4.2.1", // Mobile-App-Version
"deviceOs": "iOS", // Gerätebetriebssystem
"deviceOsVersion": "17.4", // Geräte-OS-Version
"deviceManuf": "Apple", // Gerätehersteller
"deviceModel": "iPhone 15", // Gerätemodell
"macAddress": "00:1B:44:11:3A:B7", // MAC-Adresse (Großschreibung)
"macAddressLower": "00:1b:44:11:3a:b7", // MAC-Adresse (Kleinschreibung)
"macAddressAlpha": "001B44113AB7", // MAC-Adresse (ohne Doppelpunkte)
"macAddressSha1": "47a32...", // MAC-SHA1
"iosIfa": "EA7583CD-A667-48BC-B806-42ECB2B48606", // iOS-Werbe-ID
"iosAdTracking": "1", // iOS-Ad-Tracking-Einstellung
"androidId": null, // Android-ID
"deviceId": "D-556677", // Geräte-ID
"deviceIp": "192.168.1.1" // Geräte-IP
}Ereignisse zu Aktionsanfragen
Action Inquiry Events sendet eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionsanfragen erstellt oder gelöst werden.
// Ein POST-Beispiel im JSON-Format
{
"Id": 554433, // Eindeutige Kennung der Aktionsanfrage im System
"MediaPartnerId": 555, // Partner-ID
"MediaPartnerName": "Top Tier Affiliates", // Partnername
"CampaignId": 9876, // Programm-ID
"CampaignName": "Spring Global Promotion", // Programmname
"OrderId": "ORD-12345", // Bestell-ID der gemeldeten Aktion
"TransactionDate": "2026-04-01T14:30:00Z", // Transaktionsdatum des Ereignisses, das die Aktionsanfrage ausgelöst hat
"TransactionAmount": 250.00, // Transaktionsbetrag des Ereignisses, das die Aktionsanfrage ausgelöst hat
"InquiryType": "MISSING_ACTION", // Art der Aktionsanfrage
"ExpectedPayout": 25.00, // Vom Partner erwarteter Auszahlungsbetrag
"ResolutionDeadlineDate": "2026-05-01T00:00:00Z", // Datum, bis zu dem die Anfrage akzeptiert oder abgelehnt werden muss
"TrackingLink": "https://proweb.com/click?cid=1&pid=555", // Vom Partner bereitgestellter Tracking-Link
"ActionId": "ACT-999000", // Aktions-ID (falls mit einer vorhandenen Aktion verknüpft)
"AutoApprovalDate": "2026-05-05T00:00:00Z", // Datum, an dem das System die automatischen Genehmigungsregeln ausführt
"ResolutionStatus": "PENDING", // Endgültiger Auflösungsstatus für die Aktionsanfrage
"RejectReason": null, // Grund, warum die Aktionsanfrage abgelehnt wurde
"FinalPayout": 0.00, // Endgültige Auszahlung im Zusammenhang mit der Aktionsanfrage
"ResolutionDate": null, // Datum, an dem über die Anfrage entschieden wurde
"CreationDate": "2026-04-08T10:05:00Z", // Datum, an dem die Anfrage im System erstellt wird
"InquiryNotes": "Der Kunde behauptet, er habe auf den Link geklickt, aber es wurde keine Gutschrift angezeigt.", // Vom Partner übermittelte Hinweise
"ResolutionNotes": null, // Vom Partner übermittelte Notizen, als über die Anfrage entschieden wurde
"Comments": "[{\"user\": \"support_agent\", \"text\": \"Verifying click logs now.\"}, {\"user\": \"partner\", \"text\": \"Customer provided receipt.\"}]" // Kommentare, die der Anfrage hinzugefügt wurden (im JSON-Format)
}Ereignisse zur Aktionsfreigabe
Action Clearing Events sendet eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionen freigegeben werden.
// Ein POST-Beispiel im JSON-Format
{
"ActionTrackerId": 12345, // Ereignistyp-ID
"ActionTrackerName": "Standard Sale Tracker", // Name des Ereignistyps
"CampaignId": 9876, // Programm-ID
"CampaignName": "Spring Global Promotion", // Programmname
"MediaPartnerId": 555, // Partner-ID
"MediaPartnerName": "Top Tier Affiliates", // Partnername
"OrderIds": "ORD-9921,ORD-9922", // Bestell-IDs der gemeldeten Aktionen (durch Kommas getrennt)
"ActionIds": "ACT-101,ACT-102", // Aktions-IDs (durch Kommas getrennt)
"ClearedDate": "2026-04-15T12:00:00Z", // Datum (ISO 8601), an dem die Aktion freigegeben werden soll
"LedgerDate": "2026-04-08T09:54:43Z" // Datum (ISO 8601), an dem die Aktion freigegeben wurde
}Ereignisse für Tracking-Wert-Anfragen
Tracking Value Request Events sendet eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Tracking-Anfragen erstellt werden.
// Ein POST-Beispiel im JSON-Format
{
"CampaignId": 9876, // Programm-ID
"ActionTrackerId": 12345, // Ereignistyp-ID
"MediaPartnerId": 555, // Partner-ID
"ActionId": "ACT-778899", // Aktions-ID
"Amount": 150.00, // Aktionsbetrag in der Kontowährung
"Currency": "USD", // Währung für die Aktion
"Oid": "ORD-554433", // Bestell-ID
// Sammlung "items": Aufschlüsselung der einzelnen Produkte in der Aktion
"items": [{join(items, i, "\{\"sku\":\"{i.sku}\",\"item_price\":{i.amt},\"category\":\"{i.cat}\",\"quantity\":{i.qty},\"cartamt\":{i.cartamt},\"rbt\":\"{i.rbt}\",\"name\":\"{i.name}\"\}")}],
"EventDate": "2026-04-08T09:00:00Z", // Konvertierungsdatum
"IpAddress": "192.168.1.1", // IP-Adresse des Geräts
"RefClickId": "CLK9988776655" // Eindeutige Klick-ID
}Ereignisse für abgeschlossene Jobs
Completed Job Events sendet eine HTTP-Anfrage an eine angegebene URL (und alle zusätzlichen Parameter), wenn ein Job für einen Berichtsexport oder Export anklicken.
Ereignisse zur Publisher-Bewerbung
Hinweis: Diese Funktionalität befindet sich in der Beta-Phase. Kontaktieren Sie Ihren CSM oder unseren Support-Team wenn Sie diese Funktion testen möchten.
Publisher Application Events sendet eine HTTP-Anfrage an eine angegebene URL, wenn ein Partner eine Bewerbung einreicht und jedes Mal, wenn die Bewerbung genehmigt, abgelehnt oder zurückgezogen wird.
Wenn ein PENDING Payload mit leeren Datenpunkten zugestellt wird, ist das System darauf ausgelegt, Aktualisierungen auszulösen, sobald Informationen verfügbar werden. Nachfolgende erfolgreiche Zustellungen füllen diese zuvor leeren Felder aus und stellen sicher, dass Ihre Datensätze mit den neuesten verarbeiteten Informationen synchron bleiben.
Wichtig: Wenn Sie Anwendungs-Workflows konfiguriert haben, werden sie ausgeführt, bevor der Webhook ausgelöst wird. Der Webhook wird mit dem resultierenden Status: APPROVED oder REJECTED wenn ein Workflow die Bewerbung verarbeitet hat, PENDING wenn kein Workflow angewendet wurde, oder RETRACTED wenn der Partner die Bewerbung zurückgezogen hat.
Der Payload-Inhalt variiert je nach Status. Das folgende Beispiel zeigt ein PENDING Ereignis, mit Kommentaren, die angeben, welche Felder bei anderen Status angezeigt werden.
Wiederholungsmechanismus für Postbacks
Wenn ein Postback beim Versuch, an die Ziel-URL zu posten, fehlschlägt, wird die Zustellung automatisch nach einem festgelegten Zeitplan bis zu 15 Mal erneut versucht. Wiederholungsversuche helfen bei vorübergehenden Netzwerkproblemen oder wenn der Server nicht verfügbar ist.
Bedingungen, unter denen keine Wiederholungsversuche stattfinden
Ein Postback wird in den folgenden Fällen nicht erneut versucht:
Die Ziel-URL ist fehlerhaft oder ungültig.
Die Ziel-URL oder ihr Host lässt sich nicht auflösen, zum Beispiel aufgrund eines DNS-Suchfehlers.
Wiederholungszeitplan
Die Wiederholungsversuche folgen dem folgenden Zeitplan. Die Wiederholungen 1, 2 und 3 werden übersprungen, wenn der HTTP-Antwortcode im Bereich von 400 zu 500.
Referenz zum Wiederholungszeitplan
Wiederholung 1
+15 Sekunden
Wiederholung 2
+15 Sekunden
Wiederholung 3
+15 Sekunden
Wiederholung 4
+3 Minuten
Wiederholung 5
+3 Minuten
Wiederholung 6
+15 Minuten
Wiederholung 7
+15 Minuten
Wiederholung 8
+15 Minuten
Wiederholung 9
+2 Stunden
Wiederholung 10
+2 Stunden
Wiederholung 11
+2 Stunden
Wiederholung 12
+6 Stunden
Wiederholung 13
+6 Stunden
Wiederholung 14
+6 Stunden
Wiederholung 15
+6 Stunden
Zuletzt aktualisiert
War das hilfreich?