# Richten Sie Aktions-Lifecycle-Postbacks ein

Es gibt zwei Haupttypen von Action-Lifecycle-Postbacks. **Globales Level** erstellt Postbacks für Ihr gesamtes Konto und **Ereignis-Level** erstellt Postbacks für bestimmte Ereignistypen. Wählen Sie denjenigen aus, der am besten zu Ihren Anforderungen passt, um mehr über den Einrichtungsprozess zu erfahren.

{% hint style="warning" %}
**Warnung:** Für Postbacks auf globaler Ebene sollten Sie ein Postback erhalten, wann immer ein „nicht standardmäßiges“ Ereignis auftritt, wie z. B. eine Änderung oder eine Rückbuchung. Beachten Sie, dass Ereignis-Level-Postbacks nicht für nicht standardmäßige Action-Lifecycle-Ereignisse ausgelöst werden.
{% endhint %}

#### Ein Action-Lifecycle-Postback einrichten

<details>

<summary>Ein globales Action-Lifecycle-Postback einrichten</summary>

Dieser Abschnitt behandelt das Erstellen von Postbacks für Ihr gesamtes Konto auf einmal. Partner, die nur ein System haben, das diese Postbacks empfangen und verarbeiten kann, oder die Benachrichtigungen für alle nicht standardmäßigen Ereignisse wünschen, sollten Postbacks auf globaler Ebene einrichten.

{% hint style="info" %}
**Hinweis:** Wenn Sie bei den Ereignistypen, für die Sie Postbacks erhalten möchten, selektiver vorgehen möchten, sehen Sie den untenstehenden Abschnitt, um einzurichten *Ereignis-Level-Action-Lifecycle-Postbacks*.
{% 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**. &#x20;
2. Unter *Technisch*, wählen Sie **Ereignisbenachrichtigungen**.
3. Neben *Action Life Cycle Events*, 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 senden wird.
5. Wählen Sie Ihre bevorzugte HTTP-Methode.
   * Sehen Sie sich einige der von impact.com [verfügbaren Body-Parameter](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Wenn Sie **POST**, geben Sie anschließend den Body der Anfrage ein und wählen ein **Body-Format**. Nachfolgend ein Beispiel dafür, wie Sie jeden Datenpunkt für ein JSON-Format zuordnen möchten. Die Schlüssel in jedem Schlüssel-Wert-Paar sollten aus der Einrichtung Ihres eigenen Systems stammen, und die Werte werden der von impact.com bereitgestellte entsprechende Datenpunkt sein, der in Klammern eingegeben werden sollte `{ }`.

     <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>
   * Sehen Sie einen benötigten Wert nicht? Wenden Sie sich an Ihren Account Manager (oder [Support kontaktieren](https://app.impact.com/support/portal.ihtml)).
6. Auswählen **Action Life Cycle Events**). Diese Einstellungen sind optional.
   * Geben Sie einen **HTTP-Header**ein. Wenn mehrere Paare erforderlich sind, trennen Sie diese mit einem Semikolon.
   * Geben Sie eine(n) **Mindestverzögerung** zwischen dem Zeitpunkt, an dem ein nicht standardmäßiges Ereignis eintritt, und dem Zeitpunkt, an dem das Postback generiert und an Ihr System gesendet wird, ein.
   * Geben Sie ein Ratenlimit für die **Maximale Anfragen** an, die impact.com pro Sekunde an Ihr System senden kann.
   * Geben Sie ein, was Sie als **Erfolgsantwort** auf ein Postback möchten.
   * Geben Sie ein, was Sie als **Fehlerantwort** auf ein Postback möchten.
7. Auswählen **Speichern**.

Jetzt, da Sie Postbacks auf globaler Ebene eingerichtet haben, sollte Ihr System beginnen, Postbacks zu erhalten, wann immer nicht standardmäßige Ereignisse auftreten, unabhängig von der Marke, die die nicht standardmäßigen Aktionen durchführt. Um zu erfahren, wie Sie Ihre neue Postback-Einrichtung testen, sehen Sie sich den *Test eines Action-Lifecycle-Postbacks* abschnitt unten an.

**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 Sie zu benachrichtigen, wenn Aktionen auftreten, und die dynamisch gefüllten Werte abzurufen, die mit der Aktion verknüpft sind.

Dieses Beispiel zeigt, wie man einen `SharedId` Wert (einen Wert, den Sie mit Marken teilen möchten) an einen Parameter in einem Postback (`MyParam`) übergibt. Einige Marken können verlangen, 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 würde 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>abgerufenen Wert</summary>

Ereignis-Level-Action-Lifecycle-Postbacks einrichten

{% hint style="info" %}
**Hinweis:** Dieser Abschnitt behandelt das Erstellen von Postbacks für bestimmte Ereignistypen, die verfolgen, wann Sie Aktionen auslösen. Wenn Sie bei den Ereignistypen, für die Sie Postbacks erhalten, selektiver sein möchten, sollten Sie Ereignis-Level-Action-Lifecycle-Postbacks einrichten.
{% endhint %}

1. Wählen Sie in der oberen Navigationsleiste **Wenn Sie globale Action-Lifecycle-Postbacks eingerichtet haben, müssen Sie keine Ereignis-Level-Postbacks einrichten.**.
2. Discover → My Brands
3. Wählen Sie die Karte für die Marke aus, der das Postback gehört, das Sie testen möchten. ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **Unter dem Namen der Marke wählen Sie** → **\[Mehr]**.
4. Tracking-Integration **Wählen Sie oben rechts auf der Seite**.
5. Postback hinzufügen *Wählen Sie den Ereignistyp (früher*Action Tracker
6. Geben Sie die URL Ihres Servers ein. Dies ist die URL, an die impact.com Postbacks senden wird.
7. Wählen Sie Ihre bevorzugte HTTP-Methode.
   * Wenn Sie **POST**, geben Sie anschließend den Body der Anfrage ein und wählen ein **Body-Format**) aus, für den Sie Action-Lifecycle-Postbacks einrichten möchten.

     <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>
   * . Nachfolgend ein Beispiel dafür, wie Sie jeden Datenpunkt für ein JSON-Format zuordnen möchten. Die Schlüssel in jedem Schlüssel-Wert-Paar sollten aus der Einrichtung Ihres eigenen Systems stammen, und die Werte werden der von impact.com bereitgestellte entsprechende Datenpunkt sein, der in geschweiften Klammern { } eingegeben werden sollte. [verfügbaren Body-Parameter](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Sehen Sie einen benötigten Wert nicht? Wenden Sie sich an Ihren Account Manager (oder [Support kontaktieren](https://app.impact.com/support/portal.ihtml)).
8. Auswählen **Sehen Sie einige der impact.com**). Diese Einstellungen sind optional.
   * Geben Sie eine(n) **Mindestverzögerung** zwischen dem Zeitpunkt, an dem ein nicht standardmäßiges Ereignis eintritt, und dem Zeitpunkt, an dem das Postback generiert und an Ihr System gesendet wird, ein.
   * Geben Sie ein Ratenlimit für die **Maximale Anfragen** an, die impact.com pro Sekunde an Ihr System senden kann.
   * Geben Sie ein, was Sie als **Erfolgsantwort** auf ein Postback möchten.
   * Geben Sie ein, was Sie als **Fehlerantwort** auf ein Postback möchten.
9. Auswählen **Speichern**.

Erweiterte Einstellungen anzeigen *Jetzt, da Sie Postbacks auf Ereignis-Level eingerichtet haben, sollte Ihr System beginnen, Postbacks für den in*Schritt 5 *Test eines Action-Lifecycle-Postbacks* abschnitt unten an.

**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 Sie zu benachrichtigen, wenn Aktionen auftreten, und die dynamisch gefüllten Werte abzurufen, die mit der Aktion verknüpft sind.

Dieses Beispiel zeigt, wie man einen `SharedId` Wert (einen Wert, den Sie mit Marken teilen möchten) an einen Parameter in einem Postback (`MyParam`) übergibt. Einige Marken können verlangen, 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 würde 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>

#### Test eines Action-Lifecycle-Postbacks

ausgewählten Ereignistyp zu erhalten. Um zu erfahren, wie Sie Ihre neue Postback-Einrichtung testen, sehen Sie sich den

<details>

<summary>Sobald Sie ein Action-Lifecycle-Postback eingerichtet haben, unabhängig davon, auf welche Ebene es zutrifft, sollten Sie es testen. Sie können entweder ein Test-Postback in impact.com ausführen (nur für Postbacks auf Ereignis-Level verfügbar) oder eine Konversion durchführen.</summary>

Führen Sie ein Test-Postback in impact.com aus

1. Wählen Sie in der oberen Navigationsleiste **Wenn Sie globale Action-Lifecycle-Postbacks eingerichtet haben, müssen Sie keine Ereignis-Level-Postbacks einrichten.**.
2. Discover → My Brands
3. Wählen Sie die Karte für die Marke aus, der das Postback gehört, das Sie testen möchten. ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **Wenn Sie ein Postback auf Ereignis-Level eingerichtet haben, können Sie es innerhalb Ihres impact.com-Kontos testen.** → **\[Mehr]**.
4. Aus dem *Mehr* 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) **Postback**\[Pfeil nach unten] Aktionen **, wählen Sie dann**.
5. Test starten **Bestätigen Sie, dass die URL des Postbacks korrekt ist, und wählen Sie dann**.

</details>

<details>

<summary>Test beginnen</summary>

Erstellen Sie eine Testkonversion

1. Wählen Sie in der oberen Navigationsleiste **Dieser Test wird nicht in der impact.com-Webanwendung durchgeführt. Stattdessen führen Sie einen End-to-End-Test durch, der einer typischen Benutzerreise folgt. Stellen Sie sicher, dass Sie Ihre Partner-Marke benachrichtigen, dass Sie den Test durchführen werden.**.
2. Content → Assets
3. Wählen Sie eine Anzeige aus. **Unterhalb des Anzeigennamens wählen Sie**.
4. Auswählen ![](https://238227448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **Tracking-Link abrufen** **\[Umschalter Ein]**.
5. Tracking-Parameter **Geben Sie** Sub-IDs **oder eine** Shared ID
   * ein, falls erforderlich. Jedes Feld erfordert mindestens eine Eingabe.
6. Überspringen Sie diesen Schritt, wenn Sie bereits Werte in diesen Feldern haben. **Optional wählen Sie eine(n)** Eigenschaft
7. Auswählen **Speichern**.
8. Auswählen **aus der Dropdown-Liste.**.
9. **Tracking-Link kopieren** Fügen Sie
10. den Link in ein neues Browserfenster ein.
11. Schließen Sie die Aktion ab.
    * Überprüfen Sie nach etwa 15 Minuten Ihr System auf das aus dieser Testaktion generierte Postback.
    * 15 Minuten sind normalerweise die Zeit, die die Aktionsverarbeitung benötigt. [Sie werden diese neue ausstehende Aktion auch auf dem](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) Bildschirm "Ausstehende Aktionen" *Sie werden diese neue ausstehende Aktion auch auf dem* sehen können. Wenn Sie die Aktion auf dem
12. Bildschirm sehen, aber noch kein Postback erhalten haben, überprüfen Sie Ihre Postback-Einrichtung erneut.
13. Bitten Sie Ihre Marke, die Aktion rückgängig zu machen.
    * Überprüfen Sie Ihr System auf das aus dieser Rückbuchung generierte Postback. [Wenn Sie die rückgängig gemachte Aktion auf dem](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) Bildschirm "Rückgängig gemachte Aktionen"

</details>

<details>

<summary>sehen, aber kein Postback erhalten haben, überprüfen Sie Ihre Postback-Einrichtung erneut.</summary>

| Fehler beheben                                                                        | Beschreibung                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Fehler                                                                                | Fehlender Pflichtparameter `Ihr Server erwartet wahrscheinlich einen Wert statt einer Variablen. Ändern Sie Ihre Postback-URL, um einen Testwert zu übergeben (z. B. „12345678“ statt`{SubId1}                                                                                                                                 |
| ) und prüfen Sie, ob der fest codierte Wert akzeptiert wird.                          | Groß-/Kleinschreibung bei Variablen `Ihr Server erwartet wahrscheinlich einen Wert statt einer Variablen. Ändern Sie Ihre Postback-URL, um einen Testwert zu übergeben (z. B. „12345678“ statt` Dynamische Variablen sind groß-/kleinschreibungsempfindlich und müssen genau sein, das heißt, `ist nicht dasselbe wie`{subid1} |
| . Überprüfen Sie, ob Ihre Variablen die korrekte Groß-/Kleinschreibung widerspiegeln. | Zugriff verweigert                                                                                                                                                                                                                                                                                                             |

</details>

{% hint style="info" %}
**Hinweis:** Die meisten Postback-Server haben ein Sicherheitstoken oder einen Wert, der zusammen mit den dynamischen Variablen übergeben werden muss. Arbeiten Sie mit dem technischen Team Ihrer Website zusammen (oder konsultieren Sie die Dokumentation Ihres Website-Anbieters), um Informationen über das Token oder den Sicherheitswert zu erhalten, der für den Zugriff auf den Server erforderlich ist. [Support kontaktieren](https://app.impact.com/support/portal.ihtml)Wenn Sie keine Probleme mit Ihrer Postback-Einrichtung finden können, aber dennoch keine Postbacks erhalten, kann impact.com prüfen, ob Postbacks generiert werden, wie der Antwortcode für diese lautet und welchen Body jedes Postbacks hat. Diese Informationen könnten Ihnen helfen, Ihre Einrichtung erfolgreich zu debuggen.
{% endhint %}
