Open RTB 2.4 Gebotsanfrage
Diese Seite beschreibt die verschiedenen Komponenten der RTB-Anfragen, die Sie erhalten werden, um Gebote abzugeben.
Gebotsanfrage-Header
OpenRTB-Version-HTTP-Header:
x-openrtb-version: 2.4Keep-Alive-HTTP-Header:
Connection: Keep-AliveJSON-Inhalt:
Content-Type: application/jsonHeader für Datenkodierung:
Accept-Encoding
Gebotsanfrage-Objekt
Beim Anfordern von Geboten für einen bestimmten Kontext führt die Plattform eine HTTP-Anfrage mit einem Timeout von 300ms aus und sendet das folgende Objekt als JSON kodiert im Anfragetext. HTTP wird aufgrund zusätzlicher Latenz bei Verwendung von HTTPS empfohlen.
um
Auktionstyp, First-Price = 1 (int)
id
Eindeutige Gebotsanfrage-ID (String)
imp
Objekt, das die angebotene Impression darstellt (Objekt).
site
Details über die Website des Publishers mithilfe eines Site-Objekts (Objekt).
device
Details über das Gerät des Nutzers, dem die Impression geliefert wird, mithilfe eines Device-Objekts (Objekt).
user
Details über den menschlichen Nutzer des Geräts; die Werbezielgruppe (Objekt).
ext
Platzhalter für austauschspezifische Erweiterungen.
imp
id
Eindeutige Impression-ID innerhalb dieser Gebotsanfrage (String)
bidfloor
Mindestgebot für diese Impression (CPM) / Klick (CPC) und Kontowährung, optional (Float).
bidfloorcur
Währung für den angegebenen Mindestgebotswert gemäß ISO-4217-Alphabetcodes, optional (String)
native
Ein Native-Objekt; erforderlich, wenn diese Impression als Native-Anzeigenmöglichkeit angeboten wird (Objekt).
banner
Ein Banner-Objekt; erforderlich, wenn diese Impression als Banner-Anzeigenmöglichkeit angeboten wird (Objekt).
instl
Ein Interstitial-Objekt; erforderlich, wenn diese Impression als Interstitial- oder Popunder-Anzeigenmöglichkeit angeboten wird (Objekt).(Objekt).
secure
Kennzeichen, das angibt, ob die Impression sichere HTTPS-URL-Creative-Assets und Markup erfordert, wobei 0 = nicht sicher, 1 = sicher. Wenn weggelassen, ist der Sicherheitsstatus unbekannt, aber es kann von nicht sicherer HTTP-Unterstützung ausgegangen werden, optional (Integer)
el
Base64-kodierte E-Mail (String)
imp.banner
w
Breite des Banners in Pixeln (Integer).
h
Höhe des Banners in Pixeln (Integer).
mimes
Unterstützte MIME-Typen. Beispielwerte: image/jpg, image/png, video/mp4, image/webp.
imp.instl
instl
Kennzeichen, das angibt, ob die Anzeige ein Popunder/Interstitial ist (Integer): 1=true, 0=false
imp.native (Native- & Push-Benachrichtigungen)
request
Anfrage-Payload gemäß der Native-Ad-Spezifikation – ein JSON-kodierter String der Native-Ads-Anfrage einschließlich ihres native obersten Objekts (JSON-Objekt)
ver
Version der Dynamic Native Ads API, der request entspricht (String)
imp.native.request
ver
Version der verwendeten Native-Markup-Version (String)
context
Der Kontext, in dem die Anzeige erscheint. In diesem Fall ist es 1 (Inhaltszentrierter Kontext wie Newsfeed, Artikel, Bildergalerie, Videogalerie oder Ähnliches), optional (Integer)
plcmttype
Das Design/Format/Layout der angebotenen Anzeigeneinheit. Derzeit unterstützen wir 4 (Empfehlungs-Widget) und 500 (Push-Benachrichtigung) (Integer)
plcmtcnt
Die Anzahl identischer Platzierungen in diesem Layout (Integer)
assets
Ein Array von Asset-Objekten. Jede Gebotsantwort muss dem im Gebots-Request angegebenen Array von Elementen entsprechen (Array von JSON-Objekten)
seq
0 für die erste Anzeige, 1 für die zweite Anzeige usw. Beachten Sie, dass dies im Allgemeinen NICHT in Kombination mit plcmtcnt verwendet wird – entweder versteigern Sie mehrere identische Platzierungen (in diesem Fall plcmtcnt>1, seq=0) oder Sie führen separate Auktionen für unterschiedliche Elemente im Feed durch (in diesem Fall plcmtcnt=1, seq=>=1)
imp.native.request.assets
id
Eindeutige Asset-ID, vom Exchange zugewiesen. Typischerweise ein Zähler für das Array (Integer)
erforderlich
Setzen auf 1 wenn das Asset erforderlich ist oder 0 wenn das Asset optional ist** (Integer)
plcmtcnt
Die Anzahl identischer Platzierungen in diesem Layout (Integer)
img
Bildobjekt für Bild-Assets* (JSON-Objekt)
title
Titelobjekt für Titel-Assets* (JSON-Objekt)
data
Datenobjekt für Markenname, Beschreibung, Bewertungen, Preise usw.* (JSON-Objekt)
video
Videoobjekt für Video-Assets. Siehe die Definition des Video-Request-Objekts. Beachten Sie, dass In-Stream-Videowerbung (z. B. Pre-Roll usw.) nicht Teil von Native ist. Native-Anzeigen können ein Video als Werbemittel selbst enthalten (Objekt).
* In jedem Asset-Objekt sollte nur eines der Objekte {img, title, data} vorhanden sein
** Assets werden gemäß der Konfiguration der Publisher-Zone, in der Ihre Anzeige angezeigt werden kann, als erforderlich markiert
imp.native.request.assets.img
type
Typ-ID des vom Publisher unterstützten Bildelements. Wir unterstützen: 1 (Icon-Bild) (Integer), 3 (Große Bildvorschau für die Anzeige) (Integer)
w
Breite des Bildes in Pixeln, optional (Integer)
h
Höhe des Bildes in Pixeln, optional (Integer)
wmin
Die angeforderte Mindestbreite des Bildes in Pixeln (Integer)
hmin
Die angeforderte Mindesthöhe des Bildes in Pixeln (Integer)
imp.native.request.assets.title
len
Maximale Textlänge im Titel-Element. (Integer)
imp.native.request.assets.video
mimes
Liste der unterstützten MIME-Typen (String-Array).
minduration
Minimale Dauer der Videoanzeige in Sekunden (Integer).
maxduration
Maximale Dauer der Videoanzeige in Sekunden (Integer).
protocols
Liste der unterstützten Protokolle für Video-Gebotsantworten (Integer-Array).
linearity
Gibt an, ob die Impression linear, nichtlinear usw. sein muss. (Integer).
boxingallowed
Gibt an, ob Letterboxing von 4:3-Inhalten in einem 16:9-Fenster erlaubt ist (Integer).
imp.native.request.assets.data
type
Typ-ID des vom Publisher unterstützten Elements (Integer). Wir unterstützen: 1 (sponsored - Sponsored-By-Nachricht, bei der die Antwort den Markennamen des Sponsors enthalten sollte), 2 (desc - Beschreibender Text zum beworbenen Produkt oder Dienst)
len
Maximale Textlänge in der Antwort des Elements (Integer)
imp.video
mimes
Liste der unterstützten MIME-Typen (String-Array)
protocols
Liste der unterstützten Protokolle für Video-Gebotsantworten (Integer-Array)
skip
Gibt an, ob der Player das Überspringen des Videos erlaubt, wobei 0 = nein, 1 = ja
skipafter
Anzahl der Sekunden, die ein Video abgespielt werden muss, bevor das Überspringen aktiviert wird; nur anwendbar, wenn die Anzeige überspringbar ist
skipmin
Videos mit einer Gesamtdauer von mehr als dieser Anzahl von Sekunden können überspringbar sein; nur anwendbar, wenn die Anzeige überspringbar ist
Wenn der Publisher "skip" in der Anfrage, aber nicht "skipafter" angibt, ist das Video nach 5 Sekunden überspringbar. Die Antwort setzt "skipoffset" auf 5. Wenn der Publisher "skip", aber nicht "skipmin" angibt, ist das Video unabhängig von seiner Dauer überspringbar.
site
id*
Eindeutige Site-ID (String)
domain*
Domainname der Website (String)
cat
IAB-Kategorie-ID (String-Array)
page
Vollständige URL der Seite, auf der die Anzeige angezeigt wird (String)
keywords
Keywords können verwendet werden, um sicherzustellen, dass Anzeigeflächen die richtige Art von Werbung erhalten. Keywords sollten eine Zeichenkette aus durch Kommas getrennten Wörtern sein
ext
Platzhalter für austauschspezifische Erweiterungen zu OpenRTB.
*Diese Attribute sind für die Formate Direct Link und Email Clicks verpflichtend.
site.ext
exchangecat
Benutzerdefinierte ExoClick-Kategorie-ID (Integer)
idzone
Benutzerdefinierte ExoClick-Anzeigenzonen-ID (Integer)
keyword
Passendes Keyword, falls vorhanden (String)
Das Attribut idzone wird verwendet, um die Quelle in ExoClick zu identifizieren, von der der Traffic kommt.
device
ua
Browser-User-Agent (String)
sua
Strukturierte User-Agent-Informationen, die verwendet werden können, wenn ein Client User-Agent Client Hints unterstützt (Objekt)
geo
Standort des Geräts, angenommen als aktueller Standort des Nutzers, definiert durch ein Geo-Objekt.
ip
IP-Adresse des Nutzers (String)*
ipv6
IPv6-Adresse des Nutzers (String)*
language
Browsersprache gemäß ISO-639-1-Alpha-2 (String)
os
Betriebssystem (String)
js
Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Integer)
ext
Platzhalter für austauschspezifische Erweiterungen zu OpenRTB
*Genau eines von ip oder ipv6 ist im Gebots-Request vorhanden.
device.geo
country
Ländercode ISO3
device.ext
remote_addr
Haupt-IP-Adresse des Nutzers (String)
x_forwarded_for
X-FORWARDED-FOR-IP-Adresse des Nutzers oder leer, falls nicht gesetzt (String)
device.sua
Strukturierte User-Agent-Informationen. device.sua gilt als die genauere Darstellung der Geräteattribute.
browsers
Sende Marken und Versionen, die aus dem Header Sec-CH-UA-Full-Version-List abgeleitet wurden. (Array von BrandVersion Objekten)
platform
Sende eine Marke, die aus dem Header Sec-CH-UA-Platform abgeleitet wurde, und eine Version, die aus dem Header Sec-CH-UA-Platform-Version abgeleitet wurde. (BrandVersion Objekt)
mobile
Leite diesen Wert aus dem Header Sec-CH-UA-Mobile ab. (Integer)
architecture
Rufe diesen Wert aus dem Header Sec-CH-UA-Arch ab. (String)
bitness
Rufe diesen Wert aus dem Header Sec-CH-UA-Bitness ab. (String)
model
Rufe diesen Wert aus dem Header Sec-CH-UA-Model ab. (String)
source
Die Datenquelle, die zur Erstellung dieses Objekts verwendet wurde, Liste: User-Agent-Quelle in AdCOM 1.0 (Integer; Standard 0)
device.sua.browsers | device.sua.platform
brand
Der Wert kann aus den User-Agent Client Hints-Headern stammen und stellt entweder die User-Agent-Marke (aus dem Header Sec-CH-UA-Full-Version) oder die Plattformmarke (aus dem Header Sec-CH-UA-Platform) dar. (String)
version
Eine Folge von Versionskomponenten in absteigender hierarchischer Reihenfolge [Major, Minor, Micro, …] (Array von String)
user
id
Eindeutige Benutzer-ID (String)
ext
sub
Nein
sub ist eine ganze Zahl, die die ID der Zone darstellt, aus der die Anfrage stammt.
regs.ext
dsaapply
Kennzeichen, das angibt, ob DSA auf die Anfrage angewendet wird. 1 = erforderlich (Int)
dsa
Erweiterung für DSA-Transparenzinformationen (Objekt)
regs.ext.dsa
erforderlich
Kennzeichen, das angibt, ob DSA-Informationen bereitgestellt werden sollen. 0 = nicht erforderlich, 1 = unterstützt, Gebotsantworten mit oder ohne DSA-Objekt werden akzeptiert, 2 = erforderlich, Gebotsantworten ohne DSA-Objekt werden nicht akzeptiert, 3 = erforderlich, Gebotsantworten ohne DSA-Objekt werden nicht akzeptiert, Publisher ist eine Online-Plattform (Int)
datatopub
Der Publisher benötigt die Transparenzdaten möglicherweise für Prüfzwecke. 0 = keine Transparenzdaten senden, 1 = Transparenzdaten optional senden, 2 = Transparenzdaten senden (Int)
Wenn Sie erhalten dsaapply: 1 als auch required: 2 oder 3ist es zwingend erforderlich, der Antwort dsa-Attribute mit Werten hinzuzufügen, andernfalls wird die Antwort abgelehnt.
Beispiele
Eine vollständige Liste aller Anfragetypen, die Sie erhalten können, finden Sie in unserem Beispielseite für Advertiser-Anfragen.
Zuletzt aktualisiert
War das hilfreich?