# Postbacks für den Aktionslebenszyklus einrichten

Es gibt zwei Haupttypen von Postbacks im Lebenszyklus von Aktionen. **Auf globaler Ebene** erstellt Postbacks für Ihr gesamtes Konto und **auf Ereignisebene** erstellt Postbacks für bestimmte Ereignistypen. Wählen Sie die Option, die Ihren Anforderungen am besten entspricht, um mehr über den Einrichtungsprozess zu erfahren.

{% hint style="warning" %}
**Warnung:** Bei Postbacks auf globaler Ebene sollten Sie ein Postback erhalten, wann immer ein „nicht standardmäßiges“ Ereignis auftritt, z. B. eine Änderung oder ein Widerruf. Beachten Sie, dass Postbacks auf Ereignisebene keine nicht standardmäßigen Aktionen im Lebenszyklus auslösen.
{% endhint %}

#### Ein Postback für den Lebenszyklus einer Aktion einrichten

<details>

<summary>Ein Postback für den Lebenszyklus einer Aktion auf globaler Ebene einrichten</summary>

In diesem Abschnitt wird beschrieben, wie Sie Postbacks für Ihr gesamtes Konto auf einmal erstellen. Partner, die nur über ein System verfügen, das diese Postbacks empfangen und verarbeiten kann, oder die Benachrichtigungen für alle nicht standardmäßigen Ereignisse wünschen, sollten Postbacks für den Lebenszyklus von Aktionen auf globaler Ebene einrichten.

{% hint style="info" %}
**Hinweis:** Wenn Sie die Ereignistypen, für die Sie Postbacks erhalten, gezielter auswählen möchten, siehe den folgenden Abschnitt zum Einrichten von *Postbacks für den Lebenszyklus von Aktionen 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%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[Benutzerprofil] → Einstellungen**.
2. Unter *Technisch*wählen Sie **Ereignisbenachrichtigungen**.
3. Neben *Ereignisse im Lebenszyklus von Aktionen*wählen Sie ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-6027673a720a6522269e1861ad0554c4a85baf29%2F9dcf248c757a094c6af27798e61091b8425a0afa1637ae0e5ba3448c5f85b1a1.svg?alt=media) **\[Bearbeiten]**.
4. Geben Sie die URL Ihres Servers ein. Dies ist die URL, an die impact.com Postbacks sendet.
5. Wählen Sie Ihre bevorzugte HTTP-Methode aus.
   * Sehen Sie sich einige der [verfügbaren Body-Parameter von impact.com](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Wenn Sie **POST**auswählen, geben Sie anschließend den Body der Anfrage ein und wählen Sie ein **Body-Format**. Unten sehen Sie ein Beispiel dafür, wie Sie jeden Datenpunkt für ein JSON-Format zuordnen könnten. Die Schlüssel in jedem Schlüssel-Wert-Paar sollten aus der Konfiguration Ihres eigenen Systems stammen, und die Werte sind die von Ihnen gewählten entsprechenden Datenpunkte, die impact.com bereitstellt und die in Klammern eingegeben werden sollten `{ }`.

     <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-16c42a102e36c3c3d44b22c66b31b8cf4643aae1%2F6c821ff8c8e1cfaea1b1d7c908754dd4db816de21d5db59b4ddbd07bf14b1bb4.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>
   * Sie sehen keinen Wert, den Sie benötigen? Wenden Sie sich an Ihren Account Manager (oder [den Support kontaktieren](https://app.impact.com/support/portal.ihtml)).
6. Wählen Sie **Ereignisse im Lebenszyklus von Aktionen**. Diese Einstellungen sind optional.
   * Geben Sie einen **HTTP-Header**ein. Wenn mehrere Paare benötigt werden, trennen Sie sie mit einem Semikolon.
   * Geben Sie eine **Mindestverzögerung** zwischen dem Zeitpunkt ein, an dem ein nicht standardmäßiges Ereignis eintritt, und dem Zeitpunkt, an dem das Postback generiert und an Ihr System gesendet wird.
   * Geben Sie ein Rate-Limit für die **Maximale Anfragen** ein, die impact.com pro Sekunde an Ihr System senden kann.
   * Geben Sie ein, was die **Erfolgsantwort** auf ein Postback sein soll.
   * Geben Sie ein, was die **Fehlerantwort** auf ein Postback sein soll.
7. Wählen Sie **Speichern**.

Jetzt, da Sie Postbacks auf globaler Ebene eingerichtet haben, sollte Ihr System Postbacks erhalten, sobald nicht standardmäßige Ereignisse auftreten, unabhängig von der Marke, die die nicht standardmäßigen Aktionen ausführt. Wie Sie Ihre neue Postback-Einrichtung testen, erfahren Sie im folgenden Abschnitt *Ein Postback für den Lebenszyklus einer Aktion 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 konfigurieren, um benachrichtigt zu werden, wenn Aktionen stattfinden, und den/die dynamisch befüllten Wert(e) abzurufen, die mit der Aktion verknüpft sind.

Dieses Beispiel zeigt, wie Sie einen `SharedId` -Wert (ein Wert, den Sie mit Marken teilen möchten) an einen Parameter in einem Postback (`MyParam`) übergeben. Einige Marken verlangen möglicherweise, dass Sie dies 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 `MyParam` Parameter mit dem aus `SharedId`.

</details>

<details>

<summary>Postbacks für den Lebenszyklus von Aktionen auf Ereignisebene einrichten</summary>

In diesem Abschnitt wird beschrieben, wie Sie Postbacks für bestimmte Ereignistypen erstellen, die nachverfolgen, wann Sie Aktionen auslösen. Wenn Sie bei den Ereignistypen, für die Sie Postbacks erhalten, selektiver vorgehen möchten, sollten Sie Postbacks für den Lebenszyklus von Aktionen auf Ereignisebene einrichten.

{% hint style="info" %}
**Hinweis:** Wenn Sie Postbacks für den Lebenszyklus von Aktionen auf globaler Ebene eingerichtet haben, müssen Sie keine Postbacks auf Ereignisebene einrichten.
{% endhint %}

1. Wählen Sie in der oberen Navigationsleiste **Entdecken → Meine Marken**.
2. Wählen Sie die Karte für die Marke aus, die das Postback besitzt, das Sie testen möchten.
3. Unter dem Namen der Marke wählen Sie ![](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 in der Nähe der oberen rechten Ecke der Seite **Postback hinzufügen**.
5. Wählen Sie den Ereignistyp (vormals *Action Tracker*) aus, für den Sie Postbacks für den Lebenszyklus von Aktionen einrichten möchten.
6. Geben Sie die URL Ihres Servers ein. Dies ist die URL, an die impact.com Postbacks sendet.
7. Wählen Sie Ihre bevorzugte HTTP-Methode aus.
   * Wenn Sie **POST**auswählen, geben Sie anschließend den Body der Anfrage ein und wählen Sie ein **Body-Format**. Unten sehen Sie ein Beispiel dafür, wie Sie jeden Datenpunkt für ein JSON-Format zuordnen könnten. Die Schlüssel in jedem Schlüssel-Wert-Paar sollten aus der Konfiguration Ihres eigenen Systems stammen, und die Werte sind die von Ihnen gewählten entsprechenden Datenpunkte, die impact.com bereitstellt und die in Klammern { } eingegeben werden sollten.

     <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-9cec675aa05964dd4b9db329acc2cae7a9d85de8%2Fd34ce186243db11585c9d497d92cc26b633031bbab0d67ae06fc109dae4ceb0d.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>
   * Sehen Sie sich einige der [verfügbaren Body-Parameter von impact.com](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Sie sehen keinen Wert, den Sie benötigen? Wenden Sie sich an Ihren Account Manager (oder [den Support kontaktieren](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 Zeitpunkt ein, an dem ein nicht standardmäßiges Ereignis eintritt, und dem Zeitpunkt, an dem das Postback generiert und an Ihr System gesendet wird.
   * Geben Sie ein Rate-Limit für die **Maximale Anfragen** ein, die impact.com pro Sekunde an Ihr System senden kann.
   * Geben Sie ein, was die **Erfolgsantwort** auf ein Postback sein soll.
   * Geben Sie ein, was die **Fehlerantwort** auf ein Postback sein soll.
9. Wählen Sie **Speichern**.

Jetzt, da Sie Postbacks auf Ereignisebene eingerichtet haben, sollte Ihr System beginnen, Postbacks für den in *Schritt 5*ausgewählten Ereignistyp zu empfangen. Wie Sie Ihre neue Postback-Einrichtung testen, erfahren Sie im *Ein Postback für den Lebenszyklus einer Aktion 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 konfigurieren, um benachrichtigt zu werden, wenn Aktionen stattfinden, und den/die dynamisch befüllten Wert(e) abzurufen, die mit der Aktion verknüpft sind.

Dieses Beispiel zeigt, wie Sie einen `SharedId` -Wert (ein Wert, den Sie mit Marken teilen möchten) an einen Parameter in einem Postback (`MyParam`) übergeben. Einige Marken verlangen möglicherweise, dass Sie dies 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 `MyParam` Parameter mit dem aus `SharedId`.

</details>

#### Ein Postback für den Lebenszyklus einer Aktion testen

Sobald Sie ein Postback für den Lebenszyklus einer Aktion eingerichtet haben, unabhängig davon, auf welcher Ebene es gilt, sollten Sie es testen. 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, während impact.com an Ihre Ziel-URL sendet, versucht impact.com die Zustellung automatisch erneut. impact.com versucht ein fehlgeschlagenes Postback insgesamt bis zu 15 Mal erneut. impact.com überspringt die ersten 3 Wiederholungsversuche für HTTP-Antworten von `400` bis `500`. Den vollständigen Wiederholungsplan und Details zur Fehlerbehebung finden Sie unter [Eine Postback-URL testen und Fehler beheben](https://app.gitbook.com/s/b2rE79d9UhOKZQLgzSqx/what-would-you-like-to-learn-about/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url).

<details>

<summary>Ein 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 → Meine Marken**.
2. Wählen Sie die Karte für die Marke aus, die das Postback besitzt, das Sie testen möchten.
3. Unter dem Namen der Marke wählen Sie ![](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. Im *Postback* Abschnitt wählen Sie ![](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 dann wählen Sie **Test starten**.
5. Bestätigen Sie, dass die URL des Postbacks korrekt ist, und wählen Sie dann **Test starten**.

</details>

<details>

<summary>Eine Test-Conversion erstellen</summary>

Dieser Test wird nicht in der impact.com-Web-App durchgeführt. Stattdessen führen Sie einen End-to-End-Test durch, der einer typischen Nutzerreise folgt. Stellen Sie sicher, dass Sie Ihre Partner-Marke darüber informieren, dass Sie den Test durchführen werden.

1. Wählen Sie in der oberen Navigationsleiste **Inhalt → Assets**.
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%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[Aktivieren]** **Tracking-Parameter**.
5. Geben Sie **Sub-IDs** oder eine **Shared ID** wie erforderlich ein. Jedes Feld erfordert mindestens einen Eintrag.
   * Überspringen Sie diesen Schritt, wenn Sie bereits Werte in diesen Feldern haben.
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. Überprüfen Sie nach etwa 15 Minuten Ihr System auf das Postback, das durch diese Testaktion generiert wurde.
    * 15 Minuten ist normalerweise die Zeit, die die Verarbeitung einer Aktion dauert.
    * Sie werden diese neue ausstehende Aktion auch auf dem [Ausstehende Aktionen](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) Bildschirm sehen. Wenn Sie die Aktion auf dem *Ausstehende Aktionen* Bildschirm sehen, aber noch kein Postback erhalten haben, überprüfen Sie Ihre Postback-Einrichtung erneut.
12. Bitten Sie Ihre Marke, die Aktion zu widerrufen.
13. Überprüfen Sie Ihr System auf das Postback, das durch diesen Widerruf generiert wurde.
    * Wenn Sie die widerrufene Aktion auf dem [Widerrufene Aktionen](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) Bildschirm sehen, aber noch kein Postback erhalten haben, überprüfen Sie Ihre Postback-Einrichtung erneut.

</details>

<details>

<summary>Fehler beheben</summary>

| Fehler                              | Beschreibung                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Fehlender obligatorischer Parameter | Ihr Server erwartet wahrscheinlich einen Wert anstelle einer Variablen. Ändern Sie Ihre Postback-URL so, dass ein Testwert übergeben wird (z. B. „12345678“ anstelle von `{SubId1}`), und prüfen Sie, ob der fest codierte Wert akzeptiert wird.                                                                                                              |
| Groß-/Kleinschreibung bei Variablen | Dynamische Variablen sind groß-/kleinschreibungssensitiv und müssen exakt sein, das heißt, dass `{SubId1}` nicht dasselbe ist wie `{subid1}`. Überprüfen Sie doppelt, ob Ihre Variablen die richtige Groß-/Kleinschreibung widerspiegeln.                                                                                                                     |
| Zugriff verweigert                  | Die meisten Postback-Server haben ein Sicherheitstoken oder einen Wert, der zusammen mit den dynamischen Variablen übergeben werden muss. Arbeiten Sie mit dem Technikteam Ihrer Website (oder lesen Sie die Dokumentation Ihres Website-Anbieters), um das Token oder den Sicherheitswert zu ermitteln, der für den Zugriff auf den Server erforderlich ist. |

</details>

{% hint style="success" icon="circle-info" %}
**Hinweis:** Wenn Sie keine Probleme mit Ihrer Postback-Einrichtung finden, aber dennoch keine erhalten, [den Support kontaktieren](https://app.impact.com/support/portal.ihtml). impact.com kann prüfen, ob Postbacks generiert werden, wie der Antwortcode für jedes einzelne lautet und wie der Body für jedes Postback aussieht. Diese Informationen können Ihnen bei der Fehlerbehebung Ihrer Einrichtung helfen.
{% endhint %}
