Mit Postback-Tracking sendet HilltopAds Ereignisbenachrichtigungen direkt an dein Tracking-System. So kannst du Impressionen, Klicks und Conversions deinen eigenen Datensätzen zuordnen und bei entsprechender Konfiguration auch die Vergütungsbeträge einsehen.
Was ist ein Postback für Publisher und wie nutzt du ihn bei HilltopAds?
Ein Postback ist eine Server-zu-Server-Anfrage, die HilltopAds an deinen Tracking-Endpunkt sendet, sobald ein Ereignis eintritt, das die festgelegten Meldekriterien erfüllt.
Je nach Konfiguration kann dich ein Postback über Folgendes informieren:
Eine gezählte Impression bei Popunder-Traffic oder einen gezählten Klick auf eine Display-Anzeige.
Eine Conversion.
Die Vergütung für ein Ereignis, wenn du den entsprechenden Platzhalter einfügst.
Wenn du einen Postback für eine Impression oder einen Klick erhältst, bedeutet das, dass dieses Ereignis gezählt wurde. Die Vergütungsdaten zeigen deine Einnahmen aus CPM-Impressionen oder CPA-Conversions.
Hinweis: Postbacks melden keine verlorenen oder herausgefilterten Impressionen. Welche Benachrichtigungen du erhältst, hängt von den ausgewählten Ereignissen und dem mit deinem Account Manager vereinbarten Meldeprozentsatz ab.
So richtest du Postback-Tracking ein
Dein HilltopAds Account Manager richtet die Integration für dich ein. Bereite vorher deinen Postback-Endpunkt vor und entscheide, welche Ereignisse du verfolgen möchtest.
1. Sende deine Postback-URL an deinen Account Manager
Teile deinem Account Manager die URL des Endpunkts mit, über den dein Tracking-System Ereignisbenachrichtigungen empfängt. Zum Beispiel:
https://website.com/postback?click_uuid={externalid}&payout={payout}&uid=uidIn diesem Beispiel gilt:
click_uuidist der Parameter, über den dein Tracking-System die Kennung empfängt.{{clickId}}wird durch die eindeutige Kennung ersetzt, die über den HilltopAds-Monetarisierungslink übergeben wird.{{payout}}wird durch den Vergütungsbetrag für das gemeldete Ereignis ersetzt.uidist deine Publisher-Konto-ID. Du findest sie in deinem Dashboard.
Dein Endpunkt verwendet möglicherweise andere Parameternamen. Sende deinem Account Manager die genaue URL, die dein Tracking-System benötigt, damit er die Zuordnung prüfen kann.
Wenn dein Endpunkt zusätzliche Werte benötigt, etwa eine Nutzer-ID, stimme deren Zuordnung vor der Einrichtung mit deinem Account Manager ab.
2. Wähle aus, welche Ereignisse du empfangen möchtest
HilltopAds bietet folgende Meldeoptionen:
Impressionen oder Klicks
Ein Postback wird gesendet, wenn eine Popunder-Impression oder ein Klick auf eine Display-Anzeige gezählt wird.
Der Postback bestätigt, dass das Ereignis gezählt wurde.
Beispiel:
https://website.com/postback?click_uuid={{clickId}}Nur Conversions
Ein Postback wird gesendet, wenn eine Conversion stattfindet. Diese Option ist für Publisher hilfreich, die mit einem Direct Link arbeiten.
Beispiel:
https://website.com/postback?click_uuid={{clickId}}Alle Ereignisse mit Vergütung
Postbacks werden nur für Ereignisse gesendet, die Einnahmen für dich generieren.
Wenn beispielsweise eine Impression in einer CPA-Kampagne keine Vergütung erzeugt, löst sie keinen Postback aus. Führt später eine Conversion zu einer Vergütung, erhältst du für dieses Ereignis einen Postback.
Beispiel:
https://website.com/postback?click_uuid={{clickId}}&payout={{payout}}Hinweis: Du kannst den Platzhalter {{payout}} bei jeder Meldeoption verwenden. Die Option „Alle Ereignisse mit Vergütung“ sendet ausschließlich Benachrichtigungen für Ereignisse, die eine Vergütung erzeugen.
Alle Ereignisse
Postbacks werden sowohl für gezählte Impressionen oder Klicks als auch für Conversions gesendet.
Führt eine Impression oder ein Klick später zu einer Conversion, erhältst du zwei Postbacks mit derselben clickId: einen für die Impression oder den Klick und einen für die Conversion.
Beispiel:
https://website.com/postback?click_uuid={{clickId}}Prüfe, ob dein Tracking-System mehrere Benachrichtigungen für dieselbe Kennung verarbeiten kann.
3. Vereinbare den Meldeprozentsatz
Stimme mit deinem Account Manager ab, welcher Prozentsatz der meldefähigen Ereignisse an deinen Endpunkt gesendet werden soll.
Die Meldung kann auf einen bestimmten Anteil der Ereignisse eingestellt werden, beispielsweise 10 % oder 100 %. Der Standardwert liegt in der Regel bei 10 %, um die Systemlast gering zu halten.
Die Ereignisauswahl und der Meldeprozentsatz sind voneinander unabhängig. Die Auswahl „Alle Ereignisse“ bedeutet nicht, dass du 100 % der Benachrichtigungen erhältst. Wenn eine Stichprobenauswahl aktiviert ist, empfängt dein Tracking-System nur den vereinbarten Anteil.
Berücksichtige diesen Prozentsatz, wenn du deine Postback-Datensätze mit deinen HilltopAds-Statistiken vergleichst.
4. Füge deinem Monetarisierungslink Tracking-Parameter hinzu
Sobald der Postback eingerichtet ist, stellt dir dein Account Manager einen HilltopAds-Monetarisierungslink zur Verfügung und erklärt dir, welche Tracking-Werte du verwenden musst.
https://dengd.com/bC3aV/0.Pf3hp/vpb/m_VLJiZtD/0/3/N/T/QvwrNmTMQ/5kLbTvcJ1WNYDFAx1/NdT-Mf?clickId=PARAM_NAME&sId=PARAM_NAME
Zu den Tracking-Parametern gehören:
clickId: Deine eindeutige Impressions- oder Klick-ID. Sie wird verwendet, um Postback-Benachrichtigungen deinen Tracking-Datensätzen zuzuordnen.sId: Die Zonen-ID.
Ersetze alle Beispielwerte oder Platzhalter im Monetarisierungslink durch die richtigen Werte oder dynamischen Makros aus deinem System. Befolge dabei die Anweisungen deines Account Managers.
Dein Monetarisierungslink und deine Postback-URL erfüllen unterschiedliche Aufgaben:
Der Monetarisierungslink leitet Traffic an HilltopAds weiter.
Die Postback-URL empfängt Ereignisbenachrichtigungen von HilltopAds.
Verwende immer den Monetarisierungslink, den du von deinem Account Manager erhältst. Nutze deinen Postback-Endpunkt nicht als Ziel für deinen Traffic.
5. Prüfe die Integration
Teste die Einrichtung gemeinsam mit deinem Account Manager, bevor du sie für deinen gesamten Traffic einsetzt. Stelle sicher, dass:
Dein Endpunkt die ausgewählten Ereignisbenachrichtigungen empfängt.
Die übermittelten Kennungen mit deinen Tracking-Datensätzen übereinstimmen.
Vergütungsbeträge empfangen werden, sofern dies konfiguriert wurde.
Dein Tracker bei der Option „Alle Ereignisse“ mehrere Benachrichtigungen für dieselbe
clickIdverarbeiten kann.Der Meldeprozentsatz den vereinbarten Einstellungen entspricht.
Wenn du Hilfe bei der Einrichtung oder Fehlerbehebung deines Publisher-Postbacks benötigst, wende dich an deinen HilltopAds Account Manager.