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: Connection: Keep-Alive
- Content JSON: Content-Type: application/json
- Data Encoding 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 | Details of the user’s device to which the impression will be delivered (object) |
| benutzer | Details of the human user of the device; the advertising audience (object) |
| imp | Details of the ad placement or impression being auctioned (object) |
| regs | Details of any industry, legal, or governmental regulations in force for this request (object) |
| 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) |
*Exactly one of ip or ipv6 will be present in the bid request.
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
Structured User Agent information. device.sua is considered the more accurate representation of the device attributes.
| 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 | This is the consent string required by the IAB standards. Negative consent only for now (string) |
regs
| Attribut | Beschreibung |
|---|
| ext | Platzhalter für börsenspezifische Erweiterungen von OpenRTB. |
regs.ext
| Attribut | Beschreibung |
|---|
| gdpr | 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. |
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 | Zone type within ExoClick's ad formats (e.g: video_slider) |