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: Connection: Keep-Alive
• Content JSON: Content-Type: 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	Details about the publisher’s website(object).
app	Ja	Details about the publisher’s app(object).
gerät	Ja	Details about the user’s device to which the impression will be delivered(object).
benutzer	Nein	Details about the human user of the device; the advertising audience(object).
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	Minimum bid for this impression (CPM) / click (CPC) and account currency (float).
banner	Only for fullpage imps	A banner object (object).
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	Zone type within ExoClick's ad formats (e.g: video_slider)
cta	Nein	Specifies whether the ad zone shows a CTA component (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	Custom ExoClick Zone ID (integer)

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 address of the user (string)*
ipv6	Ja	IPv6 address of the user (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

Note: You only need to include either ip or ipv6 in your request, not both. If you use ipv6, remove the ip attribute, and vice versa. Including both can cause errors.

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

Structured User Agent information. device.sua is considered the more accurate representation of the device attributes.

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	This is the consent string required by the IAB standards. Negative consent only for now (string)

regs

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

regs.ext

Attribut	Erforderlich?	Beschreibung
gdpr	Nein	This is 0 if the caller believes that the user is not under GDPR, and 1 if the user is under GDPR. If neither, this parameter will be undefined.

ext

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