RTB 2.5 Gebotsanfrage öffnen
Auf dieser Seite werden die verschiedenen Komponenten der RTB-Anfragen beschrieben, die Sie erhalten, um ein Gebot abgeben zu können.
Angebotsanfrage-Kopfzeilen
- OpenRTB Version HTTP Header: x-openrtb-version: 2.5
- Keep-Alive HTTP Header: Verbindung: Keep-Alive
- Inhalt JSON: Inhalts-Typ: application/json
- Datenverschlüsselungs-Header: Accept-Encoding
Angebotsanfrage 2.5
Bei der Anforderung von Geboten für einen bestimmten Kontext führt die Plattform eine HTTP-Anforderung mit einer Zeitüberschreitung von 300ms durch und sendet das folgende Objekt als JSON kodiert im Anforderungskörper. aufgrund der zusätzlichen Latenz bei Verwendung von HTTPS wird HTTP** empfohlen.
| Attribut | Beschreibung |
|---|
| id | Eindeutige ID der Angebotsanfrage (String) |
| website | Details über ein Site-Objekt zur Website des Herausgebers (Objekt) |
| gerät | Angaben zum Gerät des Nutzers, an das der Abdruck übermittelt wird (Objekt) |
| benutzer | Angaben zum menschlichen Nutzer des Geräts; das Werbepublikum (Objekt) |
| imp | Details der zu versteigernden Anzeigenschaltung oder Impression (Objekt) |
| regs | Angaben zu den für diese Anfrage geltenden branchenbezogenen, gesetzlichen oder behördlichen Vorschriften (Objekt) |
| ext | Platzhalter für Erweiterungen zu OpenRTB (Objekt) |
website
| Attribut | Beschreibung |
|---|
| id | Eindeutige Standort-ID (String) |
| domain | Domänenname der Website (String) |
| katze | IAB-Kategorie-ID (String-Array) |
| seite | Vollständige URL der Seite, auf der die Anzeige erscheinen soll (String) |
| schlüsselwörter | 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 |
| ext | Platzhalter für börsenspezifische Erweiterungen (Objekt) |
site.ext
| Attribut | Beschreibung |
|---|
| austauschkatze | Benutzerdefinierte ExoClick-Kategorie-ID (ganze Zahl) |
| idzone | Benutzerdefinierte ExoClick-Anzeigenzonen-ID (ganze Zahl) |
| stichwort | Passendes Schlüsselwort, falls vorhanden (String) |
gerät
| Attribut | Beschreibung |
|---|
| ua | Browser-Benutzer-Agent (String) |
| sua | Strukturierte User-Agent-Informationen, die verwendet werden können, wenn ein Client User-Agent Client Hints (Objekt) unterstützt |
| geo | Standort des Geräts, der als aktueller Standort des Benutzers angenommen wird und durch ein Geo-Objekt definiert ist |
| ip | IPv4-Adresse des Benutzers (String)* |
| ipv6 | IPv6-Adresse des Benutzers (String)* |
| sprache | Sprache des Browsers (Zeichenfolge) |
| os | Betriebssystem (string) |
| js | Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Ganzzahl) |
| ext | Platzhalter für börsenspezifische Erweiterungen zu OpenRTB (Objekt) |
*In der Gebotsanfrage muss genau eine der Optionen ip oder ipv6 enthalten sein.
gerät.geo
| Attribut | Beschreibung |
|---|
| land | Land ISO3 |
| ipservice | Dienst oder Anbieter, der zur Bestimmung der Geolokation aus der IP-Adresse verwendet wird, falls zutreffend (ganze Zahl) |
gerät.ext
| Attribut | Beschreibung |
|---|
| remote_addr | Haupt-IP-Adresse des Benutzers (String) |
| x_weitergeleitet_für | 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 | Beschreibung |
|---|
| browsers | Senden von Marken und Versionen, die aus dem Sec-CH-UA-Full-Version-List-Header abgeleitet sind. (Array von BrandVersion-Objekten) |
| plattform | Senden einer Marke, die aus dem Sec-CH-UA-Platform-Header abgeleitet ist, und einer Version, die aus dem Sec-CH-UA-Platform-Version-Header abgeleitet ist. (BrandVersion Objekt) |
| mobil | Dieser Wert wird aus dem Sec-CH-UA-Mobile-Header abgeleitet. (Ganzzahl) |
| architektur | Ruft diesen Wert aus dem Sec-CH-UA-Arch-Header ab. (Zeichenkette) |
| bissigkeit | Ruft diesen Wert aus dem Sec-CH-UA-Bitness-Header ab. (Zeichenkette) |
| modell | Ruft diesen Wert aus dem Sec-CH-UA-Model-Header ab. (string) |
| quelle | The source of data used to create this object, List: User-Agent Source in AdCOM 1.0 (integer; default 0) |
| Attribut | Beschreibung |
|---|
| marke | 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 | Eine Folge von Versionskomponenten in absteigender hierarchischer Reihenfolge [major, minor, micro, ...] (Array of string) |
benutzer
| Attribut | Beschreibung |
|---|
| id | Eindeutige Benutzer-ID (String) |
benutzer.ext
| Attribut | Beschreibung |
|---|
| zustimmung | Dies ist die in den IAB-Standards vorgeschriebene Zustimmungszeichenfolge. Vorerst nur negative Zustimmung (String) |
regs
| Attribut | Beschreibung |
|---|
| ext | Platzhalter für börsenspezifische Erweiterungen von OpenRTB. |
regs.ext
| Attribut | Beschreibung |
|---|
| gdpr | 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. |
imp
| Attribut | Beschreibung |
|---|
| id | Ein eindeutiger Bezeichner für diesen Eindruck im Kontext der Gebotsanfrage (String) |
| instl | 1 = die Anzeige ist interstitiell oder bildschirmfüllend, 0 = nicht interstitiell (ganze Zahl) |
| video | Details über Video-Objekt, das einen In-Stream-Videoeindruck darstellt |
| sicher | Kennzeichen, das angibt, ob der Abdruck eine sichere HTTPS-URL erfordert (ganze Zahl) |
| ext | Platzhalter für börsenspezifische Erweiterungen zu OpenRTB (Objekt) |
imp.video
| Attribut | Beschreibung |
|---|
| mimt | Unterstützte MIME-Typen für den Inhalt (z. B. "video/mp4") (String-Array ) |
| minduration | Mindestdauer der Videoanzeige in Sekunden (ganze Zahl) |
| maxduration | Maximale Dauer der Videoanzeige in Sekunden (ganze Zahl) |
| protokolle | Array der unterstützten Videoprotokolle (Integer) |
| linearität | Gibt an, ob der Eindruck linear, nichtlinear usw. sein muss. Wenn nichts angegeben ist, wird davon ausgegangen, dass alle erlaubt sind (Ganzzahl) |
| boxen erlaubt | Gibt an, ob das Letterboxing von 4:3-Inhalten in einem 16:9-Fenster erlaubt ist, wobei 0 = nein, 1 = ja (Ganzzahl) |
| pos | Anzeigenposition auf dem Bildschirm (ganze Zahl) |
| 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 börsenspezifische Erweiterungen zu OpenRTB (Objekt) |
imp.video.ext
| Attribut | Beschreibung |
|---|
| zone_type | Zonentyp innerhalb der ExoClick-Anzeigenformate (z.B.: video_slider) |