# Ereignis-Benachrichtigungs-Postbacks für Marken aktivieren Ereignis-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 %} ### Ereignis-Benachrichtigungs-Postbacks aufrufen 1. Wählen Sie in der oberen Navigationsleiste ![](/files/b499afb31802cd63f4cfb233fcf9c95589389524) **\[Benutzerprofil] → Einstellungen**. 2. Wählen Sie im *Technischen* Bereich [**Ereignis-Benachrichtigungen**](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 ![](/files/eb5fd4ef68cfbfdebcf98ff80916540d58802134) **\[Bearbeiten]**. 2. Verwenden Sie die folgende Tabelle, um die Zustellungs-Einstellungen 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 Anforderungstext gesendet, der verschiedene optionale Parameter enthält, die Sie festlegen können.

Weitere Informationen zu jedem Ereignis und zum Payload-Inhalt finden Sie unter Benachrichtigungsereignisse und Payloads .

| | 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 | 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. `FEHLER` oder `500`). | | {% endstep %} | | | {% endstepper %} | | ### Benachrichtigungsereignisse und Payloads Jede Ereignisbenachrichtigung sendet eine eindeutige Menge konfigurierbarer Datenpunkte (z. B. `{ActionId}`). Weitere Informationen dazu, welche Datenpunkte Sie aus den Payloads extrahieren können, finden Sie in den folgenden Ereignissen.
Ereignisse zum Lebenszyklus von Aktionen Ereignisse zum 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 // 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", // Aktionsstatus "StatusDetail": "Item return - payout adjusted", // 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, // Änderung des Auszahlungsbetrags "IntendedPayout": 15.50, // Der vorgesehene 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, // Der vorgesehene Verkaufsbetrag für eine Aktion über dem Limit "Currency": "USD", // Währung für die Aktion "OriginalCurrency": "USD", // Ursprüngliche Währung der Aktion (d. h. Warenkorb-Währung) "OriginalAmount": 100.00, // Ursprünglicher Betrag der Aktion (d. h. Warenkorb-Betrag) // 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", // 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 der Freigabe "ReferringDomain": "blog.partner.com", // Verweisende Domain "LandingPageUrl": "https://brand.com/sale", // URL der Landingpage "RefCustomerArea": "California", // Kundenregion (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 Aktionscode "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", // Stadt des Kunden "CustomerCountry": "US", // Kundenlandescode "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 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", // OS-Version des Geräts "deviceManuf": "Apple", // Gerätehersteller "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", // Einstellung für iOS-Ad-Tracking "androidId": null, // Android-ID "deviceId": "D-556677", // Geräte-ID "deviceIp": "192.168.1.1" // IP des Geräts } ```
Ereignisse für Aktionsanfragen Ereignisse für Aktionsanfragen senden eine HTTP-Anfrage an eine angegebene URL (und alle enthaltenen Parameter), wenn Aktionsanfragen erstellt oder aufgelö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 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, // Der endgültige Auszahlungsbetrag im Zusammenhang mit der Aktionsanfrage "ResolutionDate": null, // Datum, an dem über 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 Notizen zur Anfrage "ResolutionNotes": null, // Notizen, die bei der Entscheidung über die Anfrage übermittelt wurden "Comments": "[{\"user\": \"support_agent\", \"text\": \"Verifying click logs now.\"}, {\"user\": \"partner\", \"text\": \"Customer provided receipt.\"}]" // Zur Anfrage hinzugefügte Kommentare (im JSON-Format) } ```
Ereignisse für Aktionsfreigaben Ereignisse für Aktionsfreigaben 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 } ```
Ereignisse für Anforderung des Tracking-Werts Ereignisse für Anforderung des Tracking-Werts 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 Kontowährung "Currency": "USD", // Währung für die Aktion "Oid": "ORD-554433", // Bestell-ID // Sammlung "items": Aufschlüsselung einzelner 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", // Datum der Conversion "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 für einen abgeschlossen wurde [Berichtsexport](https://integrations.impact.com/impact-brand/reference/export-reports) oder [Auf Export klicken](https://integrations.impact.com/impact-brand/reference/retrieve-export-click). ```json // Ein POST-Beispiel im JSON-Format { "JobId": 10293847, // Eindeutige Job-ID "JobType": "REPORT_EXPORT", // Art 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, um weitere Details zum Job abzurufen "ApiResultUri": "https://api.impact.com/jobs/10293847/result", // API-URI, um das Ergebnis der Job-Ausgabe abzurufen "ResultDownloadUrlExp5": "https://download.impact.com/file?token=a1b2...&exp=5min", // URL zum Herunterladen der Ausgabe (5 Minuten gültig) "ResultDownloadUrlExp15": "https://download.impact.com/file?token=a1b2...&exp=15min", // URL zum Herunterladen der Ausgabe (15 Minuten gültig) "ResultDownloadUrlExp30": "https://download.impact.com/file?token=a1b2...&exp=30min", // URL zum Herunterladen der Ausgabe (30 Minuten gültig) "ResultDownloadUrlExp60": "https://download.impact.com/file?token=a1b2...&exp=60min" // URL zum Herunterladen der Ausgabe (60 Minuten gültig) } ```
Ereignisse für Publisher-Anwendungen {% hint style="info" %} **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-Anwendungen senden eine HTTP-Anfrage an eine angegebene URL, wenn ein Partner eine Bewerbung einreicht. In Fällen, in denen ein Payload mit leeren Datenpunkten ausgeliefert wird, ist das System so konzipiert, dass Aktualisierungen ausgelöst werden, sobald Informationen verfügbar werden. Spätere erfolgreiche Auslieferungen füllen diese zuvor leeren Felder auf und stellen sicher, dass Ihre Datensätze mit den neuesten verarbeiteten Informationen synchron bleiben. {% hint style="warning" %} **Wichtig:** Der Postback wird nicht ausgelöst, wenn Sie widersprüchliche [Anwendungs-Workflows](/brand/de/woruber-mochten-sie-mehr-erfahren/platform-features/review-partner-applications/automate-partner-application-processing/create-workflows-to-automatically-process-partner-applications.md). {% endhint %} ```json // Ein POST-Beispiel im JSON-Format { "ProgramId": "9876", // Programm-ID "TemplateTermsId": "4455", // ID der Vorlagenbedingungen "ContractId": "112233", // Vertrags-ID "ApplicationDate": "2026-04-09T08:30:00Z", // Bewerbungsdatum "PublisherId": "555", // Partner-ID "Name": "Elite Content Creators", // Partnername "BusinessModel": "SOCIAL_INFLUENCER", // primäres Geschäftsmodell des Partners "Description": "A premium network of lifestyle and travel influencers.", // Profilbeschreibung "Address": "123 Marketing Way", // Straßenadresse "City": "Los Angeles", // Stadt "State": "CA", // Bundesstaat "Country": "US", // Land "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 } ```
### Postback-Wiederholungsmechanismus Wenn ein Postback beim Versuch, an die Ziel-URL zu posten, fehlschlägt, wird die Zustellung gemäß einem festen Zeitplan automatisch bis zu 15 Mal erneut versucht. Wiederholungen helfen bei vorübergehenden Netzwerkproblemen oder wenn der Server nicht verfügbar ist. #### 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, beispielsweise aufgrund eines DNS-Lookup-Fehlers. #### Wiederholungsplan Die Wiederholungsversuche folgen dem unten stehenden Zeitplan. Die Wiederholungen 1, 2 und 3 werden übersprungen, wenn der HTTP-Antwortcode im Bereich von `400` bis `500`.
Referenz für den 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: 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: ``` GET https://help.impact.com/brand/de/woruber-mochten-sie-mehr-erfahren/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.