RTB 2.5 Gebotsanfrage öffnen

Auf dieser Seite wird erklärt, wie man Angebote einholt

Vorgeschlagene Überschriften für Angebotsanfragen

• OpenRTB Version HTTP Header: x-openrtb-version: 2.5
• Keep-Alive HTTP Header: Verbindung: Keep-Alive
• Inhalt JSON: Inhalt-Typ: application/json

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

Angebotsanfrage

Attribut	Erforderlich?	Beschreibung
unter	Ja	Auktionstyp, erster Preis = 1 (int)
id	Ja	Eindeutige ID der Angebotsanfrage (String)
imp	Ja	Array von Imp-Objekten, die die angebotenen Eindrücke darstellen (Objekt).
website	Ja	Angaben zur Website des Herausgebers (Objekt).
app	Ja	Details über die Anwendung des Herausgebers (Objekt).
gerät	Ja	Angaben zum Gerät des Nutzers, an das der Abdruck übermittelt werden soll (Objekt).
benutzer	Nein	Einzelheiten über den menschlichen Nutzer des Geräts; das Werbepublikum (Objekt).
ext	Nein	Platzhalter für Erweiterungen zu OpenRTB.

---

Anmerkung: In jeder Anfrage sollte nur eines der Objekte {site, app} vorhanden sein.

---

imp

Attribut	Erforderlich?	Beschreibung
id	Ja	Eindeutige Impression-ID in dieser Gebotsanfrage (String)
bidfloor	Nein	Mindestgebot für diese Impression (CPM) / Klick (CPC) und Kontowährung (Float).
banner	Nur für Ganzseitenimps	Ein Banner-Objekt (Objekt).
sicher	Nein; empfohlen 1	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)

imp.banner

Attribut	Erforderlich?	Beschreibung
w	Ja	Breite des Banners (Integer)
h	Ja	Höhe des Banners (Integer)
mimt	Ja	Mimes-Typen - Bild/jpg, Bild/png, Video/mp4 oder Bild/webp

imp.video

Attribut	Erforderlich?	Beschreibung
mimt	Ja	Unterstützte MIME-Typen für den Inhalt (z. B. "video/mp4") (String-Array )
minduration	Nein	Mindestdauer der Videoanzeige in Sekunden (ganze Zahl)
maxduration	Nein	Maximale Dauer der Videoanzeige in Sekunden (ganze Zahl)
protokolle	Nein	Array der unterstützten Videoprotokolle (Integer)
linearität	Nein	Gibt an, ob der Eindruck linear, nichtlinear usw. sein muss. Wenn nichts angegeben ist, wird davon ausgegangen, dass alle erlaubt sind (Ganzzahl)
boxen erlaubt	Nein	Gibt an, ob das Letterboxing von 4:3-Inhalten in einem 16:9-Fenster erlaubt ist, wobei 0 = nein, 1 = ja (Ganzzahl)
pos	Nein	Anzeigenposition auf dem Bildschirm (ganze Zahl)
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 börsenspezifische Erweiterungen zu OpenRTB (Objekt)

imp.video.ext

Attribut	Erforderlich?	Beschreibung
zone_type	Nein	Zonentyp innerhalb der ExoClick-Anzeigenformate (z.B.: video_slider)
cta	Nein	Gibt an, ob der Anzeigenbereich eine CTA-Komponente zeigt (Integer)

website

Attribut	Erforderlich?	Beschreibung
id	Empfohlen	Eindeutige Standort-ID (String)
name	Nein	Standortname (String)
domain	Empfohlen	Domänenname der Website (String)
katze	Nein	IAB-Kategorie-ID (String-Array)
seite	Empfohlen	Vollständige URL der Seite, auf der die Anzeige erscheinen soll (String)
schlüsselwörter	Nein	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

site.ext

Attribut	Erforderlich?	Beschreibung
austauschkatze	Nein	Benutzerdefinierte ExoClick-Kategorie-ID (ganze Zahl)
idzone	Nein	Benutzerdefinierte ExoClick-Zonen-ID (ganze Zahl)

app

Attribut	Erforderlich?	Beschreibung
id	Empfohlen	Eindeutige Anwendungs-ID (String)
name	Nein	Name der Anwendung (String)
domain	Empfohlen	Domänenname der Anwendung (String)
katze	Nein	IAB-Kategorie-ID (String-Array)
schlüsselwörter	Nein	Mit Hilfe von Schlüsselwörtern kann sichergestellt werden, dass Anzeigenbereiche die richtige Art von Werbung erhalten. Schlüsselwörter sollten eine durch Komma getrennte Wortfolge sein (String)
herausgeber	Nein	Details über den Herausgeber (Objekt)

gerät

Attribut	Erforderlich?	Beschreibung
ua	Ja	Browser-Benutzer-Agent (String)
sua	Nein	Strukturierte User-Agent-Informationen, die verwendet werden können, wenn ein Client User-Agent Client Hints (Objekt) unterstützt
geo	Nein	Als Standort des Geräts wird der aktuelle Standort des Benutzers angenommen, der durch ein Geo-Objekt definiert ist.
ip	Ja	IPv4-Adresse des Benutzers (String)*
ipv6	Ja	IPv6-Adresse des Benutzers (String)*
sprache	Empfohlen	Sprache des Browsers (Zeichenfolge)
os	Nein	Betriebssystem (string)
js	Nein	Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Ganzzahl)
ext	Nein	Platzhalter für börsenspezifische Erweiterungen zu OpenRTB

Hinweis: Sie müssen nur entweder ip oder ipv6 in Ihrer Anfrage angeben, nicht beides. Wenn Sie ipv6 verwenden, entfernen Sie das Attribut ip, und umgekehrt. Die Angabe beider Attribute kann zu Fehlern führen.

gerät.geo

Attribut	Erforderlich?	Beschreibung
land	Nein	Land ISO3

gerät.ext

Attribut	Erforderlich?	Beschreibung
remote_addr	Nein	Haupt-IP-Adresse des Benutzers (String)
x_weitergeleitet_für	Nein	X-FORWARDED-FOR IP-Adresse des Benutzers oder leer, wenn nicht festgelegt (string)

gerät.sua

Strukturierte User-Agent-Informationen. die Datei "device.sua" gilt als die genauere Darstellung der Geräteattribute.

Attribut	Erforderlich?	Beschreibung
browsers	Empfohlen	Die Implementierer sollten Marken und Versionen senden, die aus dem Sec-CH-UA-Full-Version-List-Header abgeleitet sind. (Array von BrandVersion-Objekten)
plattform	Empfohlen	Die Implementierer sollten eine vom Sec-CH-UA-Platform-Header abgeleitete Marke und eine vom Sec-CH-UA-Platform-Version-Header abgeleitete Version senden. (BrandVersion Objekt)
mobil	Empfohlen	Die Implementierer sollten diesen Wert aus dem Sec-CH-UA-Mobile-Header ableiten. (Ganzzahl)
architektur	Empfohlen	Implementierer sollten diesen Wert aus dem Sec-CH-UA-Arch-Header abrufen. (Zeichenkette)
bissigkeit	Empfohlen	Implementierer sollten diesen Wert aus dem Sec-CH-UA-Bitness-Header abrufen. (Zeichenkette)
modell	Empfohlen	Implementierer sollten diesen Wert aus dem Sec-CH-UA-Model-Header abrufen. (string)
quelle	Empfohlen	The source of data used to create this object, List: User-Agent Source in AdCOM 1.0 (integer; default 0)

device.sua.browsers | device.sua.platform

Attribut	Erforderlich?	Beschreibung
marke	Erforderlich	Der Wert kann aus den User-Agent-Client-Hinweisen (User-Agent-Client-Hints-Header) stammen, die entweder die Marke des User-Agents (aus dem Sec-CH-UA-Full-Version-Header) oder die Marke der Plattform (aus dem Sec-CH-UA-Platform-Header) darstellen. (Zeichenfolge)
version	Empfohlen	Eine Folge von Versionskomponenten in absteigender hierarchischer Reihenfolge [major, minor, micro, ...] (Array of string)

benutzer

Attribut	Erforderlich?	Beschreibung
id	Nein	Eindeutige Benutzer-ID (String)
ext	Nein	Platzhalter für börsenspezifische Erweiterungen zu OpenRTB (Objekt)

benutzer.ext

Attribut	Erforderlich?	Beschreibung
zustimmung	Nein	Dies ist die in den IAB-Standards vorgeschriebene Zustimmungszeichenfolge. Vorerst nur negative Zustimmung (String)

regs

Attribut	Erforderlich?	Beschreibung
ext	Nein	Platzhalter für börsenspezifische Erweiterungen zu OpenRTB (Objekt)

regs.ext

Attribut	Erforderlich?	Beschreibung
gdpr	Nein	Dieser Wert 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. Ist dies nicht der Fall, ist dieser Parameter undefiniert.

ext

Attribut	Erforderlich?	Beschreibung
unter	Nein	Die Unter-ID. Dies sollte eine ein- bis zehnstellige Zahl sein: Verwenden Sie keine Nullen am Anfang von Sub-IDs.