Open RTB 2.5 Gebotsanfrage

Diese Seite erklärt, wie Gebotsanfragen erstellt werden.

Vorgeschlagene Header für Gebotsanfragen

• HTTP-Header der OpenRTB-Version: x-openrtb-version: 2.5
• HTTP-Header Keep-Alive: Connection: Keep-Alive
• JSON-Inhalt: Content-Type: application/json

Die folgenden Objekte sollten im Anfragekörper als JSON codiert gesendet werden:

Gebotsanfrage-Objekt

Attribut	Erforderlich?	Beschreibung
um	Ja	Auktionstyp, First-Price = 1 (int)
id	Ja	Eindeutige Gebotsanfrage-ID (String)
imp	Ja	Array von Imp-Objekten, die die angebotenen Impressionen darstellen (Objekt).
site	Ja	Details zur Website des Publishers (Objekt).
App	Ja	Details zur App des Publishers (Objekt).
device	Ja	Details zum Gerät des Nutzers, auf dem die Impression ausgeliefert wird (Objekt).
user	Nein	Details zum menschlichen Nutzer des Geräts; die Werbezielgruppe (Objekt).
ext	Nein	Platzhalter für Erweiterungen von OpenRTB.

Nur eines der Objekte {site, app} sollte in jeder Anfrage vorhanden sein.

imp

Attribut	Erforderlich?	Beschreibung
id	Ja	Eindeutige Impression-ID innerhalb dieser Gebotsanfrage (String)
bidfloor	Nein	Mindestgebot für diese Impression (CPM) / Klick (CPC) und Kontowährung (Fließkommazahl).
banner	Nur für Vollseiten-Impressions	Ein Bannerobjekt (Objekt).
secure	Nein; empfohlen 1	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)

imp.banner

Attribut	Erforderlich?	Beschreibung
w	Ja	Breite des Banners (Ganzzahl)
h	Ja	Höhe des Banners (Ganzzahl)
mimes	Ja	MIME-Typen - image/jpg, image/png, video/mp4 oder image/webp

imp.video

Attribut	Erforderlich?	Beschreibung
mimes	Ja	Unterstützte Content-MIME-Typen (z. B. "video/mp4") (String-Array)
minduration	Nein	Minimale Dauer der Videoanzeige in Sekunden (Ganzzahl)
maxduration	Nein	Maximale Dauer der Videoanzeige in Sekunden (Ganzzahl)
protocols	Nein	Array unterstützter Video-Protokolle (Ganzzahl)
linearity	Nein	Gibt an, ob die Impression linear, nichtlinear usw. sein muss. Wenn nichts angegeben ist, gehen Sie davon aus, dass alle erlaubt sind (Ganzzahl)
boxingallowed	Nein	Gibt an, ob Letterboxing von 4:3-Inhalten in ein 16:9-Fenster erlaubt ist, wobei 0 = nein, 1 = ja (Ganzzahl)
pos	Nein	Anzeigenposition auf dem Bildschirm (Ganzzahl)
h	Nein	Breite des Videoplayers in geräteunabhängigen Pixeln (DIPS) (Ganzzahl)
w	Nein	Höhe des Videoplayers in geräteunabhängigen Pixeln (DIPS) (Ganzzahl)
ext	Nein	Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt)

imp.video.ext

Attribut	Erforderlich?	Beschreibung
zone_type	Nein	Zonentyp innerhalb der Anzeigenformate von ExoClick (z. B. video_slider)
cta	Nein	Gibt an, ob die Anzeigenzone eine CTA-Komponente anzeigt (Ganzzahl)

site

Attribut	Erforderlich?	Beschreibung
id	Empfohlen	Eindeutige Site-ID (String)
name	Nein	Name der Website (String)
domain	Empfohlen	Domainname der Website (String)
cat	Nein	IAB-Kategorie-ID (String-Array)
page	Empfohlen	Vollständige URL der Seite, auf der die Anzeige angezeigt wird (String)
keywords	Nein	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

site.ext

Attribut	Erforderlich?	Beschreibung
exchangecat	Nein	Benutzerdefinierte ExoClick-Kategorie-ID (Integer)
idzone	Nein	Benutzerdefinierte ExoClick-Zonen-ID (Ganzzahl)

App

Attribut	Erforderlich?	Beschreibung
id	Empfohlen	Eindeutige App-ID (String)
name	Nein	App-Name (String)
domain	Empfohlen	Domainname der App (String)
cat	Nein	IAB-Kategorie-ID (String-Array)
keywords	Nein	Keywords können verwendet werden, um sicherzustellen, dass Anzeigenzonen die richtige Art von Werbung erhalten. Keywords sollten eine durch Kommas getrennte Wortfolge sein (String)
Publisher	Nein	Details zum Publisher (Objekt)

device

Attribut	Erforderlich?	Beschreibung
ua	Ja	Browser-User-Agent (String)
sua	Nein	Strukturierte User-Agent-Informationen, die verwendet werden können, wenn ein Client User-Agent Client Hints unterstützt (Objekt)
geo	Nein	Standort des Geräts, angenommen als aktueller Standort des Nutzers, definiert durch ein Geo-Objekt.
ip	Ja	IPv4-Adresse des Nutzers (String)*
ipv6	Ja	IPv6-Adresse des Nutzers (String)*
language	Empfohlen	Browsersprache (String)
os	Nein	Betriebssystem (String)
js	Nein	Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Integer)
ext	Nein	Platzhalter für austauschspezifische Erweiterungen zu OpenRTB

Sie müssen in Ihrer Anfrage nur entweder ip oder ipv6 angeben, nicht beides. Wenn Sie ipv6 verwenden, entfernen Sie das Attribut ip, und umgekehrt. Beides anzugeben, kann Fehler verursachen.

device.geo

Attribut	Erforderlich?	Beschreibung
country	Nein	Ländercode ISO3

device.ext

Attribut	Erforderlich?	Beschreibung
remote_addr	Nein	Haupt-IP-Adresse des Nutzers (String)
x_forwarded_for	Nein	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.

Attribut	Erforderlich?	Beschreibung
browsers	Empfohlen	Implementierer sollten Marken und Versionen senden, die aus dem Header Sec-CH-UA-Full-Version-List abgeleitet wurden. (Array von BrandVersion Objekten)
platform	Empfohlen	Implementierer sollten eine Marke senden, 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	Empfohlen	Implementierer sollten diesen Wert aus dem Header Sec-CH-UA-Mobile ableiten. (Ganzzahl)
architecture	Empfohlen	Implementierer sollten diesen Wert aus dem Header Sec-CH-UA-Arch abrufen. (String)
bitness	Empfohlen	Implementierer sollten diesen Wert aus dem Header Sec-CH-UA-Bitness abrufen. (String)
model	Empfohlen	Implementierer sollten diesen Wert aus dem Header Sec-CH-UA-Model abrufen. (String)
source	Empfohlen	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

Attribut	Erforderlich?	Beschreibung
brand	Erforderlich	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	Empfohlen	Eine Folge von Versionskomponenten in absteigender hierarchischer Reihenfolge [Major, Minor, Micro, …] (Array von String)

user

Attribut	Erforderlich?	Beschreibung
id	Nein	Eindeutige Benutzer-ID (String)
ext	Nein	Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt)

user.ext

Attribut	Erforderlich?	Beschreibung
consent	Nein	Dies ist die von den IAB-Standards erforderliche Einwilligungszeichenfolge. Derzeit nur negative Einwilligung (String)

regs

Attribut	Erforderlich?	Beschreibung
ext	Nein	Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt)

regs.ext

Attribut	Erforderlich?	Beschreibung
gdpr	Nein	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.

ext

Attribut	Erforderlich?	Beschreibung
sub	Nein	Die Sub-ID. Dies sollte eine Zahl mit einer bis zehn Ziffern sein: Verwenden Sie keine führenden Nullen bei Sub-IDs.