ExoClick RTB Bid Response Spezifikationen
Die ExoClick RTB Bid Response kann mit JSON und XML erfolgen. Die Antwort für eine Gebotsanfrage sollte die folgende Struktur haben:
Objekt der Angebotsantwort
Attribut | Beschreibung |
---|---|
id | ID des Impression-Objekts, für das dieses Angebot gilt (String) |
imgUrl | Bild-Url (nur für Typ-Banner) |
iconUrl | Icon url (nur für Typ push_notification und muss die gewünschte Größe haben) |
clickUrl | Weiterleitung der URL, wenn die Kampagne angeklickt wird (für den Typ Banner oder push_notification) |
url | Weiterleitung der Url, wenn die Kampagne angeklickt wird (nur für den Typ Popunder) |
titel | Titel der Anzeige (nur bei Typ push_notification) |
beschreibung | Beschreibung der Anzeige (nur bei Typ push_notification) |
wert | Gebotspreis in CPM oder CPC (float) |
imptrackers | Impression Tracker, optional (nur für Typ push_notification) |
btype | Preismodell. Werte: 1 = CPM, 2 = CPC. Voreinstellung = 1 (int). Wenn die Antwort eine Anfrage für eine E-Mail-Klickzone ist, ist 1 = Smart CPC. |
bUrl | Rechnungsbenachrichtigungs-URL, es wird empfohlen, HTTP über HTTPS für bUrl zu verwenden |
Anmerkungen:
- das Attribut "id " sollte mit der "id" in der Anfrage übereinstimmen**.
- das Anzeigenformat Push Notification kann Gebote mit dem CPC-Preismodell erhalten. das Format Direct Link kann auch für Email Click-Zonenanfragen verwendet werden.
- Außerdem ist bei Push-Benachrichtigungsanzeigen nur eine imptracker URL erlaubt.
- bURL wird aufgerufen, wenn eine Impression oder ein Klick geliefert wurde, je nach CPM oder CPC aus dem Feld btype (standardmäßig CPM)
Kein Gebot Antwort
Um eine Gebotsanfrage zu beantworten, ohne ein tatsächliches Gebot abzugeben, sollte ein HTTP-Antwortcode 204 "Kein Inhalt" gesendet werden.
Hinzufügen dynamischer Token zu Ihrem Endpunkt
Zusätzlich zu den Informationen, die Sie über die Anfrage erhalten, können Sie auch dynamische Token zu Ihrem Endpunkt hinzufügen. So können Sie bei der Überprüfung der eingegangenen Anfragen schnell den Ursprung der Anfrage feststellen.
Hier finden Sie die am häufigsten verwendeten Token von ExoClick:
- {site_id}: Die ID-Nummer der Website, auf der die Anzeige angezeigt wird.
- {zone_id}: Die ID der Anzeigenzone, in der die Anzeige angezeigt wird.
- {src_hostname}: Der Name der Website, die der Publisher für die Anzeige von Anzeigen angegeben hat, ohne das HTTP-Protokoll am Anfang (z. B. examplesite.com).
- {url}: Die vollständige URL der Website, die der Publisher an das Admin-Panel für die Anzeige von Anzeigen übermittelt hat, einschließlich des HTTP-Protokolls (z. B. https://examplesite.com). Hinweis: Mit diesem Token wird nicht die URL angezeigt, unter der die Anzeige dem Nutzer angezeigt wurde, sondern nur die URL, die in unserer Plattform registriert ist.
- {Tags}: Die Liste der Keywords, die für diese Ad Impression identifiziert wurden.
- {keyword}: Das Schlüsselwort, das bei Kampagnen, die auf bestimmte Schlüsselwörter abzielen, gefunden wurde. Dieser Wert ist leer, wenn es keine Übereinstimmung gibt.
- {Sprache}: Die Sprache des Besuchers.
- {&empty=204}: Fügen Sie es dem Endpunkt hinzu, wenn Sie eine Antwort "Kein Gebot" zurückgeben.
- {imp_id}: Hinzufügen, um die Impression-ID im Endpunkt zu erhalten.
Wenn Sie andere Token benötigen oder zusätzliche Details nachverfolgen müssen, wenden Sie sich bitte an Ihren Kundenbetreuer.
Beispiele
You can find detailed examples from Bid response in our Advertiser Response example page