> 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). # Ereignis-Benachrichtigungs-Postbacks für Marken aktivieren Event-Benachrichtigungs-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. {% stepper %} {% step %} ### Zugriff auf Event-Benachrichtigungs-Postbacks 1. Wählen Sie in der oberen Navigationsleiste ![](/files/b499afb31802cd63f4cfb233fcf9c95589389524) **\[Benutzerprofil] → Einstellungen**. 2. Unter dem *Technischen* Bereich auswählen [**Ereignisbenachrichtigungen**](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 ![](/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: Daten werden als Query-Strings an die URL angehängt.

POST: Daten werden im Anfrage-Body gesendet, der verschiedene optionale Parameter enthält, die Sie festlegen können.

Weitere Informationen zu 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 Traffic-Spitzen zu schützen. | | Maximale Anfragen | Festlegen *Maximale Anfragen* pro Sekunde, um Ihren Server vor Traffic-Spitzen zu schützen. | | Erfolgsantwort | Die spezifische 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`). | | {% endstep %} | | | {% endstepper %} | | ### Benachrichtigungsereignisse & Payloads Jede Ereignisbenachrichtigung sendet einen eindeutigen Satz konfigurierbarer Datenpunkte (z. B., `{ActionId}`). Sehen Sie sich die folgenden Ereignisse an, um zu erfahren, welche Datenpunkte Sie aus den Payloads extrahieren können.
Aktions-Lebenszyklusereignisse Aktions-Lebenszyklusereignisse 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, // 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", // Änderungsstatus der Aktion "StatusDetail": "Item return - payout adjusted", // Weitere Details zum Status der Aktion "AdId": 44332, // Anzeigen-ID "Payout": 10.50, // Auszahlungsbetrag der Aktion 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 mit Überschreitung "Amount": 100.00, // Aktionsbetrag, in der Kontowährung "DeltaAmount": -50.00, // Korrigierter Betrag aus der vorherigen Aktion "IntendedAmount": 150.00, // Der vorgesehene Verkaufsbetrag für eine Aktion mit Überschreitung "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", // Konversionsdatum "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 Datum für die Freigabe "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", // Kundenlandescode (aus IP abgeleitet) "RefClickId": "CLK9988776655", // Eindeutige Klick-ID "SharedId": "social_post_01", // Vom Partner geteilte ID "PromoCode": "SAVE20", // Allgemeiner Promo-Code "CustomerStatus": "EXISTING", // Kundenstatus "Oid": "ORD-554433", // Bestell-ID "Note": "Partial return processed", // Mit der Aktion übergebene Notiz "CustomerPostCode": "94105", // Postleitzahl des Kunden "CustomerCity": "San Francisco", // Kundenstadt "CustomerCountry": "US", // Kundenlandescode "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, // Geldbetrag 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-Ad-Tracking-Einstellung "androidId": null, // Android-ID "deviceId": "D-556677", // Geräte-ID "deviceIp": "192.168.1.1" // Geräte-IP } ```
Aktionsanfrageereignisse Aktionsanfrageereignisse 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, // Eindeutiger Bezeichner 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", // Das 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", // Das Datum, an dem das System die automatischen Genehmigungsregeln ausführt "ResolutionStatus": "PENDING", // Der endgültige Lösungsstatus für die Aktionsanfrage "RejectReason": null, // Grund, warum die Aktionsanfrage abgelehnt wurde "FinalPayout": 0.00, // Der endgültige Auszahlungsbetrag im Zusammenhang mit der Aktionsanfrage "ResolutionDate": null, // Das 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, auf den Link geklickt zu haben, aber es wurde keine Gutschrift angezeigt.", // Vom Partner eingereichte Anmerkungen zur Anfrage "ResolutionNotes": null, // Anmerkungen, die eingereicht wurden, als über die Anfrage entschieden wurde "Comments": "[{\\\"user\\\": \\\"support_agent\\\", \\\"text\\\": \\\"Klickeinträge werden jetzt überprüft.\\\"}, {\\\"user\\\": \\\"partner\\\", \\\"text\\\": \\\"Der Kunde hat einen Beleg bereitgestellt.\\\"}]" // Der Anfrage hinzugefügte Kommentare (im JSON-Format) } ```
Aktions-Freigabeereignisse Aktions-Freigabeereignisse 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, // 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 } ```
Tracking-Wert-Anfrageereignisse Tracking-Wert-Anfrageereignisse 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, // 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 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 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 ein [Berichtsexport](https://integrations.impact.com/impact-brand/reference/export-reports) oder [Klickexport](https://integrations.impact.com/impact-brand/reference/retrieve-export-click). ```json // Ein POST-Beispiel im JSON-Format { "JobId": 10293847, // Eindeutige ID des Jobs "JobType": "REPORT_EXPORT", // Die Art des Jobs "AccountId": 7744, // Kontonummer "StartDate": "2026-04-08T10:00:05Z", // Die Zeit, zu der der Job gestartet wurde "EndDate": "2026-04-08T10:11:02Z", // Die Zeit, zu der der Job abgeschlossen wurde "RecordsProcessed": 5240, // Die Anzahl der verarbeiteten oder generierten Datensätze "ApiJobDetailUri": "https://api.impact.com/jobs/10293847", // API-URI, um weitere Details zum Job abzurufen "ApiResultUri": "https://api.impact.com/jobs/10293847/result", // API-URI, um das Ergebnis der Jobausgabe 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 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 %} 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 `PENDING` Payload mit leeren Datenpunkten ausgeliefert wird, ist das System darauf ausgelegt, Aktualisierungen auszulösen, sobald Informationen verfügbar werden. Nachfolgende erfolgreiche Übermittlungen füllen diese zuvor leeren Felder mit Daten 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 %} Die Payload-Inhalte variieren je nach *Status*. Das folgende Beispiel zeigt ein `PENDING` Ereignis, wobei Kommentare angeben, welche Felder bei anderen Status angezeigt werden. ```json // Ein POST-Beispiel 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", // Name des Bearbeiters auf Publisher-Seite "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 bei APPROVED, REJECTED, RETRACTED "DecisionDate": null, // Datum der Entscheidung // nur bei APPROVED "ContractStartDate": null, // Datum des Vertragsbeginns // nur bei REJECTED "DeclineReason": null, // Ablehnungsgrund // nur bei APPROVED, REJECTED "AdvertiserSignerName": null, // Name des bearbeitenden Werbetreibenden-Benutzers // nur bei PENDING: Felder des Partnerprofils "Description": "Ein Premium-Netzwerk von Lifestyle- und Reise-Influencern.", // Beschreibung des Partnerprofils "Language": "en-US", // Sprache "PublisherSize": "M", // XS, S, M, L, XL "PastRelationship": "false", // Boolescher Wert, der einen vorherigen Vertrag angibt "MarketplaceApproved": "true", // Boolescher Wert, der den Marketplace-Status angibt "ReceivedPayout": "true", // Boolescher Wert, der angibt, ob eine Auszahlung erhalten wurde // nur bei 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 bei PENDING: demografische Merkmale des Creators "CreatorIncome": "", // Haushaltseinkommen "CreatorGender": "", // Geschlecht "CreatorEthnicity": "", // Ethnizität "CreatorEducation": "", // Bildungsniveau "CreatorRelationshipStatus": "", // Beziehungsstatus "CreatorParentalStatus": "", // Elternstatus "CreatorPronouns": "", // Pronomen "CreatorDOB": "", // Geburtsdatum // nur bei 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 posten, fehlschlägt, wird die Übermittlung automatisch nach einem festgelegten Zeitplan bis zu 15 Mal erneut versucht. Wiederholungen helfen, vorübergehende Netzwerkprobleme oder die Nichtverfügbarkeit des Servers abzudecken. #### 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. Wiederholung 1, 2 und 3 werden übersprungen, wenn der HTTP-Antwortcode im Bereich von `400` bis `500`.
Referenz zum Wiederholungsplan
WiederholungsversuchVerzögerung vor 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.