> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/de/werbetreibende/open-rtb/adv-open-rtb-2.5-request.md). # Open RTB 2.5 Gebotsanfrage Diese Seite beschreibt die verschiedenen Komponenten der RTB-Anfragen, die Sie erhalten werden, um Gebote abzugeben. ## Gebotsanfrage-Header * **HTTP-Header der OpenRTB-Version:** x-openrtb-version: 2.5 * **HTTP-Header Keep-Alive:** Connection: Keep-Alive * **Inhalts-JSON: Content-Type:** application/json * **Datenkodierungs-Header:** Accept-Encoding ## Gebotsanfrage 2.5 Beim Anfordern von Geboten für einen bestimmten Kontext führt die Plattform eine HTTP-Anfrage mit einem Timeout von **300ms** aus und sendet das folgende Objekt als JSON kodiert im Anfragetext. **HTTP** wird aufgrund zusätzlicher Latenz bei Verwendung von HTTPS empfohlen. | Attribut | Beschreibung | | -------- | ---------------------------------------------------------------------------------------------------- | | id | Eindeutige Gebotsanfrage-ID (String) | | site | Details über ein Site-Objekt zur Website des Publishers (Objekt) | | device | Details zum Gerät des Nutzers, auf dem die Impression ausgeliefert wird (Objekt) | | user | Details zum menschlichen Nutzer des Geräts; die Werbezielgruppe (Objekt) | | imp | Details zur Anzeigenplatzierung oder Impression, die versteigert wird (Objekt) | | regs | Details zu allen für diese Anfrage geltenden Branchen-, Rechts- oder Regierungsvorschriften (Objekt) | | ext | Platzhalter für Erweiterungen von OpenRTB (Objekt) | ## site | Attribut | Beschreibung | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Eindeutige Site-ID (String) | | domain | Domainname der Website (String) | | cat | IAB-Kategorie-ID (String-Array) | | page | Vollständige URL der Seite, auf der die Anzeige angezeigt wird (String) | | keywords | 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 | | ext | Platzhalter für austauschspezifische Erweiterungen (Objekt) | ### site.ext | Attribut | Beschreibung | | ----------- | ------------------------------------------------------ | | exchangecat | Benutzerdefinierte ExoClick-Kategorie-ID (Integer) | | idzone | Benutzerdefinierte ExoClick-Anzeigenzonen-ID (Integer) | | keyword | Passendes Keyword, falls vorhanden (String) | ## device | Attribut | Beschreibung | | -------- | --------------------------------------------------------------------------------------------------------------------------------- | | ua | Browser-User-Agent (String) | | sua | Strukturierte User-Agent-Informationen, die verwendet werden können, wenn ein Client User-Agent Client Hints unterstützt (Objekt) | | geo | Standort des Geräts, der als der aktuelle Standort des Nutzers angenommen wird, definiert durch ein Geo-Objekt | | ip | IPv4-Adresse des Nutzers (String)\* | | ipv6 | IPv6-Adresse des Nutzers (String)\* | | language | Browsersprache (String) | | os | Betriebssystem (String) | | js | Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Integer) | | ext | Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt) | \*Genau eines von ip oder ipv6 ist im Gebots-Request vorhanden. ### device.geo | Attribut | Beschreibung | | --------- | --------------------------------------------------------------------------------------------------------------------------- | | country | Ländercode ISO3 | | ipservice | Dienst oder Anbieter, der gegebenenfalls zur Bestimmung der Geolokalisierung anhand der IP-Adresse verwendet wird (Integer) | ### device.ext | Attribut | Beschreibung | | ----------------- | ------------------------------------------------------------------------------ | | remote\_addr | Haupt-IP-Adresse des Nutzers (String) | | x\_forwarded\_for | 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 | Beschreibung | | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | browsers | Sende Marken und Versionen, die aus dem Header Sec-CH-UA-Full-Version-List abgeleitet wurden. (Array von `BrandVersion` Objekten) | | platform | Sende eine Marke, 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 | Leite diesen Wert aus dem Header Sec-CH-UA-Mobile ab. (Integer) | | architecture | Rufe diesen Wert aus dem Header Sec-CH-UA-Arch ab. (String) | | bitness | Rufe diesen Wert aus dem Header Sec-CH-UA-Bitness ab. (String) | | model | Rufe diesen Wert aus dem Header Sec-CH-UA-Model ab. (String) | | source | Die Datenquelle, die zur Erstellung dieses Objekts verwendet wurde, [Liste: User-Agent-Quelle](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--user-agent-source-) in AdCOM 1.0 (Integer; Standard 0) | ### device.sua.browsers | device.sua.platform | Attribut | Beschreibung | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | brand | 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 | Eine Folge von Versionskomponenten in absteigender hierarchischer Reihenfolge \[Major, Minor, Micro, …] (Array von String) | ## user | Attribut | Beschreibung | | -------- | ------------------------------- | | id | Eindeutige Benutzer-ID (String) | ### user.ext | Attribut | Beschreibung | | -------- | ---------------------------------------------------------------------------------------------------------------------- | | consent | Dies ist die von den IAB-Standards erforderliche Einwilligungszeichenfolge. Derzeit nur negative Einwilligung (String) | ## regs | Attribut | Beschreibung | | -------- | -------------------------------------------------------------- | | ext | Platzhalter für austauschspezifische Erweiterungen zu OpenRTB. | ### regs.ext | Attribut | Beschreibung | | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | gdpr | 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. | ## imp | Attribut | Beschreibung | | -------- | ------------------------------------------------------------------------------------- | | id | Eine eindeutige Kennung für diese Impression im Kontext der Gebotsanfrage (String) | | instl | 1 = die Anzeige ist interstitial oder Vollbild, 0 = nicht interstitial (Integer) | | video | Details über ein Video-Objekt, das eine In-Stream-Videoimpression repräsentiert | | secure | Kennzeichen, das angibt, ob die Impression eine sichere HTTPS-URL erfordert (Integer) | | ext | Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt) | ### imp.video | Attribut | Beschreibung | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | mimes | Unterstützte Content-MIME-Typen (z. B. "video/mp4") (String-Array) | | minduration | Minimale Dauer der Videoanzeige in Sekunden (Ganzzahl) | | maxduration | Maximale Dauer der Videoanzeige in Sekunden (Ganzzahl) | | protocols | Array unterstützter Video-Protokolle (Ganzzahl) | | linearity | Gibt an, ob die Impression linear, nichtlinear usw. sein muss. Wenn nichts angegeben ist, gehen Sie davon aus, dass alle erlaubt sind (Ganzzahl) | | boxingallowed | Gibt an, ob Letterboxing von 4:3-Inhalten in ein 16:9-Fenster erlaubt ist, wobei 0 = nein, 1 = ja (Ganzzahl) | | pos | Anzeigenposition auf dem Bildschirm (Ganzzahl) | | 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 austauschspezifische Erweiterungen von OpenRTB (Objekt) | ### imp.video.ext | Attribut | Beschreibung | | ---------- | ------------------------------------------------------------------------- | | zone\_type | Zonentyp innerhalb der Anzeigenformate von ExoClick (z. B. video\_slider) | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/rtb/de/werbetreibende/open-rtb/adv-open-rtb-2.5-request.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.