Open RTB 2.5 Gebotsanfrage
Diese Seite beschreibt die verschiedenen Komponenten der RTB-Anfragen, die Sie erhalten werden, um Gebote abzugeben.
Gebotsanfrage-Header
HTTP-Header der OpenRTB-Version: x-openrtb-version: 2.5
HTTP-Header Keep-Alive: Connection: Keep-Alive
Inhalts-JSON: Content-Type: application/json
Datenkodierungs-Header: Accept-Encoding
Gebotsanfrage 2.5
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.
id
Eindeutige Gebotsanfrage-ID (String)
site
Details über ein Site-Objekt zur Website des Publishers (Objekt)
device
Details zum Gerät des Nutzers, auf dem die Impression ausgeliefert wird (Objekt)
user
Details zum menschlichen Nutzer des Geräts; die Werbezielgruppe (Objekt)
imp
Details zur Anzeigenplatzierung oder Impression, die versteigert wird (Objekt)
regs
Details zu allen für diese Anfrage geltenden Branchen-, Rechts- oder Regierungsvorschriften (Objekt)
ext
Platzhalter für Erweiterungen von OpenRTB (Objekt)
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 (Objekt)
site.ext
exchangecat
Benutzerdefinierte ExoClick-Kategorie-ID (Integer)
idzone
Benutzerdefinierte ExoClick-Anzeigenzonen-ID (Integer)
keyword
Passendes Keyword, falls vorhanden (String)
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, der als der aktuelle Standort des Nutzers angenommen wird, definiert durch ein Geo-Objekt
ip
IPv4-Adresse des Nutzers (String)*
ipv6
IPv6-Adresse des Nutzers (String)*
language
Browsersprache (String)
os
Betriebssystem (String)
js
Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Integer)
ext
Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt)
*Genau eines von ip oder ipv6 ist im Gebots-Request vorhanden.
device.geo
country
Ländercode ISO3
ipservice
Dienst oder Anbieter, der gegebenenfalls zur Bestimmung der Geolokalisierung anhand der IP-Adresse verwendet wird (Integer)
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)
user.ext
consent
Dies ist die von den IAB-Standards erforderliche Einwilligungszeichenfolge. Derzeit nur negative Einwilligung (String)
regs
ext
Platzhalter für austauschspezifische Erweiterungen zu OpenRTB.
regs.ext
gdpr
Dies ist 0, wenn der Aufrufer glaubt, dass der Nutzer nicht unter die DSGVO fällt, und 1, wenn der Nutzer unter die DSGVO fällt. Wenn beides nicht zutrifft, ist dieser Parameter undefiniert.
imp
id
Eine eindeutige Kennung für diese Impression im Kontext der Gebotsanfrage (String)
instl
1 = die Anzeige ist interstitial oder Vollbild, 0 = nicht interstitial (Integer)
video
Details über ein Video-Objekt, das eine In-Stream-Videoimpression repräsentiert
secure
Kennzeichen, das angibt, ob die Impression eine sichere HTTPS-URL erfordert (Integer)
ext
Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt)
imp.video
mimes
Unterstützte Content-MIME-Typen (z. B. "video/mp4") (String-Array)
minduration
Minimale Dauer der Videoanzeige in Sekunden (Ganzzahl)
maxduration
Maximale Dauer der Videoanzeige in Sekunden (Ganzzahl)
protocols
Array unterstützter Video-Protokolle (Ganzzahl)
linearity
Gibt an, ob die Impression linear, nichtlinear usw. sein muss. Wenn nichts angegeben ist, gehen Sie davon aus, dass alle erlaubt sind (Ganzzahl)
boxingallowed
Gibt an, ob Letterboxing von 4:3-Inhalten in ein 16:9-Fenster erlaubt ist, wobei 0 = nein, 1 = ja (Ganzzahl)
pos
Anzeigenposition auf dem Bildschirm (Ganzzahl)
h
Breite des Videoplayers in geräteunabhängigen Pixeln (DIPS) (Ganzzahl)
w
Höhe des Videoplayers in geräteunabhängigen Pixeln (DIPS) (Ganzzahl)
ext
Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt)
imp.video.ext
zone_type
Zonentyp innerhalb der Anzeigenformate von ExoClick (z. B. video_slider)
Zuletzt aktualisiert
War das hilfreich?