> 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 je nach Ereignis, aber der Konfigurationsprozess ist für alle gleich. {% stepper %} {% step %} ### Auf Ereignisbenachrichtigungs-Postbacks zugreifen 1. Wählen Sie in der oberen Navigationsleiste ![](/files/4fa7c3e47e2dc9a63e140c0862eeab4caaaca16f) **\[Benutzerprofil] → Einstellungen**. 2. Unter der *Technisch* Abschnitt wählen Sie [**Ereignisbenachrichtigungen**](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 einen 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 empfangen wird. | | 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 Nutzdaten für weitere Informationen zu jedem Ereignis und zum Inhalt der Nutzdaten.

| | 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, um Ihren Server vor Lastspitzen zu schützen. | | Erfolgsantwort | Der genaue Textstring oder HTTP-Statuscode, den Ihr Server zurückgibt, wenn ein Postback korrekt verarbeitet wird. | | Fehlerantwort | Der Textstring oder Statuscode, der einen Fehler anzeigt (z. B., `ERROR` oder `500`). | | {% endstep %} | | | {% endstepper %} | | ### Benachrichtigungsereignisse & Nutzdaten Jedes Benachrichtigungsereignis sendet einen eindeutigen Satz konfigurierbarer Datenpunkte (z. B., `{ActionId}`). Siehe die folgenden Ereignisse, um zu erfahren, welche Datenpunkte Sie aus den Nutzdaten extrahieren können.
Aktionslebenszyklus-Ereignisse Aktionslebenszyklus-Ereignisse 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 // POST-Beispiel im JSON-Format { "CampaignId": 9876, // Programm-ID "ActionTrackerId": 12345, // Ereignistyp-ID "MediaPartnerId": 555, // Partner-ID "CampaignName": "Frühlings-Globalaktion", // Programmname "ActionTrackerName": "Standard-Verkaufstracker", // Name des Ereignistyps "MediaPartnerName": "Top-Tier-Affiliates", // Partnername "ActionId": "ACT-778899", // Aktions-ID "Status": "MODIFIED", // Aktionsstatus "StatusDetail": "Artikelrückgabe - Auszahlung angepasst", // Weitere Details zum Aktionsstatus "AdId": 44332, // Anzeigen-ID "Payout": 10.50, // Aktionsauszahlung an den Partner in der Währung des Partners "DeltaPayout": -5.00, // Änderung des Auszahlungsbetrags "IntendedPayout": 15.50, // Der vorgesehene Auszahlungsbetrag für eine Aktion, die das Limit überschreitet "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, die das Limit überschreitet "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 // "items"-Sammlung: Daten zu einzelnen Artikeln 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", // Datum, an dem die Freigabe geplant ist "ReferringDomain": "blog.partner.com", // Verweisende Domain "LandingPageUrl": "https://brand.com/sale", // URL der Zielseite "RefCustomerArea": "California", // Kundenregion (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 Klickkennung "SharedId": "social_post_01", // Geteilte ID des Partners "PromoCode": "SAVE20", // Allgemeiner Promo-Code "CustomerStatus": "EXISTING", // Kundenstatus "Oid": "ORD-554433", // Bestell-ID "Note": "Teilrückgabe verarbeitet", // Mit der Aktion übergebene Notiz "CustomerPostCode": "94105", // Postleitzahl des Kunden "CustomerCity": "San Francisco", // Stadt des Kunden "CustomerCountry": "US", // Ländercode des Kunden "CustomerRegion": "CA", // Region des Kunden "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 ergänzende Felder "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", // Hersteller des Geräts "deviceModel": "iPhone 15", // Gerätemodell "macAddress": "00:1B:44:11:3A:B7", // MAC-Adresse (Großbuchstaben) "macAddressLower": "00:1b:44:11:3a:b7", // MAC-Adresse (Kleinbuchstaben) "macAddressAlpha": "001B44113AB7", // MAC-Adresse (ohne Doppelpunkte) "macAddressSha1": "47a32...", // MAC-SHA1 "iosIfa": "EA7583CD-A667-48BC-B806-42ECB2B48606", // iOS-Werbe-ID "iosAdTracking": "1", // iOS-Einstellung für Anzeigen-Tracking "androidId": null, // Android-ID "deviceId": "D-556677", // Geräte-ID "deviceIp": "192.168.1.1" // Geräte-IP } ```
Aktionsanfrage-Ereignisse Aktionsanfrage-Ereignisse senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionsanfragen erstellt oder aufgelöst werden. ```json // 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": "Frühlings-Globalaktion", // 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 Auflösungsstatus der 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.", // Anfragenotizen, die vom Partner eingereicht wurden "ResolutionNotes": null, // Notizen, die bei der Entscheidung über die Anfrage eingereicht wurden "Comments": "[{\"user\": \"support_agent\", \"text\": \"Überprüfe jetzt die Klickprotokolle.\"}, {\"user\": \"partner\", \"text\": \"Der Kunde hat den Beleg bereitgestellt.\"}]" // Der Anfrage hinzugefügte Kommentare (im JSON-Format) } ```
Aktionsabrechnungs-Ereignisse Aktionsabrechnungs-Ereignisse senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionen abgerechnet werden. ```json // POST-Beispiel im JSON-Format { "ActionTrackerId": 12345, // Ereignistyp-ID "ActionTrackerName": "Standard-Verkaufstracker", // Name des Ereignistyps "CampaignId": 9876, // Programm-ID "CampaignName": "Frühlings-Globalaktion", // 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 voraussichtlich abgerechnet wird "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 // 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 für die 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 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 [Berichtsexport](https://integrations.impact.com/brand-api-reference/reference/report-export/report-export) oder [Auf Export klicken](https://integrations.impact.com/brand-api-reference/reference/clicks/clickexport). ```json // POST-Beispiel im JSON-Format { "JobId": 10293847, // Eindeutige Job-ID "JobType": "REPORT_EXPORT", // Der Job-Typ "AccountId": 7744, // Kontonummer "StartDate": "2026-04-08T10:00:05Z", // Der Zeitpunkt, an dem der Job gestartet wurde "EndDate": "2026-04-08T10:11:02Z", // Der Zeitpunkt, an dem der Job abgeschlossen wurde "RecordsProcessed": 5240, // Die 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 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. Wenden Sie sich an Ihren CSM oder an 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 zugestellt wird, ist das System darauf ausgelegt, Aktualisierungen auszulösen, sobald Informationen verfügbar werden. Nachfolgende erfolgreiche Zustellungen füllen diese zuvor leeren Felder aus, sodass 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` ausgelöst, 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 Inhalt der Nutzdaten variiert je nach *Status*. Das folgende Beispiel zeigt ein `PENDING` Ereignis, mit Kommentaren, die angeben, welche Felder bei anderen Status erscheinen. ```json // POST-Beispiel im JSON-Format { "Status": "PENDING", // Status der Bewerbung: PENDING, APPROVED, REJECTED, RETRACTED "ProgramId": "9876", // Programm-ID "TemplateTermsId": "4455", // ID der Vorlagenbedingungen "ContractId": "112233", // Vertrags-ID "ApplicationDate": "2026-04-09T08:30:00Z", // Bewerbungsdatum "PublisherSignerName": "Sarah Chen", // vom Publisher-Benutzer verarbeitet "PublisherId": "555", // Partner-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, // Datum der Entscheidung // Nur APPROVED "ContractStartDate": null, // Datum des Vertragsbeginns // Nur REJECTED "DeclineReason": null, // Grund für die Ablehnung // Nur APPROVED, REJECTED "AdvertiserSignerName": null, // vom Werbetreibenden-Benutzer verarbeitet // Nur PENDING: Felder des Publisher-Profils "Description": "Ein Premium-Netzwerk aus Lifestyle- und Reise-Influencern.", // Beschreibung des Publisher-Profils "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 Medieneigenschaften "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": "", // Ethnizität "CreatorEducation": "", // Bildungsniveau "CreatorRelationshipStatus": "", // Beziehungsstatus "CreatorParentalStatus": "", // Elternstatus "CreatorPronouns": "", // Pronomen "CreatorDOB": "", // Geburtsdatum // Nur PENDING: Gruppen-IDs "GroupIds": "1001,1002,1003" // Durch Kommas getrennte Gruppen-IDs } ```
### Mechanismus für Postback-Wiederholungsversuche Wenn ein Postback beim Senden an die Ziel-URL fehlschlägt, wird die Zustellung automatisch nach einem festgelegten 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. #### Zeitplan für Wiederholungen Die Wiederholungsversuche folgen dem unten stehenden Zeitplan. Wiederholung 1, 2 und 3 werden übersprungen, wenn der HTTP-Antwortcode im Bereich von `400` auf `500`.
Referenz zum Wiederholungszeitplan
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.