Offene RTB-Gebotsantwort Spezifikationen
Die Antwort auf eine Angebotsanfrage sollte wie folgt aufgebaut sein:
antwort
| Attribut | Erforderlich? | Beschreibung |
|---|---|---|
| id | Ja | ID der Angebotsanfrage, auf die geantwortet wird (String) |
| seatbid | Ja | Sammlung von Geboten, die der Bieter für einen bestimmten Sitzplatz abgegeben hat (Array) |
Hinweis: Die ID muss mit der in der Anfrage angegebenen ID übereinstimmen
seatbid
| Attribut | Erforderlich? | Beschreibung |
|---|---|---|
| angebot | Ja | Array des Gebotsobjekts, das sich auf die angestrebte Impression bezieht |
seatbid.bid
| Attribut | Erforderlich? | Beschreibung |
|---|---|---|
| id | Ja | ID für das Gebotsobjekt, die für die Nachverfolgung verwendet wird (String) |
| impid | Ja | ID des Impressionsobjekts in der zugehörigen Angebotsanfrage. |
| preis | Ja | Gebotspreis in CPM oder CPC (float) |
| adm | Ja | XML/JSON-Anzeigenauszeichnung (string) |
| nurl | Ja | Win-Benachrichtigungs-URL, es wird empfohlen, HTTP über HTTPS für nurl (string) zu verwenden |
| maserung | Nein | Rechnungsbenachrichtigungs-URL, es wird empfohlen, HTTP über HTTPS für nurl (string) zu verwenden |
| crid | Empfohlen | Kreativ-ID zur Unterstützung bei der Anzeigenqualitätsprüfung (String) |
| iurl | Empfohlen | URL des Kreativen |
| ext | Nein | ExoClick-spezifische Erweiterung (Objekt) |
Anmerkungen:
- Die impid muss mit der in der Anfrage angegebenen übereinstimmen.
- Die Adm muss je nach dem angestrebten Anzeigenformat in JSON oder XML bereitgestellt werden: JSON für Native, In-Stream und Push Notifications; XML für alle anderen Formate.
- Die nURL muss mitgeteilt werden, um die Begrenzung der Kampagne zu gewährleisten und zu vermeiden, dass jedes Mal die gleiche Antwort erfolgt.
- Die bURL wird aufgerufen, wenn Impressionen oder Klicks geliefert wurden, je nach CPM oder CPC aus dem Feld btype (Standard CPM).
seatbid.bid.ext
| Attribut | Erforderlich? | Beschreibung |
|---|---|---|
| btype | Empfohlen | Preismodell. Werte: 1 = CPM, 2 = CPC. Standardwert = 1 (int). |
Anmerkung: Wenn die Antwort eine Anfrage für eine E-Mail-Klickzone ist, ist 1 = Smart CPC.
seatbid.bid.ext.dsa
| Attribut | Erforderlich? | Beschreibung |
|---|---|---|
| für | Ja | Transparenz des Inserenten: Freie UNICODE-Textzeichenfolge mit einem Namen, in dessen Namen die Anzeige angezeigt wird. Maximal 100 Zeichen. (Zeichenfolge) |
| bezahlt | Ja | Transparenz der Inserenten: Freie UNICODE-Textzeichenfolge, die angibt, wer für die Anzeige bezahlt hat. Muss immer angegeben werden, auch wenn es sich um denselben Text handelt, der im Attribut "Auftraggeber" aufgeführt ist. Maximal 100 Zeichen (Zeichenfolge) |
| adrender | Ja | Kennzeichen, das angibt, dass der Käufer/Werbetreibende seine eigenen DSA-Transparenzinformationen innerhalb des Werbemittels wiedergeben wird. 0 = Käufer/Werbungtreibender wird nicht rendern, 1 = Käufer/Werbungtreibender wird rendern (int) |
seatbid.bid.dsa.transparency
| Attribut | Erforderlich? | Beschreibung |
|---|---|---|
| domain | Ja | Domäne der Entität, die die Benutzerparameter angewendet hat (String) |
| parameter | Ja | Eine Reihe von auf der Käuferseite angewandten Benutzerparametern (unter Verwendung der von der DSA Transparency Taskforce bereitgestellten Liste). Enthält Unterstützung für mehrere Anbieter, die ihre eigenen Benutzer-Targeting-Parameter hinzufügen können. (int-Array) |
Kein Gebot Antwort
Um auf eine Gebotsanfrage zu antworten, ohne ein tatsächliches Gebot abzugeben, sollte ein HTTP-Antwortcode 204 "Kein Inhalt" gesendet werden.
Gewinn- und Rechnungsbenachrichtigungs-URLs
Wenn entweder die nURL oder die bURL in der Gebotsantwort enthalten und gültige URLs sind, sendet die ExoClick-Plattform eine GET-Anfrage an diese. Diese URLs können einige Token enthalten, die von ExoClick vor der GET-Anfrage ersetzt werden müssen:
${AUCTION_ID} - ID of the bid request; from "Bid Request Object -> id" attribute.
${AUCTION_BID_ID} - ID of the bid; from "Bid Response Object -> bidid" attribute.
${AUCTION_IMP_ID} - ID of the impression just won; from "Bid Request Object -> Impression Object -> id" attribute.
${AUCTION_SEAT_ID} - ID of the bidder seat for whom the bid was made; from "Bid Response Object -> Seat Bid Object -> Bid Object -> id" attribute.
${AUCTION_AD_ID} - ID of the ad markup the bidder wishes to serve; from "Bid Response Object -> Seat Bid Object -> Bid Object -> adid" attribute.
${AUCTION_PRICE} - Settlement price using the same currency and units as the account; from "Bid Response Object -> Seat Bid Object -> Bid Object -> price" attribute.
${AUCTION_CURRENCY} - The currency used in the bid (explicit or implied); for confirmation only.
Beispiel:
https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}¤cy=${AUCTION_CURRENCY}
Wenn Sie sowohl nURL als auch bURL verwenden, wird ExoClick beide aufrufen.
ADM-Struktur
Depending on the ad format, the adm parameter can contain a piece of XML or JSON. You can find detailed examples of adm structures in our examples page
Bitte beachten Sie bei der Erstellung des ADM folgende Punkte:
- iFrame Markups (Banner, Fullpage Interstitial) müssen in Ihrem ExoClick-Konto aktiviert sein, um sie nutzen zu können.
- In-Stream, Native und Push Notification-Anzeigen sollten eine JSON-kodierte Zeichenfolge in der Adm enthalten.
- Der Parameter adm von In-Stream kann einer von zwei Strukturen folgen: Remote VAST oder Local VAST. Bei Remote VAST müssen Sie lediglich die URL angeben, unter der sich der VAST-Wrapper befindet, während Sie bei Local VAST zusätzlich zu "videoURL" und "clickURL" alle "trackingEvents " angeben müssen, die Sie verfolgen möchten.
Derzeit unterstützen wir die Ereignisse Eindruck, Fortschritt und Vollständig. Impression- und Progress-Ereignisse sind obligatorisch, während "Complete" nur hinzugefügt werden kann, wenn Sie Local VAST verwenden.
The ADM must follow the same structure as shown in our example above.
Als optionalen Parameter können Sie crop_anchor_point in den JSON-String der Native Ads-Adm einfügen, um zu bestimmen, wo sich der Ankerpunkt Ihres nativen Bildes befindet. Die verfügbaren Werte sind:
- MITTE_ZENTRUM = 0,
- TOP_LEFT = 1,
- TOP_CENTER = 2,
- TOP_RIGHT = 3,
- MITTE_LINKS = 4,
- MITTE_RECHTS = 5,
- UNTEN_LINKS = 6,
- UNTEN_MITTE = 7,
- UNTEN_RECHTS= 8
Hier sehen Sie eine Visualisierung der verfügbaren Ankerpunkte:
- Also, regarding Native Ads, make sure that you are adding your eventtrackers according to the latest native specification
Beachten Sie, dass wir zwar auch imptrackers in Native Ads zulassen, aber dringend empfehlen, stattdessen eventtrackers zu verwenden.
- bei Push Notification**-Anzeigen ist nur ein Bild-Asset pro Benachrichtigung zulässig. Die Breite und Höhe hängen davon ab, was von der Anfrage kommt, die 192x192 oder 720x480 sein kann. Beachten Sie, dass die adm auch ein JSON-kodierter String sein muss, da die Anfrage von einem Native-Objekt kommt.
- Schließlich erlauben Push Notification-Anzeigen nur eine "imptracker" URL
Beispiele
You can find detailed examples from Bid responses and ADM structures in our Advertiser Response example page