> 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). # Event-Benachrichtigungs-Postbacks für Marken aktivieren Event-Benachrichtigungs-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. {% stepper %} {% step %} ### Auf Event-Benachrichtigungs-Postbacks zugreifen 1. Wählen Sie in der oberen Navigationsleiste ![](/files/4fa7c3e47e2dc9a63e140c0862eeab4caaaca16f) **\[Benutzerprofil] → Einstellungen**. 2. Unter dem *Technisch* Abschnitt wählen Sie [**Event-Benachrichtigungen**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?). {% endstep %} {% step %} ### Füllen Sie die globalen Konfigurationsfelder aus 1. Bewegen Sie den Mauszeiger über das Ereignis, für das Sie ein Benachrichtigungs-Postback konfigurieren möchten, und wählen Sie ![](/files/eb5fd4ef68cfbfdebcf98ff80916540d58802134) **\[Bearbeiten]**. 2. Verwenden Sie die folgende Tabelle, um die Übermittlungseinstellungen zu konfigurieren: | Feld | Beschreibung | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | URL | Der 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.

Siehe Benachrichtigungsereignisse und Payloads für weitere Informationen zu jedem Ereignis und zum Payload-Inhalt.

| | HTTP-Header | (Optional) Fügen Sie benutzerdefinierte Header für die Authentifizierung hinzu (z. B., `Authorization: Bearer-Token`). | | Mindestverzögerung | Legen Sie *Mindestverzögerung* in Sekunden fest, um Ihren Server vor Lastspitzen zu schützen. | | Maximale Anfragen | Legen 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 einen Fehler anzeigt (z. B., `FEHLER` 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 Aktionslebenszyklus Ereignisse im Aktionslebenszyklus senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn eine Aktion erfasst, geändert oder zurückgesetzt wird. ```json // Ein POST-Beispiel im JSON-Format { "CampaignId": 9876, // Programm-ID "ActionTrackerId": 12345, // ID des Ereignistyps "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, // Ad-ID "Payout": 10.50, // Aktionsauszahlung an den Partner, in der Währung des Partners "DeltaPayout": -5.00, // Die Ä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 der Aktion "OriginalCurrency": "USD", // Ursprüngliche (d. h. Warenkorb-)Währung der Aktion "OriginalAmount": 100.00, // Ursprünglicher (d. h. Warenkorb-)Betrag der Aktion // "items"-Sammlung: 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, an dem im System erstellt wurde "LockingDate": "2026-05-08T00:00:00Z", // Datum, an dem die Aktion gesperrt wird "ClearedDate": "2026-05-15T00:00:00Z", // Datum, an dem die Aktion abgerechnet werden soll "ReferringDomain": "blog.partner.com", // Verweisdomain "LandingPageUrl": "https://brand.com/sale", // URL der Landingpage "RefCustomerArea": "California", // Kundenbereich (aus der IP abgeleitet) "RefCustomerCity": "San Francisco", // Kundenstadt (aus der IP abgeleitet) "RefCustomerRegion": "CA", // Kundenregion (aus der IP abgeleitet) "RefCustomerCountry": "US", // Ländercode des Kunden (aus der IP abgeleitet) "RefClickId": "CLK9988776655", // Eindeutige Klick-ID "SharedId": "social_post_01", // Gemeinsam genutzte Partner-ID "PromoCode": "SAVE20", // Allgemeiner Promo-Code "CustomerStatus": "EXISTING", // Kundenstatus "Oid": "ORD-554433", // Bestell-ID "Note": "Partial return processed", // Mit der Aktion übermittelte Notiz "CustomerPostCode": "94105", // Postleitzahl des Kunden "CustomerCity": "San Francisco", // Kundenstadt "CustomerCountry": "US", // Kundenland "CustomerRegion": "CA", // Kundenregion "CustomerId": "CUST-12345", // Kunden-ID "CustomerEmail": "a665a45920422f9d417...", // Gehashtes 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, // Betrag 1 "Numeric1": 1, // Numerisch 1 // Geräte- & 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", // OS-Version 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", // 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 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 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 vorhandenen 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 der 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 die Anfrage entschieden wurde "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 Anfragenotizen "ResolutionNotes": null, // Bei der Entscheidung über die Anfrage übermittelte Notizen "Comments": "[{\"user\": \"support_agent\", \"text\": \"Verifying click logs now.\"}, {\"user\": \"partner\", \"text\": \"Customer provided receipt.\"}]" // Der Anfrage hinzugefügte Kommentare (im JSON-Format) } ```
Ereignisse zur Aktionsabrechnung Ereignisse zur Aktionsabrechnung senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionen abgerechnet werden. ```json // Ein POST-Beispiel im JSON-Format { "ActionTrackerId": 12345, // ID des Ereignistyps "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 zur Abrechnung geplant ist "LedgerDate": "2026-04-08T09:54:43Z" // Datum (ISO 8601), an dem die Aktion abgerechnet wurde } ```
Ereignisse für Tracking-Wertanfragen Ereignisse für Tracking-Wertanfragen 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, // ID des Ereignistyps "MediaPartnerId": 555, // Partner-ID "ActionId": "ACT-778899", // Aktions-ID "Amount": 150.00, // Aktionsbetrag in der Währung des Kontos "Currency": "USD", // Währung der Aktion "Oid": "ORD-554433", // Bestell-ID // "items"-Sammlung: 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 Aufträge Ereignisse für abgeschlossene Aufträge senden eine HTTP-Anfrage an eine angegebene URL (und alle zusätzlichen Parameter), wenn ein Auftrag abgeschlossen wurde für ein [Berichtsexport](https://integrations.impact.com/brand-api-reference/reference/report-export/report-export) oder [Export anklicken](https://integrations.impact.com/brand-api-reference/reference/clicks/clickexport). ```json // Ein POST-Beispiel im JSON-Format { "JobId": 10293847, // Eindeutige ID des Auftrags "JobType": "REPORT_EXPORT", // Der Auftrags-Typ "AccountId": 7744, // Konto-ID "StartDate": "2026-04-08T10:00:05Z", // Zeitpunkt, zu dem der Auftrag gestartet wurde "EndDate": "2026-04-08T10:11:02Z", // Zeitpunkt, zu dem der Auftrag abgeschlossen wurde "RecordsProcessed": 5240, // Die Anzahl der verarbeiteten oder erzeugten Datensätze "ApiJobDetailUri": "https://api.impact.com/jobs/10293847", // API-URI, um weitere Details zum Auftrag abzurufen "ApiResultUri": "https://api.impact.com/jobs/10293847/result", // API-URI, um das Ergebnis der Ausgabe des Auftrags 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) } ```
Ereignisse für Publisher-Bewerbungen {% hint style="success" %} **Hinweis:** Diese Funktionalität befindet sich in der Beta. Kontaktieren Sie Ihren CSM oder unser [Support-Team](https://app.impact.com/support/portal.ihtml?createTicket=true&) wenn Sie diese Funktion testen möchten. {% endhint %} Ereignisse für Publisher-Bewerbungen 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 `AUSSTEHEND` Nutzlast mit leeren Datenpunkten übermittelt wird, ist das System darauf ausgelegt, Updates auszulösen, sobald Informationen verfügbar werden. Nachfolgende erfolgreiche Übermittlungen 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*: `GENEHMIGT` oder `ABGELEHNT` wenn ein Workflow die Bewerbung verarbeitet hat, `AUSSTEHEND` wenn kein Workflow angewendet wurde, oder `ZURÜCKGEZOGEN` wenn der Partner die Bewerbung zurückgezogen hat. {% endhint %} Der Inhalt der Nutzlast variiert je nach *Status*. Das folgende Beispiel zeigt ein `AUSSTEHEND` Ereignis, wobei Kommentare angeben, welche Felder für andere Status erscheinen. ```json // Ein POST-Beispiel im JSON-Format { "Status": "AUSSTEHEND", // Bewerbungsstatus: AUSSTEHEND, GENEHMIGT, ABGELEHNT, ZURÜCKGEZOGEN "ProgramId": "9876", // Programm-ID "TemplateTermsId": "4455", // Vorlagenbedingungen-ID "ContractId": "112233", // Vertrags-ID "ApplicationDate": "2026-04-09T08:30:00Z", // Datum der Bewerbung "PublisherSignerName": "Sarah Chen", // Vom Publisher-Benutzer verarbeitet "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", // Bundesland "Country": "US", // Land // nur GENEHMIGT, ABGELEHNT, ZURÜCKGEZOGEN "DecisionDate": null, // Entscheidungsdatum // nur GENEHMIGT "ContractStartDate": null, // Datum des Vertragsbeginns // nur ABGELEHNT "DeclineReason": null, // Ablehnungsgrund // nur GENEHMIGT, ABGELEHNT "AdvertiserSignerName": null, // Vom Werbetreibenden-Benutzer verarbeitet // nur AUSSTEHEND: 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 Marktplatzstatus angibt "ReceivedPayout": "true", // Boolescher Wert, der angibt, ob sie eine Auszahlung erhalten haben // nur AUSSTEHEND: 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 AUSSTEHEND: Demografische Felder des Creators "CreatorIncome": "", // Haushaltseinkommen "CreatorGender": "", // Geschlecht "CreatorEthnicity": "", // Ethnische Zugehörigkeit "CreatorEducation": "", // Bildungsniveau "CreatorRelationshipStatus": "", // Beziehungsstatus "CreatorParentalStatus": "", // Elternstatus "CreatorPronouns": "", // Pronomen "CreatorDOB": "", // Geburtsdatum // nur AUSSTEHEND: 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 posten, fehlschlägt, wird die Übermittlung 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 wird nicht aufgelöst, zum Beispiel aufgrund eines DNS-Lookup-Fehlers. #### Wiederholungsplan Die Wiederholungsversuche folgen dem untenstehenden Plan. Wiederholung 1, 2 und 3 werden übersprungen, wenn der HTTP-Antwortcode im Bereich von `400` bis `500`.
Referenz zum 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.