> 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/partner/de/was-mochten-sie-lernen/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md).

# Postbacks für den Aktionslebenszyklus einrichten

Es gibt zwei Haupttypen von Postbacks für den Aktionslebenszyklus. **Kontoebene** erstellt Postbacks für Ihr gesamtes Konto, während **Ereignisebene** Postbacks für bestimmte Ereignistypen erstellt. Wählen Sie die Option, die am besten zu Ihren Anforderungen passt, um mehr über die Einrichtung zu erfahren.

{% hint style="warning" %}
**Warnung:** Bei Postbacks auf Kontoebene sollten Sie immer dann ein Postback erhalten, wenn ein „nicht standardmäßiges“ Ereignis auftritt, etwa eine Änderung oder Rückbuchung. Beachten Sie, dass Postbacks auf Ereignisebene keine nicht standardmäßigen Ereignisse des Aktionslebenszyklus auslösen.
{% endhint %}

## Postback für den Aktionslebenszyklus einrichten

<details>

<summary>Postback für den Aktionslebenszyklus auf Kontoebene einrichten</summary>

In diesem Abschnitt erfahren Sie, wie Sie Postbacks für Ihr gesamtes Konto einrichten. Partner, die nur ein System zum Empfangen und Verarbeiten dieser Postbacks haben oder Benachrichtigungen zu allen nicht standardmäßigen Ereignissen erhalten möchten, sollten Postbacks für den Aktionslebenszyklus auf Kontoebene einrichten.

{% hint style="success" %}
**Hinweis:** Wenn Sie genauer festlegen möchten, für welche Ereignistypen Sie Postbacks erhalten, lesen Sie den folgenden Abschnitt zur Einrichtung von *Postbacks für den Aktionslebenszyklus auf Ereignisebene*.
{% endhint %}

1. Wählen Sie in der oberen Navigationsleiste ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FhyR4iWDS0fO9ZcKFGf82%2FUser%20profile.svg?alt=media\&token=281d8f1b-b9c5-4208-a0a2-a078f54e0eb6) **\[Benutzerprofil] → Einstellungen**.
2. Wählen Sie unter *Technisch*die Option [**Ereignisbenachrichtigungen**](https://app.impact.com/secure/mediapartner/accountSettings/view-edit-pingback-settings-flow.ihtml).
3. Wählen Sie neben *Ereignisse des Aktionslebenszyklus*die Option ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FZMLVDhHLGefqRDHaIWTm%2FEdit.svg?alt=media\&token=1f1168ae-5bd3-456c-a366-904d0ecf00cb) **\[Bearbeiten]**.
4. Geben Sie die URL Ihres Servers ein. An diese URL sendet impact.com die Postbacks.
5. Wählen Sie die gewünschte HTTP-Methode aus.
   * Sehen Sie sich einige der [verfügbaren Body-Parameter](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Wenn Sie **POST**auswählen, geben Sie anschließend den Anfragetext ein und wählen ein **Body-Format**. Unten sehen Sie ein Beispiel dafür, wie Sie die einzelnen Datenpunkte einem JSON-Format zuordnen können. Die Schlüssel der Schlüssel-Wert-Paare sollten aus der Konfiguration Ihres eigenen Systems stammen. Als Werte tragen Sie die entsprechenden von impact.com bereitgestellten Datenpunkte in eckigen Klammern ein. `{ }`.

     <div data-with-frame="true"><figure><img src="https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FFNWShmuaxZ5VpP14AlWv%2FScreenshot%202026-05-23%20at%2010.58.15.png?alt=media&amp;token=00e80c87-6c12-4f6d-8ca5-3885c9002533" alt="" width="563"><figcaption></figcaption></figure></div>
   * Fehlt ein benötigter Wert? Wenden Sie sich an Ihren Account Manager (oder [kontaktieren Sie den Support](https://app.impact.com/support/portal.ihtml)).
6. Wählen Sie **Ereignisse des Aktionslebenszyklus**aus. Diese Einstellungen sind optional.
   * Geben Sie einen **HTTP-Header**ein. Wenn mehrere Paare erforderlich sind, trennen Sie sie durch ein Semikolon.
   * Geben Sie eine **Mindestverzögerung** zwischen dem Auftreten eines nicht standardmäßigen Ereignisses und der Erstellung und Übermittlung des Postbacks an Ihr System ein.
   * Geben Sie ein Ratenlimit für die **maximale Anzahl von Anfragen** ein, die impact.com pro Sekunde an Ihr System senden darf.
   * Geben Sie an, wie die **Erfolgsantwort** auf ein Postback lauten soll.
   * Geben Sie an, wie die **Fehlerantwort** auf ein Postback lauten soll.
7. Wählen Sie **Speichern**.

Nachdem Sie nun Postbacks auf globaler Ebene eingerichtet haben, sollte Ihr System Postbacks empfangen, sobald nicht standardmäßige Ereignisse eintreten – unabhängig davon, welche Marke die nicht standardmäßigen Aktionen ausführt. Wie Sie Ihre neue Postback-Konfiguration testen, erfahren Sie im folgenden Abschnitt: *Ein Action-Lifecycle-Postback testen* .

### Beispiel für dynamische Werte

Wenn Sie dynamische Variablen für Ihre Tracking-Links konfiguriert haben, können Sie eine Postback-URL zu Ihrem eigenen Server einrichten, damit Sie benachrichtigt werden, wenn Aktionen stattfinden, und die dynamisch ausgefüllten Werte der Aktion abrufen können.

In diesem Beispiel wird gezeigt, wie Sie einen Wert `SharedId` (einen Wert, den Sie mit Marken teilen möchten) an einen Parameter in einem Postback übergeben (`MyParam`). Bei einigen Marken müssen Sie dies möglicherweise konfigurieren.

<div data-with-frame="true"><figure><img src="https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Eine Postback-URL könnte etwa so aussehen:

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

Die Postback-URL füllt den Parameter `MyParam` mit dem Wert aus `SharedId`.

</details>

<details>

<summary>Postbacks für den Action-Lifecycle auf Ereignisebene einrichten</summary>

In diesem Abschnitt erfahren Sie, wie Sie Postbacks für bestimmte Ereignistypen einrichten, die nachverfolgen, wann Sie Aktionen auslösen. Wenn Sie die Ereignistypen, für die Sie Postbacks erhalten, gezielter auswählen möchten, sollten Sie Postbacks für den Action-Lifecycle auf Ereignisebene einrichten.

{% hint style="success" %}
**Hinweis:** Wenn Sie Postbacks für den Action-Lifecycle auf globaler Ebene eingerichtet haben, müssen Sie keine Postbacks auf Ereignisebene einrichten.
{% endhint %}

1. Wählen Sie in der oberen Navigationsleiste **Entdecken →** [**Marken**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. Wählen Sie die Karte der Marke aus, der das Postback gehört, das Sie testen möchten.
3. Wählen Sie unter dem Namen der Marke ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Mehr]** → **Tracking-Integration**.
4. Wählen Sie oben rechts auf der Seite **Postback hinzufügen**.
5. Wählen Sie den Ereignistyp (früher *Aktions-Tracker*) aus, für den Sie Postbacks für den Action-Lifecycle einrichten möchten.
6. Geben Sie die URL Ihres Servers ein. An diese URL sendet impact.com die Postbacks.
7. Wählen Sie die gewünschte HTTP-Methode aus.
   * Wenn Sie **POST**auswählen, geben Sie anschließend den Anfragetext ein und wählen ein **Body-Format**. Im Folgenden sehen Sie ein Beispiel dafür, wie Sie die einzelnen Datenpunkte einem JSON-Format zuordnen können. Die Schlüssel der Schlüssel-Wert-Paare sollten aus der Konfiguration Ihres eigenen Systems stammen. Als Werte tragen Sie die entsprechenden Datenpunkte ein, die Sie von impact.com auswählen. Setzen Sie diese in geschweifte Klammern { }.

     <div data-with-frame="true"><figure><img src="https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FwVvNFu7iuPM0eAwyMk6L%2FScreenshot%202026-05-23%20at%2013.07.16.png?alt=media&amp;token=f33b091a-cead-4e1b-80f2-0ebd97810835" alt="" width="563"><figcaption></figcaption></figure></div>
   * Einige der [verfügbaren Body-Parameter von impact.com anzeigen](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Fehlt ein benötigter Wert? Wenden Sie sich an Ihren Account Manager (oder [kontaktieren Sie den Support](https://app.impact.com/support/portal.ihtml)).
8. Wählen Sie **Erweiterte Einstellungen anzeigen**. Diese Einstellungen sind optional.
   * Geben Sie eine **Mindestverzögerung** zwischen dem Auftreten eines nicht standardmäßigen Ereignisses und der Erstellung und Übermittlung des Postbacks an Ihr System ein.
   * Geben Sie ein Ratenlimit für die **maximale Anzahl von Anfragen** ein, die impact.com pro Sekunde an Ihr System senden darf.
   * Geben Sie an, wie die **Erfolgsantwort** auf ein Postback lauten soll.
   * Geben Sie an, wie die **Fehlerantwort** auf ein Postback lauten soll.
9. Wählen Sie **Speichern**.

Nachdem Sie nun Postbacks auf Ereignisebene eingerichtet haben, sollte Ihr System Postbacks für den Ereignistyp empfangen, den Sie in *Schritt 5*ausgewählt haben. Wie Sie Ihre neue Postback-Konfiguration testen, erfahren Sie im folgenden Abschnitt: *Ein Action-Lifecycle-Postback testen* .

### Beispiel für dynamische Werte

Wenn Sie dynamische Variablen für Ihre Tracking-Links konfiguriert haben, können Sie eine Postback-URL zu Ihrem eigenen Server einrichten, damit Sie benachrichtigt werden, wenn Aktionen stattfinden, und die dynamisch ausgefüllten Werte der Aktion abrufen können.

In diesem Beispiel wird gezeigt, wie Sie einen Wert `SharedId` (einen Wert, den Sie mit Marken teilen möchten) an einen Parameter in einem Postback übergeben (`MyParam`). Bei einigen Marken müssen Sie dies möglicherweise konfigurieren.

<div data-with-frame="true"><figure><img src="https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Eine Postback-URL könnte etwa so aussehen:

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

Die Postback-URL füllt den Parameter `MyParam` mit dem Wert aus `SharedId`.

</details>

## Ein Action-Lifecycle-Postback testen

Nachdem Sie ein Postback für den Action-Lifecycle eingerichtet haben, sollten Sie es testen – unabhängig davon, auf welcher Ebene es gilt. Sie können entweder ein Test-Postback in impact.com ausführen (nur für Postbacks auf Ereignisebene verfügbar) oder eine Conversion durchführen.

Wenn ein Postback fehlschlägt, weil impact.com Daten an Ihre Ziel-URL sendet, versucht impact.com automatisch erneut, die Daten zuzustellen. impact.com unternimmt insgesamt bis zu 15 Zustellversuche für ein fehlgeschlagenes Postback. Die ersten drei Wiederholungsversuche für HTTP-Antworten von `400` bis `500`überspringt impact.com. Den vollständigen Wiederholungszeitplan und Informationen zur Fehlerbehebung finden Sie unter [Postback-URL testen und Fehler beheben](https://help.impact.com/partner/de/was-mochten-sie-lernen/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url.md).

<details>

<summary>Test-Postback in impact.com ausführen</summary>

Wenn Sie ein Postback auf Ereignisebene eingerichtet haben, können Sie es in Ihrem impact.com-Konto testen.

1. Wählen Sie in der oberen Navigationsleiste **Entdecken →** [**Marken**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. Wählen Sie die Karte der Marke aus, der das Postback gehört, das Sie testen möchten.
3. Wählen Sie unter dem Namen der Marke ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **Mehr** → **Tracking-Integration**.
4. Wählen Sie im Abschnitt *Postback* die Option ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[Pfeil nach unten] Aktionen**, und wählen Sie dann **Test starten**.
5. Vergewissern Sie sich, dass die URL des Postbacks korrekt ist, und wählen Sie dann **Test starten**.

</details>

<details>

<summary>Testkonversion erstellen</summary>

Dieser Test wird nicht in der impact.com-Web-App ausgeführt. Stattdessen führen Sie einen End-to-End-Test durch, der einer typischen Nutzerreise folgt. Informieren Sie die Marke, mit der Sie zusammenarbeiten, darüber, dass Sie den Test durchführen werden.

1. Wählen Sie in der oberen Navigationsleiste **Verwalten →** [**Marken-Creatives**](https://app.impact.com/secure/mediapartner/ads/searchAdsDirectoryMP.ihtml#adType=all).
2. Wählen Sie eine Anzeige aus.
3. Wählen Sie unter dem Anzeigenamen **Tracking-Link abrufen**.
4. Wählen Sie ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FNb1O82vHF1ZWPG3qRZj3%2FToggle.svg?alt=media\&token=58221b77-b655-4ce3-bfba-64a50f3f60db) **\[Umschalter aktiviert]** **Tracking-Parameter**.
5. Geben Sie **Sub-IDs** oder eine **gemeinsame ID** nach Bedarf ein. Jedes Feld muss mindestens einen Eintrag enthalten.
   * Überspringen Sie diesen Schritt, wenn in diesen Feldern bereits Werte eingetragen sind.
6. Wählen Sie optional eine **Eigenschaft** aus der Dropdown-Liste aus.
7. Wählen Sie **Speichern**.
8. Wählen Sie **Tracking-Link kopieren**.
9. **Fügen Sie** den Link in ein neues Browserfenster ein.
10. Führen Sie die Aktion aus.
11. Prüfen Sie nach etwa 15 Minuten in Ihrem System, ob das durch diese Testaktion ausgelöste Postback eingegangen ist.
    * Die Verarbeitung einer Aktion dauert normalerweise etwa 15 Minuten.
    * Sie können diese neue ausstehende Aktion auch auf dem Bildschirm [Ausstehende Aktionen](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) sehen. Wenn die Aktion auf dem Bildschirm *Ausstehende Aktionen* angezeigt wird, Sie aber noch kein Postback erhalten haben, überprüfen Sie Ihre Postback-Einrichtung.
12. Bitten Sie Ihre Marke, die Aktion rückgängig zu machen.
13. Prüfen Sie in Ihrem System, ob das durch diese Rückabwicklung ausgelöste Postback eingegangen ist.
    * Wenn die rückgängig gemachte Aktion auf dem Bildschirm [Rückgängig gemachte Aktionen](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) angezeigt wird, Sie aber kein Postback erhalten haben, überprüfen Sie Ihre Postback-Einrichtung.

</details>

### Fehler beheben

Verwenden Sie die folgende Referenztabelle, um häufige Probleme zu identifizieren und zu beheben, die bei der Konfiguration Ihrer Action-Lifecycle-Postbacks auftreten.

<table><thead><tr><th width="199.859375">Fehler</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Erforderlicher Parameter fehlt</td><td>Ihr Server erwartet wahrscheinlich einen Wert statt einer Variable. Ändern Sie Ihre Postback-URL so, dass sie einen Testwert übergibt (z. B. „12345678“ statt <code>{SubId1}</code>) und prüfen Sie, ob der fest eingetragene Wert akzeptiert wird.</td></tr><tr><td>Groß-/Kleinschreibung bei Variablen beachten</td><td>Bei dynamischen Variablen muss die Groß- und Kleinschreibung exakt stimmen. Das bedeutet, dass <code>{SubId1}</code> nicht dasselbe ist wie <code>{subid1}</code>. Prüfen Sie sorgfältig, ob bei Ihren Variablen die Groß- und Kleinschreibung korrekt ist.</td></tr><tr><td>Zugriff verweigert</td><td>Die meisten Postback-Server erfordern ein Sicherheitstoken oder einen Sicherheitswert, der zusammen mit den dynamischen Variablen übergeben werden muss. Wenden Sie sich an das technische Team Ihrer Website (oder lesen Sie die Dokumentation Ihres Website-Anbieters), um herauszufinden, welches Token oder welcher Sicherheitswert für den Zugriff auf den Server erforderlich ist.</td></tr></tbody></table>

{% hint style="success" icon="circle-info" %}
**Hinweis:** Wenn Sie keine Probleme mit Ihrer Postback-Konfiguration finden, aber weiterhin keine Postbacks erhalten, [wenden Sie sich an den Support](https://app.impact.com/support/portal.ihtml). impact.com kann prüfen, ob Postbacks generiert werden, welchen Antwortcode jedes einzelne zurückgibt und welchen Inhalt es enthält. Diese Informationen können Ihnen bei der Fehlersuche in Ihrer Konfiguration helfen.
{% endhint %}


---

# 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/partner/de/was-mochten-sie-lernen/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md?ask=<question>&goal=<user_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.
