Open RTB 2.4 Spezifikationen für Gebotsanfragen
Auf dieser Seite werden die verschiedenen Komponenten der RTB-Anfragen beschrieben, die Sie erhalten, um ein Gebot abgeben zu können.
Angebotsanfrage-Kopfzeilen
- OpenRTB Version HTTP Header: x-openrtb-version: 2.4
- Keep-Alive HTTP Header: Verbindung: Keep-Alive
- Inhalt JSON: Inhalt-Typ: application/json
- Datenverschlüsselungs-Header: Accept-Encoding
Angebotsanfrage
Bei der Anforderung von Geboten für einen bestimmten Kontext führt die Plattform eine HTTP-Anforderung mit einer Zeitüberschreitung von 300ms durch und sendet das folgende Objekt als JSON kodiert im Anforderungskörper. aufgrund der zusätzlichen Latenz bei Verwendung von HTTPS wird HTTP** empfohlen.
| Attribut | Beschreibung |
|---|
| unter | Auktionstyp, erster Preis = 1 (int) |
| id | Eindeutige ID der Angebotsanfrage (String) |
| imp | Objekt, das den angebotenen Eindruck darstellt (Objekt). |
| website | Details über ein Site-Objekt über die Website des Herausgebers (Objekt). |
| gerät | Angaben über ein Device-Objekt zum Gerät des Nutzers, an das der Eindruck geliefert wird (Objekt). |
| benutzer | Details über ein User-Objekt über den menschlichen Nutzer des Geräts; das Werbepublikum (Objekt). |
| ext | Platzhalter für börsenspezifische Erweiterungen. |
imp
| Attribut | Beschreibung |
|---|
| id | Eindeutige Impression-ID in dieser Gebotsanfrage (String) |
| bidfloor | Mindestgebot für diese Impression (CPM) / Klick (CPC) und Kontowährung, optional (float). |
| bidfloorcur | Währung für Mindestgebotswert unter Verwendung von ISO-4217-Alpha-Codes, optional (string) |
| einheimische | Ein Native-Objekt; erforderlich, wenn diese Impression als Native Ad Opportunity (Objekt) angeboten wird. |
| banner | Ein Banner-Objekt; erforderlich, wenn diese Impression als Banner-Anzeigengelegenheit (Objekt) angeboten wird. |
| instl | Ein Interstitial-Objekt; erforderlich, wenn diese Impression als Interstitial- oder Popunder-Anzeigenmöglichkeit angeboten wird (Objekt). (Objekt). |
| sicher | Kennzeichen, das angibt, ob der Eindruck sichere HTTPS-URL-Creative-Assets und Markup erfordert, wobei 0 = nicht sicher, 1 = sicher. Wird das Kennzeichen weggelassen, ist der sichere Status unbekannt, aber es kann von einer nicht sicheren HTTP-Unterstützung ausgegangen werden, optional (Ganzzahl) |
| el | Base64-kodierte E-Mail (Zeichenfolge) |
imp.banner
| Attribut | Beschreibung |
|---|
| w | Breite des Banners in Pixel (Ganzzahl). |
| h | Höhe des Banners in Pixel (Ganzzahl). |
| mimt | Unterstützte MIME-Typen. Beispielwerte: image/jpg, image/png, video/mp4, image/webp. |
imp.instl
| Attribut | Beschreibung |
|---|
| instl | Flagge, die angibt, ob es sich um eine Popunder/Interstitial-Anzeige handelt (Ganzzahl): 1=true, 0=false |
imp.native (Native & Push-Benachrichtigungen)
| Attribut | Beschreibung |
|---|
| anfrage | Anfrage-Payload gemäß der Native Ads-Spezifikation - ein JSON-kodierter String der Native Ads-Anfrage einschließlich des nativen Top-Level-Objekts (JSON-Objekt) |
| ver | Version der Dynamic Native Ads API, der request entspricht (string) |
imp.native.request
| Attribut | Beschreibung |
|---|
| ver | Version der verwendeten Native Markup Version (string) |
| kontext | Der Kontext, in dem die Anzeige erscheint. In diesem Fall ist es 1 (Inhaltsbezogener Kontext wie Newsfeed, Artikel, Bildergalerie, Videogalerie oder ähnliches), optional (ganze Zahl) |
| plcmttype | Das Design/Format/Layout des angebotenen Anzeigenblocks. Derzeit unterstützen wir 4 (Empfehlungs-Widget) und 500 (Push Notification) (Ganzzahl) |
| plcmtcnt | Die Anzahl der identischen Platzierungen in diesem Layout (Integer) |
| vermögenswerte | Ein Array von Asset-Objekten. Jede Gebotsantwort muss dem in der Gebotsanfrage angegebenen Array von Elementen entsprechen (Array von JSON-Objekten) |
| seq | 0 für die erste Anzeige, 1 für die zweite Anzeige, und so weiter. Beachten Sie, dass dies in der Regel NICHT in Kombination mit plcmtcnt verwendet wird - entweder versteigern Sie mehrere identische Platzierungen (in diesem Fall plcmtcnt>1, seq=0) oder Sie führen getrennte Auktionen für verschiedene Positionen im Feed durch (in diesem Fall plcmtcnt=1, seq=>=1) |
imp.native.request.assets
| Attribut | Beschreibung |
|---|
| id | Eindeutige Asset-ID, die von der Börse vergeben wird. In der Regel ein Zähler für das Array (Integer) |
| erforderlich | Auf 1 gesetzt, wenn Asset erforderlich ist, oder 0, wenn Asset optional ist** (Ganzzahl) |
| plcmtcnt | Die Anzahl der identischen Platzierungen in diesem Layout (Integer) |
| img | Image-Objekt für Bild-Assets* (JSON-Objekt) |
| titel | Title-Objekt für Titel-Assets* (JSON-Objekt) |
| daten | Datenobjekt für Markenname, Beschreibung, Bewertungen, Preise usw.* (JSON-Objekt) |
| video | Video-Objekt für Video-Assets. Siehe die Definition des Video-Anforderungsobjekts. Beachten Sie, dass In-Stream-Videoanzeigen (d. h. Preroll-Anzeigen usw.) nicht Teil von Native sind. Native Anzeigen können ein Video als das eigentliche Anzeigenmotiv (Objekt) enthalten. |
* In jedem Asset-Objekt sollte nur eines der Objekte {img, title, data} vorhanden sein
** Assets werden entsprechend der Konfiguration der Publisher-Zone, in der Ihre Anzeige angezeigt werden kann, als erforderlich gekennzeichnet
imp.native.request.assets.img
| Attribut | Beschreibung |
|---|
| typ | Typ-ID des vom Verlag unterstützten Bildelements. Wir unterstützen: 1 (Icon-Bild) (Ganzzahl), 3 (Große Bildvorschau für die Anzeige) (Ganzzahl) |
| w | Breite des Bildes in Pixel, optional (Ganzzahl) |
| h | Höhe des Bildes in Pixel, optional (Ganzzahl) |
| wmin | Die geforderte Mindestbreite des Bildes in Pixel (Ganzzahl) |
| hmin | Die geforderte Mindesthöhe des Bildes in Pixeln (Ganzzahl) |
imp.native.request.assets.title
| Attribut | Beschreibung |
|---|
| len | Maximale Länge des Textes im Titelelement. (Ganzzahl) |
imp.native.request.assets.video
| Attribut | Beschreibung |
|---|
| mimt | Liste der unterstützten MIME-Typen (String-Array). |
| minduration | Mindestdauer der Videoanzeige in Sekunden (ganze Zahl). |
| maxduration | Maximale Dauer der Videoanzeige in Sekunden (ganze Zahl). |
| protokolle | Liste der unterstützten Video-Bid-Response-Protokolle (Integer-Array). |
| linearität | Gibt an, ob der Abdruck linear, nichtlinear usw. sein muss (Ganzzahl). |
| boxen erlaubt | Gibt an, ob das Letterboxing von 4:3-Inhalten in einem 16:9-Fenster erlaubt ist (Ganzzahl). |
imp.native.request.assets.data
| Attribut | Beschreibung |
|---|
| typ | Typ-ID des vom Verlag unterstützten Elements (Ganzzahl). Wir unterstützen: 1 (sponsored - Gesponserte Nachricht, deren Antwort den Markennamen des Sponsors enthalten sollte), 2 (desc - Beschreibender Text für das beworbene Produkt oder die Dienstleistung) |
| len | Maximale Länge des Textes in der Antwort des Elements (Ganzzahl) |
imp.video
| Attribut | Beschreibung |
|---|
| mimt | Liste der unterstützten Mime-Typen (String-Array) |
| protokolle | Liste der unterstützten Video-Bid-Response-Protokolle (int-Array) |
| überspringen | Gibt an, ob der Player das Überspringen des Videos zulässt, wobei 0 = nein, 1 = ja |
| überspringen nach | Anzahl der Sekunden, die ein Video abgespielt werden muss, bevor das Überspringen aktiviert wird; gilt nur, wenn die Anzeige überspringbar ist |
| skipmin | Videos mit einer Gesamtdauer von mehr als dieser Anzahl von Sekunden können übersprungen werden; gilt nur, wenn die Anzeige überspringbar ist |
Hinweis: Wenn der Herausgeber in der Anfrage "skip", aber nicht "skipafter" angibt, kann das Video nach 5 Sekunden übersprungen werden. In der Antwort wird "skipoffset" auf 5 gesetzt. Wenn der Herausgeber "skip", aber nicht "skipmin" angibt, ist das Video unabhängig von seiner Dauer überspringbar.
website
| Attribut | Beschreibung |
|---|
| id* | Eindeutige Standort-ID (String) |
| bereich* | Domänenname der Website (String) |
| katze | IAB-Kategorie-ID (String-Array) |
| seite | Vollständige URL der Seite, auf der die Anzeige erscheinen soll (String) |
| schlüsselwörter | Mit Hilfe von Schlüsselwörtern kann sichergestellt werden, dass Anzeigenbereiche die richtige Art von Werbung erhalten. Schlüsselwörter sollten aus einer durch Komma getrennten Wortfolge bestehen |
| ext | Platzhalter für börsenspezifische Erweiterungen von OpenRTB. |
*Diese Attribute sind für die Formate Direktlink und E-Mail-Klicks obligatorisch.
site.ext
| Attribut | Beschreibung |
|---|
| austauschkatze | Benutzerdefinierte ExoClick-Kategorie-ID (ganze Zahl) |
| idzone | Benutzerdefinierte ExoClick-Anzeigenzonen-ID (ganze Zahl) |
| stichwort | Passendes Schlüsselwort, falls vorhanden (String) |
Das Attribut idzone wird verwendet, um die Quelle in ExoClick zu identifizieren, aus der der Verkehr kommt.
gerät
| Attribut | Beschreibung |
|---|
| ua | Browser-Benutzer-Agent (String) |
| geo | Als Standort des Geräts wird der aktuelle Standort des Benutzers angenommen, der durch ein Geo-Objekt definiert ist. |
| ip | IP-Adresse des Benutzers (String)* |
| ipv6 | IPv6-Adresse des Benutzers (String)* |
| sprache | Browsersprache nach ISO-639-1-alpha-2 (string) |
| os | Betriebssystem (string) |
| js | Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Ganzzahl) |
| ext | Platzhalter für börsenspezifische Erweiterungen zu OpenRTB |
gerät.geo
| Attribut | Beschreibung |
|---|
| land | Land ISO3 |
gerät.ext
| Attribut | Beschreibung |
|---|
| remote_addr | Haupt-IP-Adresse des Benutzers (String) |
| x_weitergeleitet_für | X-FORWARDED-FOR IP-Adresse des Benutzers oder leer, wenn nicht festgelegt (string) |
benutzer
| Attribut | Beschreibung |
|---|
| id | Eindeutige Benutzer-ID (String) |
ext
| Attribut | Erforderlich? | Beschreibung |
|---|
| unter | Nein | Die Sub ist eine ganze Zahl, die die ID der Zone angibt, aus der die Anfrage stammt. |
regs.ext
| Attribut | Beschreibung |
|---|
| dsaAnwendung | Kennzeichen, das angibt, ob DSA auf die Anfrage angewendet wird. 1 = Erforderlich (int) |
| dsa | Erweiterung für DSA-Transparenzinformationen (Objekt) |
regs.ext.dsa
| Attribut | Beschreibung |
|---|
| erforderlich | Kennzeichen, das angibt, ob DSA-Informationen zur Verfügung gestellt werden sollen. 0 = Nicht erforderlich, 1 = Unterstützt, Angebote mit oder ohne DSA-Objekt werden akzeptiert, 2 = Erforderlich, Angebote ohne DSA-Objekt werden nicht akzeptiert, 3 = Erforderlich, Angebote ohne DSA-Objekt werden nicht akzeptiert, Publisher ist eine Online-Plattform (int) |
| datatopub | Der Verleger benötigt die Transparenzdaten möglicherweise für Prüfungszwecke. 0 = keine Transparenzdaten senden, 1 = optional, um Transparenzdaten zu senden, 2 = Transparenzdaten senden (int) |
Hinweis: *Wenn Sie dsaapply: 1 und erforderlich: 2 oder 3, ist es zwingend erforderlich, dsa-Attribute mit Werten in der Antwort hinzuzufügen, andernfalls wird die Antwort zurückgewiesen.
Beispiele
Eine vollständige Liste aller Arten von Anfragen, die Sie erhalten können, finden Sie auf unserer Beispielseite für Anzeigenanfragen.