Spezifikationen für offene RTB-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
When requesting bids for a specific context, the platform will perform an HTTP request with a timeout of 300ms and send the following object encoded as JSON in the request body. HTTP is recommended due to extra latency when using HTTPS.
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 interstitielles Objekt; erforderlich, wenn diese Impression als interstitielle Werbegelegenheit (Objekt) angeboten wird. |
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). |
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.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.native.request.assets.video | |
Attribut | Beschreibung |
---|
mimt | Liste der unterstützten Mime-Typen (String-Array) |
minduration | Mindestdauer der Videoanzeige in Sekunden(int). |
maxduration | Maximale Dauer der Videoanzeige in Sekunden(int). |
protokolle | Liste der unterstützten Video-Bid-Response-Protokolle (int-Array) |
linearität | Gibt an, ob der Eindruck linear, nichtlinear usw. sein muss (int) |
boxen erlaubt | Gibt an, ob das Letterboxing von 4:3-Inhalten in einem 16:9-Fenster erlaubt ist (int) |
--> | |
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
You can find a complete list of all the types of requests you can receive in our Advertiser Request example page.