> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md). # Aktivieren Sie Event-Benachrichtigungs-Postbacks für Marken Event-Benachrichtigungs-Postbacks (Webhooks) benachrichtigen Ihre internen Systeme in Echtzeit, wenn bestimmte Ereignisse eintreten. Die gesendeten Daten variieren je nach Ereignis, aber der Konfigurationsprozess ist für alle gleich. {% stepper %} {% step %} ## Auf Event-Benachrichtigungs-Postbacks zugreifen 1. Wählen Sie in der oberen Navigationsleiste ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Benutzerprofil] → Einstellungen**. 2. Unter dem *Technisch* Bereich wählen Sie [**Event-Benachrichtigungen**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?). {% endstep %} {% step %} ## Globale Konfigurationsfelder ausfüllen 1. Fahren Sie mit der Maus über das Ereignis, für das Sie ein Benachrichtigungs-Postback konfigurieren möchten, und wählen Sie ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Bearbeiten]**. 2. Verwenden Sie die folgende Tabelle, um die Zustellungsoptionen zu konfigurieren:
FeldBeschreibung
URLDer Endpunkt auf Ihrem Server, der die Daten empfängt.
HTTP-Methode

GET: Die Daten werden als Query-Strings an die URL angehängt.

POST: Die 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 dem Payload-Inhalt.

HTTP-Header(Optional) Fügen Sie benutzerdefinierte Header zur Authentifizierung hinzu (z. B. Authorization: Bearer-Token).
MindestverzögerungLegen Sie Mindestverzögerung in Sekunden fest, um Ihren Server vor Lastspitzen zu schützen.
Maximale AnfragenLegen Sie Maximale Anfragen pro Sekunde fest, um Ihren Server vor Lastspitzen zu schützen.
ErfolgsantwortDie spezifische Textzeichenfolge oder der HTTP-Statuscode, den Ihr Server zurückgibt, wenn ein Postback korrekt verarbeitet wurde.
FehlerantwortDie Textzeichenfolge oder der Statuscode, der auf einen Fehler hinweist (z. B. ERROR oder 500).
{% endstep %} {% endstepper %} ## Benachrichtigungsereignisse & Payloads Jede Ereignisbenachrichtigung sendet einen eindeutigen Satz konfigurierbarer Datenpunkte (z. B. `{ActionId}`). Siehe die folgenden Ereignisse, um zu erfahren, welche Datenpunkte Sie aus den Payloads extrahieren können.
Ereignisse im Aktions-Lebenszyklus Ereignisse im Aktions-Lebenszyklus senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn eine Aktion erfasst, geändert oder rückgängig gemacht wird. ```json // Ein POST-Beispiel im JSON-Format { "CampaignId": 9876, // Programm-ID "ActionTrackerId": 12345, // Event-Typ-ID "MediaPartnerId": 555, // Partner-ID "CampaignName": "Spring Global Promotion", // Programmname "ActionTrackerName": "Standard Sale Tracker", // Name des Event-Typs "MediaPartnerName": "Top Tier Affiliates", // Partnername "ActionId": "ACT-778899", // Aktions-ID "Status": "MODIFIED", // Aktionsstatus "StatusDetail": "Item return - payout adjusted", // Weitere Details zum Aktionsstatus "AdId": 44332, // Anzeigen-ID "Payout": 10.50, // Auszahlung an den Partner in der Währung des Partners "DeltaPayout": -5.00, // Korrigierter Auszahlungsbetrag aus der vorherigen Aktion "IntendedPayout": 15.50, // Vorgesehener Auszahlungsbetrag für eine Aktion über dem Limit "Amount": 100.00, // Aktionsbetrag in der Kontowährung "DeltaAmount": -50.00, // Korrigierter Betrag aus der vorherigen Aktion "IntendedAmount": 150.00, // Vorgesehener 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 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 Konversion "CreationDate": "2026-04-08T09:05:00Z", // Im System erstelltes Datum "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", // Verweisende 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", // Ländercode des Kunden (aus IP abgeleitet) "RefClickId": "CLK9988776655", // Eindeutige Klick-ID "SharedId": "social_post_01", // Geteilte Partner-ID "PromoCode": "SAVE20", // Allgemeiner Promo-Code "CustomerStatus": "EXISTING", // Kundenstatus "Oid": "ORD-554433", // Bestell-ID "Note": "Partial return processed", // Mit der Aktion angegebene Notiz "CustomerPostCode": "94105", // Postleitzahl des Kunden "CustomerCity": "San Francisco", // Kundenstadt "CustomerCountry": "US", // Land des Kunden "CustomerRegion": "CA", // Kundenregion "CustomerId": "CUST-12345", // Kunden-ID "CustomerEmail": "a665a45920422f9d417...", // Gehashte E-Mail des Kunden "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", // 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", // Version des Geräte-Betriebssystems "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-Werbetracking-Einstellung "androidId": null, // Android-ID "deviceId": "D-556677", // Geräte-ID "deviceIp": "192.168.1.1" // Geräte-IP } ```
Ereignisse zu Aktionsanfragen Ereignisse zu Aktionsanfragen senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionsanfragen erstellt oder gelöst werden. ```json // 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", // Typ der Aktionsanfrage "ExpectedPayout": 25.00, // Vom Partner erwartete 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 einer vorhandenen Aktion zugeordnet) "AutoApprovalDate": "2026-05-05T00:00:00Z", // Datum, an dem das System die automatischen Genehmigungsregeln ausführt "ResolutionStatus": "PENDING", // Endgültiger Abschlussstatus der Aktionsanfrage "RejectReason": null, // Grund, warum die Aktionsanfrage abgelehnt wurde "FinalPayout": 0.00, // Die endgültige Auszahlung der Aktionsanfrage "ResolutionDate": null, // Datum der Entscheidung über die Anfrage "CreationDate": "2026-04-08T10:05:00Z", // Datum, an dem die Anfrage im System erstellt wird "InquiryNotes": "Customer claims they clicked the link but no credit was shown.", // Vom Partner übermittelte Anmerkungen zur Anfrage "ResolutionNotes": null, // Bei der Entscheidung über die Anfrage übermittelte Anmerkungen "Comments": "[{\"user\": \"support_agent\", \"text\": \"Verifying click logs now.\"}, {\"user\": \"partner\", \"text\": \"Customer provided receipt.\"}]" // Zur Anfrage hinzugefügte Kommentare (im JSON-Format) } ```
Ereignisse zur Aktionsfreigabe Ereignisse zur Aktionsfreigabe senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionen freigegeben werden. ```json // Ein POST-Beispiel im JSON-Format { "ActionTrackerId": 12345, // Event-Typ-ID "ActionTrackerName": "Standard Sale Tracker", // Name des Event-Typs "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 Ereignisse für Tracking-Wert-Anfragen senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Tracking-Anfragen erstellt werden. ```json // Ein POST-Beispiel im JSON-Format { "CampaignId": 9876, // Programm-ID "ActionTrackerId": 12345, // Event-Typ-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", // Konversionsdatum "IpAddress": "192.168.1.1", // IP-Adresse des Geräts "RefClickId": "CLK9988776655" // Eindeutige Klick-ID } ```
Ereignisse für abgeschlossene Jobs Ereignisse für abgeschlossene Jobs senden eine HTTP-Anfrage an eine angegebene URL (und alle zusätzlichen Parameter), wenn ein Job abgeschlossen wurde für einen [Berichtsexport](https://integrations.impact.com/brand-api-reference/reference/report-export/report-export) oder [Klick-Export](https://integrations.impact.com/brand-api-reference/reference/clicks/clickexport). ```json // Ein POST-Beispiel im JSON-Format { "JobId": 10293847, // Eindeutige Job-ID "JobType": "REPORT_EXPORT", // Der Typ des Jobs "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 erzeugten 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, um das Ergebnis der Ausgabe des Jobs abzurufen "ResultDownloadUrlExp5": "https://download.impact.com/file?token=a1b2...&exp=5min", // URL zum Herunterladen der Ausgabe (Ablauf nach 5 Minuten) "ResultDownloadUrlExp15": "https://download.impact.com/file?token=a1b2...&exp=15min", // URL zum Herunterladen der Ausgabe (Ablauf nach 15 Minuten) "ResultDownloadUrlExp30": "https://download.impact.com/file?token=a1b2...&exp=30min", // URL zum Herunterladen der Ausgabe (Ablauf nach 30 Minuten) "ResultDownloadUrlExp60": "https://download.impact.com/file?token=a1b2...&exp=60min" // URL zum Herunterladen der Ausgabe (Ablauf nach 60 Minuten) } ```
Publisher-Bewerbungsereignisse {% hint style="success" %} **Hinweis:** Diese Funktion befindet sich in der Beta-Phase. Wenden Sie sich an Ihren CSM oder unser [Support-Team](https://app.impact.com/support/portal.ihtml?createTicket=true&) wenn Sie diese Funktion testen möchten. {% endhint %} 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. Wenn ein `PENDING` Payload mit leeren Datenpunkten ausgeliefert 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. {% hint style="warning" %} **Wichtig:** Wenn Sie [Bewerbungs-Workflows](/brand/de/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing.md) 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. {% endhint %} Der Payload-Inhalt variiert je nach *Status*. Das folgende Beispiel zeigt ein `PENDING` Ereignis, mit Kommentaren, die angeben, welche Felder bei anderen Statuswerten erscheinen. ```json // Ein POST-Beispiel im JSON-Format { "Status": "PENDING", // Bewerbungsstatus: 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-Unterzeichner verarbeitet "PublisherId": "555", // Publisher-ID "Name": "Elite Content Creators", // Partnername "BusinessModel": "SOCIAL_INFLUENCER", // Hauptgeschä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, // Grund für die Ablehnung // Nur APPROVED, REJECTED "AdvertiserSignerName": null, // Vom Advertiser-Unterzeichner verarbeitet // Nur PENDING: Partnerprofilfelder "Description": "A premium network of lifestyle and travel influencers.", // Beschreibung des Partnerprofils "Language": "en-US", // Sprache "PublisherSize": "M", // XS, S, M, L, XL "PastRelationship": "false", // Boolescher Wert, der einen früheren Vertrag angibt "MarketplaceApproved": "true", // Boolescher Wert, der den Marketplace-Status angibt "ReceivedPayout": "true", // Boolescher Wert, der angibt, ob sie eine Auszahlung erhalten haben // 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, es an die Ziel-URL zu senden, fehlschlägt, wird die Zustellung automatisch nach einem festen Zeitplan 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, beispielsweise aufgrund eines DNS-Lookup-Fehlers. ### Wiederholungsplan Die Wiederholungsversuche folgen dem folgenden Zeitplan. Wiederholung 1, 2 und 3 werden übersprungen, wenn der HTTP-Antwortcode im Bereich von `400` bis `500`.
Referenz für den Wiederholungsplan
WiederholungsversuchVerzö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
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/de/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.