Aktivieren Sie Event-Benachrichtigungs-Postbacks für Marken

Ereignisbenachrichtigungs-Postbacks (Webhooks) benachrichtigen Ihre internen Systeme in Echtzeit, wenn bestimmte Ereignisse eintreten. Die gesendeten Daten variieren zwar je nach Ereignis, der Konfigurationsprozess ist jedoch für alle gleich.

1

Auf Ereignisbenachrichtigungs-Postbacks zugreifen

1. Wählen Sie in der oberen Navigationsleiste [Benutzerprofil] → Einstellungen.

2. Unter dem Technisch Bereich, wählen Sie Ereignisbenachrichtigungen.

2

Globale Konfigurationsfelder ausfüllen

1. Bewegen Sie den Mauszeiger über das Ereignis, für das Sie einen Benachrichtigungs-Postback konfigurieren möchten, und wählen Sie [Bearbeiten].

2. Verwenden Sie die folgende Tabelle, um die Zustellungseinstellungen zu konfigurieren:

Feld	Beschreibung
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) Fügen Sie benutzerdefinierte Header zur Authentifizierung hinzu (z. B. Authorization: Bearer token).
Mindestverzögerung	Festlegen Mindestverzögerung in Sekunden, um Ihren Server vor Lastspitzen zu schützen.
Maximale Anfragen	Festlegen Maximale Anfragen pro Sekunde, um Ihren Server vor Lastspitzen zu schützen.
Erfolgsantwort	Die konkrete Textzeichenfolge oder der HTTP-Statuscode, den Ihr Server zurückgibt, wenn ein Postback korrekt verarbeitet wurde.
Fehlerantwort	Die Textzeichenfolge oder der Statuscode, der einen Fehler anzeigt (z. B. ERROR oder 500).

Benachrichtigungsereignisse und Payloads

Jede Ereignisbenachrichtigung sendet einen eindeutigen Satz konfigurierbarer Datenpunkte (z. B. {ActionId}). Informationen dazu, welche Datenpunkte Sie aus den Payloads extrahieren können, finden Sie in den folgenden Ereignissen.

Ereignisse im Lebenszyklus von Aktionen

Ereignisse im Lebenszyklus von Aktionen senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn eine Aktion erfasst, geändert oder rückgängig gemacht wird.

// Beispiel für einen POST 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 der Aktion an den Partner, in der Währung des Partners
  "DeltaPayout": -5.00, // Korrigierter Auszahlungsbetrag aus der vorherigen Aktion
  "IntendedPayout": 15.50, // Beabsichtigter Auszahlungsbetrag für eine Aktion mit Überschreitung
  "Amount": 100.00, // Aktionsbetrag, in der Kontowährung
  "DeltaAmount": -50.00, // Korrigierter Betrag aus der vorherigen Aktion
  "IntendedAmount": 150.00, // Beabsichtigter Verkaufsbetrag für eine Aktion mit Überschreitung
  "Currency": "USD", // Währung für die Aktion
  "OriginalCurrency": "USD", // Ursprüngliche Währung (d. h. Warenkorb-Währung) für die Aktion
  "OriginalAmount": 100.00, // Ursprünglicher Betrag (d. h. Warenkorb-Betrag) für die Aktion
  // Sammlung "items": Daten für einzelne Artikel 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 Conversion
  "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", // Geplanter Ausgleichszeitpunkt
  "ReferringDomain": "blog.partner.com", // Verweisende Domain
  "LandingPageUrl": "https://brand.com/sale", // URL der Landingpage
  "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 Klickkennung
  "SharedId": "social_post_01", // Vom Partner geteilte ID
  "PromoCode": "SAVE20", // Allgemeiner Promo-Code
  "CustomerStatus": "EXISTING", // Kundenstatus
  "Oid": "ORD-554433", // Bestell-ID
  "Note": "Teilrücksendung verarbeitet", // Mit der Aktion übermittelte Notiz
  "CustomerPostCode": "94105", // Postleitzahl des Kunden
  "CustomerCity": "San Francisco", // Kundenstadt
  "CustomerCountry": "US", // Ländercode des Kunden
  "CustomerRegion": "CA", // Kundenregion
  "CustomerId": "CUST-12345", // Kunden-ID
  "CustomerEmail": "a665a45920422f9d417...", // Gehashte E-Mail-Adresse des Kunden
  "IpAddress": "192.168.1.1", // IP-Adresse
  "CallerId": null, // Telefonnummer des Anrufers
  // Benutzerdefinierte Zusatzfelder
  "Text1": "Benutzerdefinierter Wert 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", // Paket der mobilen App
  "appName": "BrandStore", // Name der mobilen App
  "appVersion": "4.2.1", // Version der mobilen App
  "deviceOs": "iOS", // Betriebssystem des Geräts
  "deviceOsVersion": "17.4", // Betriebssystemversion des Geräts
  "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", // Einstellung für iOS-Werbetracking
  "androidId": null, // Android-ID
  "deviceId": "D-556677", // Geräte-ID
  "deviceIp": "192.168.1.1" // Geräte-IP
}

Ereignisse für Aktionsanfragen

Ereignisse für Aktionsanfragen senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionsanfragen erstellt oder gelöst werden.

// Beispiel für einen POST 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", // Typ der Aktionsanfrage
  "ExpectedPayout": 25.00, // Vom Partner erwarteter Auszahlungsbetrag
  "ResolutionDeadlineDate": "2026-05-01T00:00:00Z", // Datum, bis zu dem die Anfrage angenommen 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 bestehenden Aktion verknüpft)
  "AutoApprovalDate": "2026-05-05T00:00:00Z", // Datum, an dem das System die Regeln für die automatische Genehmigung ausführt
  "ResolutionStatus": "PENDING", // Endgültiger Lösungsstatus für die Aktionsanfrage
  "RejectReason": null, // Grund, warum die Aktionsanfrage abgelehnt wurde
  "FinalPayout": 0.00, // Die endgültige Auszahlung im Zusammenhang mit der Aktionsanfrage
  "ResolutionDate": null, // Datum, an dem die Anfrage entschieden wurde
  "CreationDate": "2026-04-08T10:05:00Z", // Datum, an dem die Anfrage im System erstellt wird
  "InquiryNotes": "Der Kunde behauptet, auf den Link geklickt zu haben, aber es wurde keine Gutschrift angezeigt.", // Von dem Partner übermittelte Notizen zur Anfrage
  "ResolutionNotes": null, // Bei der Entscheidung der Anfrage übermittelte Notizen
  "Comments": "[{\"user\": \"support_agent\", \"text\": \"Prüfe jetzt die Klickprotokolle.\"}, {\"user\": \"partner\", \"text\": \"Kunde hat den Beleg vorgelegt.\"}]" // Zur Anfrage hinzugefügte Kommentare (im JSON-Format)
}

Ereignisse zum Ausgleich von Aktionen

Ereignisse zum Ausgleich von Aktionen senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionen ausgeglichen werden.

// Beispiel für einen POST 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 ausgeglichen werden soll
  "LedgerDate": "2026-04-08T09:54:43Z" // Datum (ISO 8601), an dem die Aktion ausgeglichen wurde
}

Tracking-Wert-Anfrageereignisse

Tracking-Wert-Anfrageereignisse senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Tracking-Anfragen erstellt werden.

// Beispiel für einen POST 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 Währung des Kontos
  "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", // Konversionsdatum
  "IpAddress": "192.168.1.1", // IP-Adresse des Geräts
  "RefClickId": "CLK9988776655" // Eindeutige Klickkennung
}

Abgeschlossene-Job-Ereignisse

Abgeschlossene-Job-Ereignisse senden eine HTTP-Anfrage an eine angegebene URL (und alle zusätzlichen Parameter), wenn ein Job für einen abgeschlossen wurde Berichtsexport oder Klick-Export.

// Beispiel für einen POST im JSON-Format
{
  "JobId": 10293847, // Eindeutige ID des Jobs
  "JobType": "REPORT_EXPORT", // Der Job-Typ
  "AccountId": 7744, // Konto-ID
  "StartDate": "2026-04-08T10:00:05Z", // Zeitpunkt, zu dem der Job gestartet wurde
  "EndDate": "2026-04-08T10:11:02Z", // Zeitpunkt, zu dem der Job abgeschlossen wurde
  "RecordsProcessed": 5240, // Anzahl der verarbeiteten oder generierten Datensätze
  "ApiJobDetailUri": "https://api.impact.com/jobs/10293847", // API-URI für weitere Details zum Job
  "ApiResultUri": "https://api.impact.com/jobs/10293847/result", // API-URI zum Abrufen des Ergebnisses der Job-Ausgabe
  "ResultDownloadUrlExp5": "https://download.impact.com/file?token=a1b2...&exp=5min", // URL zum Herunterladen der Ausgabe (Ablauf in 5 Minuten)
  "ResultDownloadUrlExp15": "https://download.impact.com/file?token=a1b2...&exp=15min", // URL zum Herunterladen der Ausgabe (Ablauf in 15 Minuten)
  "ResultDownloadUrlExp30": "https://download.impact.com/file?token=a1b2...&exp=30min", // URL zum Herunterladen der Ausgabe (Ablauf in 30 Minuten)
  "ResultDownloadUrlExp60": "https://download.impact.com/file?token=a1b2...&exp=60min" // URL zum Herunterladen der Ausgabe (Ablauf in 60 Minuten)
}

Publisher-Bewerbungsereignisse

Hinweis: Diese Funktion befindet sich in der Beta-Phase. Wenden Sie sich an Ihren CSM oder an unseren Support-Team wenn Sie diese Funktion testen möchten.

Publisher-Bewerbungsereignisse senden 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.

Publisher-Bewerbungsereignisse sind auch bekannt als Contract-Event-Postback, Application-Processing-Webhook oder Application-Webhook.

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 zuvor leere Felder aus und stellen sicher, dass Ihre Datensätze mit den neuesten verarbeiteten Informationen synchron bleiben.

Wichtig: Wenn Sie Bewerbungs-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.

Um zu sehen, wie dieser Webhook zusammen mit dem Recruitment Agent funktioniert, siehe Recruitment Agent.

Der Inhalt der Payload variiert je nach Status. Das folgende Beispiel zeigt ein PENDING Ereignis, mit Kommentaren, die angeben, welche Felder für andere Status angezeigt werden.

// Beispiel für einen POST im JSON-Format
{
  "Status": "PENDING", // Status der Bewerbung: PENDING, APPROVED, REJECTED, RETRACTED
  "ProgramId": "9876", // Programm-ID
  "TemplateTermsId": "4455", // Vorlagenbedingungen-ID
  "ContractId": "112233", // Vertrags-ID
  "ApplicationDate": "2026-04-09T08:30:00Z", // Bewerbungsdatum
  "PublisherSignerName": "Sarah Chen", // Vom Publisher-Benutzer verarbeitet von
  "PublisherId": "555", // Partner-ID
  "Name": "Elite Content Creators", // Partnername
  "BusinessModel": "SOCIAL_INFLUENCER", // Primäres Geschäftsmodell des Partners
  "Address": "123 Marketing Way", // Straßenadresse
  "City": "Los Angeles", // Stadt
  "State": "CA", // Bundesstaat
  "Country": "US", // Land

  // nur APPROVED, REJECTED, RETRACTED
  "DecisionDate": null, // Entscheidungsdatum

  // nur APPROVED
  "ContractStartDate": null, // Datum des Vertragsbeginns

  // nur REJECTED
  "DeclineReason": null, // Ablehnungsgrund

  // nur APPROVED, REJECTED
  "AdvertiserSignerName": null, // Vom Advertiser-Benutzer verarbeitet von

  // nur PENDING: Partnerprofilfelder
  "Description": "Ein Premium-Netzwerk aus Lifestyle- und Reise-Influencern.", // Beschreibung des Partnerprofils
  "Language": "en-US", // Sprache
  "PublisherSize": "M", // XS, S, M, L, XL
  "PastRelationship": "false", // Boolean, der einen früheren Vertrag angibt
  "MarketplaceApproved": "true", // Boolean, der den Marketplace-Status angibt
  "ReceivedPayout": "true", // Boolean, der angibt, ob eine Auszahlung erhalten wurde

  // nur PENDING: Mit dem Partner verknüpfte Medien-Properties
  "properties": [{join(properties, i, "{\"platform\":\"{i.platform}\",\"verified\":\"{i.verified}\",\"url\":\"{i.url}\",\"category\":\"{i.category}\",\"reach\":\"{i.reach}\",\"engagementRate\":\"{i.engagementRate}\",\"audienceCountryPct\":\"{i.audienceCountryPct}\",\"audienceGenderPct\":\"{i.audienceGenderPct}\",\"audienceAgeRangePct\":\"{i.audienceAgeRangePct}\"}")}],

  // nur PENDING: Demografische Felder des Creators
  "CreatorIncome": "", // Haushaltseinkommen
  "CreatorGender": "", // Geschlecht
  "CreatorEthnicity": "", // Ethnie
  "CreatorEducation": "", // Bildungsniveau
  "CreatorRelationshipStatus": "", // Beziehungsstatus
  "CreatorParentalStatus": "", // Elternstatus
  "CreatorPronouns": "", // Pronomen
  "CreatorDOB": "", // Geburtsdatum

  // nur PENDING: Gruppen-IDs
  "GroupIds": "1001,1002,1003" // Durch Kommas getrennte Gruppen-IDs
}

Wiederholungsmechanismus für Postbacks

Wenn ein Postback beim Versuch, an die Ziel-URL zu senden, fehlschlägt, wird die Zustellung gemäß einem festen Zeitplan automatisch bis zu 15 Mal erneut versucht. Wiederholungen helfen, vorübergehende Netzwerkprobleme oder die Nichtverfügbarkeit des Servers abzufangen.

Bedingungen, unter denen keine Wiederholungen erfolgen

Ein Postback wird in den folgenden Fällen nicht erneut versucht:

• Die Ziel-URL ist fehlerhaft formatiert oder ungültig.

• Die Ziel-URL oder ihr Host lässt sich nicht auflösen, zum Beispiel aufgrund eines DNS-Lookup-Fehlers.

Wiederholungsplan

Die Wiederholungsversuche folgen dem folgenden Zeitplan. Die Wiederholungen 1, 2 und 3 werden übersprungen, wenn der HTTP-Antwortcode im Bereich von 400 auswählen, um 500.

Referenz zum Wiederholungsplan

Wiederholungsversuch	Verzögerung vor der Wiederholung
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