Postbacks für den Aktionslebenszyklus einrichten
Es gibt zwei Haupttypen von Postbacks für den Action-Lifecycle. 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.
Warnung: Bei Postbacks auf globaler Ebene sollten Sie immer dann einen Postback erhalten, wenn ein „nicht standardmäßiges“ Ereignis auftritt, z. B. eine Änderung oder ein Widerruf. Beachten Sie, dass Postbacks auf Ereignisebene keine nicht standardmäßigen Action-Lifecycle-Ereignisse auslösen.
Einen Postback für den Action-Lifecycle einrichten
Einen Postback für den Action-Lifecycle auf globaler Ebene einrichten
In diesem Abschnitt wird das Erstellen von Postbacks für Ihr gesamtes Konto auf einmal behandelt. Partner, die nur ein System haben, das diese Postbacks empfangen und verarbeiten kann, oder die Benachrichtigungen für alle nicht standardmäßigen Ereignisse möchten, sollten Postbacks für den Action-Lifecycle auf globaler Ebene einrichten.
Hinweis: Wenn Sie bei den Ereignistypen, für die Sie Postbacks erhalten, selektiver vorgehen möchten, lesen Sie den folgenden Abschnitt, um Postbacks für den Action-Lifecycle auf Ereignisebene.
Wählen Sie in der oberen Navigationsleiste
[Benutzerprofil] → Einstellungen.Unter Technisch, wählen Sie Ereignisbenachrichtigungen.
Neben Action-Lifecycle-Ereignisse, wählen Sie
[Bearbeiten].Geben Sie die URL Ihres Servers ein. An diese URL sendet impact.com Postbacks.
Wählen Sie Ihre bevorzugte HTTP-Methode aus.
Sehen Sie sich einige der verfügbaren Body-Parameter von impact.com an.
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 den Einstellungen Ihres eigenen Systems stammen, und die Werte sind der von Ihnen gewählte entsprechende Datenpunkt, den impact.com bereitstellt und der in Klammern angegeben werden sollte
{ }.
Fehlt Ihnen ein benötigter Wert? Wenden Sie sich an Ihren Account Manager (oder kontaktieren Sie den Support).
Wählen Sie Action-Lifecycle-Ereignisse). Diese Einstellungen sind optional.
Geben Sie einen HTTP-Headerein. Wenn mehrere Paare benötigt werden, trennen Sie sie durch ein Semikolon.
Geben Sie eine minimale Verzögerung zwischen dem Zeitpunkt ein, an dem ein nicht standardmäßiges Ereignis auftritt, und dem Zeitpunkt, an dem der Postback generiert und an Ihr System gesendet wird.
Geben Sie ein Rate-Limit für die maximale Anzahl an Anfragen ein, die impact.com pro Sekunde an Ihr System senden kann.
Geben Sie an, was die Erfolgsantwort auf einen Postback sein soll.
Geben Sie an, was die Fehlerantwort auf einen Postback sein soll.
Wählen Sie Speichern.
Nachdem Sie nun globale Postbacks eingerichtet haben, sollte Ihr System damit beginnen, Postbacks zu empfangen, sobald nicht standardmäßige Ereignisse auftreten, unabhängig von der Marke, die die nicht standardmäßigen Aktionen ausführt. Um zu erfahren, wie Sie Ihre neue Postback-Einrichtung testen, sehen Sie sich die Einen Postback für den Action-Lifecycle testen weiter unten.
Beispiel für dynamische Werte
Wenn Sie dynamische Variablen für Ihre Tracking-Links konfiguriert haben, können Sie eine Postback-URL an Ihren eigenen Server konfigurieren, um benachrichtigt zu werden, wenn Aktionen auftreten, und die dynamisch ausgefüllten Werte, die mit der Aktion verknüpft sind, abzurufen.
Dieses Beispiel zeigt, wie ein SharedId Wert (ein Wert, den Sie mit Marken teilen möchten) an einen Parameter in einem Postback (MyParam) übergeben wird. Einige Marken verlangen möglicherweise, dass Sie dies konfigurieren.
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.
Postbacks für den Action-Lifecycle auf Ereignisebene einrichten
In diesem Abschnitt wird das Erstellen von Postbacks für bestimmte Ereignistypen behandelt, die nachverfolgen, wann Sie Aktionen vorantreiben. Wenn Sie bei den Ereignistypen, für die Sie Postbacks erhalten, selektiver vorgehen möchten, sollten Sie Postbacks für den Action-Lifecycle auf Ereignisebene einrichten.
Hinweis: Wenn Sie Postbacks für den Action-Lifecycle auf globaler Ebene einrichten, müssen Sie keine auf Ereignisebene einrichten.
Wählen Sie in der oberen Navigationsleiste Entdecken → Meine Marken.
Wählen Sie die Kachel für die Marke aus, der der Postback gehört, den Sie testen möchten.
Wählen Sie unter dem Markennamen
[Mehr] → Tracking-Integration.Wählen Sie nahe der oberen rechten Ecke der Seite Postback hinzufügen.
Wählen Sie den Ereignistyp (früher Action Tracker) aus, für den Sie Postbacks für den Action-Lifecycle einrichten möchten.
Geben Sie die URL Ihres Servers ein. An diese URL sendet impact.com Postbacks.
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 den Einstellungen Ihres eigenen Systems stammen, und die Werte sind der von Ihnen gewählte entsprechende Datenpunkt, den impact.com bereitstellt und der in geschweiften Klammern { } angegeben werden sollte.
Sehen Sie sich einige der verfügbaren Body-Parameter von impact.com an.
Fehlt Ihnen ein benötigter Wert? Wenden Sie sich an Ihren Account Manager (oder kontaktieren Sie den Support).
Wählen Sie Erweiterte Einstellungen anzeigen). Diese Einstellungen sind optional.
Geben Sie eine minimale Verzögerung zwischen dem Zeitpunkt ein, an dem ein nicht standardmäßiges Ereignis auftritt, und dem Zeitpunkt, an dem der Postback generiert und an Ihr System gesendet wird.
Geben Sie ein Rate-Limit für die maximale Anzahl an Anfragen ein, die impact.com pro Sekunde an Ihr System senden kann.
Geben Sie an, was die Erfolgsantwort auf einen Postback sein soll.
Geben Sie an, was die Fehlerantwort auf einen Postback sein soll.
Wählen Sie Speichern.
Nachdem Sie nun Postbacks auf Ereignisebene eingerichtet haben, sollte Ihr System damit beginnen, Postbacks für den Ereignistyp zu empfangen, den Sie in Schritt 5. Um zu erfahren, wie Sie Ihre neue Postback-Einrichtung testen, sehen Sie sich die Einen Postback für den Action-Lifecycle testen weiter unten.
Beispiel für dynamische Werte
Wenn Sie dynamische Variablen für Ihre Tracking-Links konfiguriert haben, können Sie eine Postback-URL an Ihren eigenen Server konfigurieren, um benachrichtigt zu werden, wenn Aktionen auftreten, und die dynamisch ausgefüllten Werte, die mit der Aktion verknüpft sind, abzurufen.
Dieses Beispiel zeigt, wie ein SharedId Wert (ein Wert, den Sie mit Marken teilen möchten) an einen Parameter in einem Postback (MyParam) übergeben wird. Einige Marken verlangen möglicherweise, dass Sie dies konfigurieren.
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.
Einen Postback für den Action-Lifecycle testen
Nachdem Sie einen Postback für den Action-Lifecycle eingerichtet haben, sollten Sie ihn unabhängig von der Ebene, auf die er angewendet wird, testen. Sie können entweder einen 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, wenn impact.com an Ihre Ziel-URL sendet, versucht impact.com die Zustellung automatisch erneut. impact.com versucht einen fehlgeschlagenen Postback insgesamt bis zu 15 Mal erneut. impact.com lässt die ersten 3 Wiederholungsversuche für HTTP-Antworten von 400 um 500. Die vollständige Wiederholungsplanung und Details zur Fehlerbehebung finden Sie unter Postback-URL testen und Fehler beheben.
Einen Test-Postback in impact.com ausführen
Wenn Sie einen Postback auf Ereignisebene eingerichtet haben, können Sie ihn in Ihrem impact.com-Konto testen.
Wählen Sie in der oberen Navigationsleiste Entdecken → Meine Marken.
Wählen Sie die Kachel für die Marke aus, der der Postback gehört, den Sie testen möchten.
Wählen Sie unter dem Markennamen
Mehr → Tracking-Integration.Von der Postback Abschnitt, wählen Sie
[Pfeil nach unten] Aktionen, dann wählen Sie Test starten.Bestätigen Sie, dass die URL des Postbacks korrekt ist, und wählen Sie dann Test starten.
Eine Test-Conversion erstellen
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 Benutzerreise folgt. Stellen Sie sicher, dass Sie die von Ihnen verpartnerte Marke darüber informieren, dass Sie den Test durchführen werden.
Wählen Sie in der oberen Navigationsleiste Inhalt → Assets.
Wählen Sie eine Anzeige aus.
Wählen Sie unter dem Anzeigennamen Tracking-Link abrufen.
Wählen Sie
[Einschalten] Tracking-Parameter.Eingabe Sub-IDs oder eine Shared ID wie erforderlich. Jedes Feld erfordert mindestens einen Eintrag.
Überspringen Sie diesen Schritt, wenn Sie bereits Werte in diesen Feldern haben.
Wählen Sie optional eine Eigenschaft aus der Dropdown-Liste.
Wählen Sie Speichern.
Wählen Sie Tracking-Link kopieren.
Fügen Sie den Link in ein neues Browserfenster ein.
Schließen Sie die Aktion ab.
Prüfen Sie nach etwa 15 Minuten in Ihrem System den Postback, der aus dieser Testaktion generiert wurde.
15 Minuten ist normalerweise die Zeit, die die Verarbeitung einer Aktion dauert.
Sie können diese neue ausstehende Aktion auch auf dem Ausstehende Aktionen Bildschirm sehen. Wenn Sie die Aktion auf dem Ausstehende Aktionen Bildschirm sehen, aber noch keinen Postback erhalten haben, überprüfen Sie Ihre Postback-Einrichtung noch einmal.
Bitten Sie Ihre Marke, die Aktion zu widerrufen.
Prüfen Sie in Ihrem System den Postback, der aus diesem Widerruf generiert wurde.
Wenn Sie die widerrufene Aktion auf dem Widerrufene Aktionen Bildschirm sehen, aber keinen Postback erhalten haben, überprüfen Sie Ihre Postback-Einrichtung noch einmal.
Fehler beheben
Pflichtparameter fehlt
Ihr Server erwartet wahrscheinlich einen Wert anstelle einer Variablen. Ändern Sie Ihre Postback-URL so, dass Sie einen Testwert übergibt (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ß-/kleinschreibungsempfindlich und müssen exakt sein, das heißt, dass {SubId1} nicht dasselbe ist wie {subid1}. Überprüfen Sie sorgfältig, ob Ihre Variablen die richtige Groß-/Kleinschreibung aufweisen.
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 technischen Team Ihrer Website zusammen (oder lesen Sie die Dokumentation Ihres Website-Anbieters), um mehr über das Token oder den Sicherheitswert zu erfahren, der für den Zugriff auf den Server erforderlich ist.
Hinweis: Wenn Sie keine Probleme mit Ihrer Postback-Einrichtung finden, aber sie dennoch nicht erhalten, kontaktieren Sie den Supportkann impact.com prüfen, ob Postbacks generiert werden, wie der Antwortcode für jeden einzelnen ist und wie der Body für jeden Postback aussieht. Diese Informationen können Ihnen möglicherweise dabei helfen, Ihre Einrichtung zu debuggen.
Zuletzt aktualisiert
War das hilfreich?