> 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 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. {% stepper %} {% step %} ## Auf Ereignisbenachrichtigungs-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 [**Ereignisbenachrichtigungen**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?). {% endstep %} {% step %} ## 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 ![](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 Zustellungseinstellungen zu konfigurieren:
FeldBeschreibung
URLDer 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ögerungFestlegen Mindestverzögerung in Sekunden, um Ihren Server vor Lastspitzen zu schützen.
Maximale AnfragenFestlegen Maximale Anfragen pro Sekunde, um Ihren Server vor Lastspitzen zu schützen.
ErfolgsantwortDie konkrete Textzeichenfolge oder der HTTP-Statuscode, den Ihr Server zurückgibt, wenn ein Postback korrekt verarbeitet wurde.
FehlerantwortDie Textzeichenfolge oder der Statuscode, der einen Fehler anzeigt (z. B. ERROR oder 500).
{% endstep %} {% endstepper %} ## 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. ```json // 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. ```json // 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. ```json // 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. ```json // 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](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 // 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 {% hint style="success" %} **Hinweis:** Diese Funktion befindet sich in der Beta-Phase. Wenden Sie sich an Ihren CSM oder an unseren [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. 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. {% 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 %} Um zu sehen, wie dieser Webhook zusammen mit dem Recruitment Agent funktioniert, siehe [Recruitment Agent](/brand/de/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md#see-where-the-agent-fits-with-your-existing-automation). 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. ```json // 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
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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.