> 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/publisher/open-rtb/pub-open-rtb-2.5-request.md). # Open RTB 2.5 Gebotsanfrage Diese Seite erklärt, wie Gebotsanfragen erstellt werden. ## Vorgeschlagene Header für Gebotsanfragen * **HTTP-Header der OpenRTB-Version:** `x-openrtb-version: 2.5` * **HTTP-Header Keep-Alive:** `Connection: Keep-Alive` * **JSON-Inhalt:** `Content-Type: application/json` Die folgenden Objekte sollten im Anfragekörper als JSON codiert gesendet werden: ## Gebotsanfrage-Objekt | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | --------------------------------------------------------------------------------- | | um | Ja | Auktionstyp, First-Price = 1 (int) | | id | Ja | Eindeutige Gebotsanfrage-ID (String) | | imp | Ja | Array von Imp-Objekten, die die angebotenen Impressionen darstellen (Objekt). | | site | Ja | Details zur Website des Publishers (Objekt). | | App | Ja | Details zur App des Publishers (Objekt). | | device | Ja | Details zum Gerät des Nutzers, auf dem die Impression ausgeliefert wird (Objekt). | | user | Nein | Details zum menschlichen Nutzer des Geräts; die Werbezielgruppe (Objekt). | | ext | Nein | Platzhalter für Erweiterungen von OpenRTB. | {% hint style="info" %} Nur eines der Objekte `{site, app}` sollte in jeder Anfrage vorhanden sein. {% endhint %} ## imp | Attribut | Erforderlich? | Beschreibung | | -------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Ja | Eindeutige Impression-ID innerhalb dieser Gebotsanfrage (String) | | bidfloor | Nein | Mindestgebot für diese Impression (CPM) / Klick (CPC) und Kontowährung (Fließkommazahl). | | banner | Nur für Vollseiten-Impressions | Ein Bannerobjekt (Objekt). | | secure | Nein; empfohlen 1 | Kennzeichen, das angibt, ob die Impression sichere HTTPS-URL-Creative-Assets und Markup erfordert, wobei 0 = nicht sicher, 1 = sicher. Wenn weggelassen, ist der Sicherheitsstatus unbekannt, aber es kann von nicht sicherer HTTP-Unterstützung ausgegangen werden, optional (Integer) | ### imp.banner | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | ------------------------------------------------------------ | | w | Ja | Breite des Banners (Ganzzahl) | | h | Ja | Höhe des Banners (Ganzzahl) | | mimes | Ja | MIME-Typen - image/jpg, image/png, video/mp4 oder image/webp | ### imp.video | Attribut | Erforderlich? | Beschreibung | | ------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | mimes | Ja | Unterstützte Content-MIME-Typen (z. B. "video/mp4") (String-Array) | | minduration | Nein | Minimale Dauer der Videoanzeige in Sekunden (Ganzzahl) | | maxduration | Nein | Maximale Dauer der Videoanzeige in Sekunden (Ganzzahl) | | protocols | Nein | Array unterstützter Video-Protokolle (Ganzzahl) | | linearity | Nein | Gibt an, ob die Impression linear, nichtlinear usw. sein muss. Wenn nichts angegeben ist, gehen Sie davon aus, dass alle erlaubt sind (Ganzzahl) | | boxingallowed | Nein | Gibt an, ob Letterboxing von 4:3-Inhalten in ein 16:9-Fenster erlaubt ist, wobei 0 = nein, 1 = ja (Ganzzahl) | | pos | Nein | Anzeigenposition auf dem Bildschirm (Ganzzahl) | | 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 austauschspezifische Erweiterungen von OpenRTB (Objekt) | ### imp.video.ext | Attribut | Erforderlich? | Beschreibung | | ---------- | ------------- | ------------------------------------------------------------------------- | | zone\_type | Nein | Zonentyp innerhalb der Anzeigenformate von ExoClick (z. B. video\_slider) | | cta | Nein | Gibt an, ob die Anzeigenzone eine CTA-Komponente anzeigt (Ganzzahl) | ## site | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Empfohlen | Eindeutige Site-ID (String) | | name | Nein | Name der Website (String) | | domain | Empfohlen | Domainname der Website (String) | | cat | Nein | IAB-Kategorie-ID (String-Array) | | page | Empfohlen | Vollständige URL der Seite, auf der die Anzeige angezeigt wird (String) | | keywords | Nein | 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 | ### site.ext | Attribut | Erforderlich? | Beschreibung | | ----------- | ------------- | -------------------------------------------------- | | exchangecat | Nein | Benutzerdefinierte ExoClick-Kategorie-ID (Integer) | | idzone | Nein | Benutzerdefinierte ExoClick-Zonen-ID (Ganzzahl) | ## App | Attribut | Erforderlich? | Beschreibung | | --------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | id | Empfohlen | Eindeutige App-ID (String) | | name | Nein | App-Name (String) | | domain | Empfohlen | Domainname der App (String) | | cat | Nein | IAB-Kategorie-ID (String-Array) | | keywords | Nein | Keywords können verwendet werden, um sicherzustellen, dass Anzeigenzonen die richtige Art von Werbung erhalten. Keywords sollten eine durch Kommas getrennte Wortfolge sein (String) | | Publisher | Nein | Details zum Publisher (Objekt) | ## device | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------- | | ua | Ja | Browser-User-Agent (String) | | sua | Nein | Strukturierte User-Agent-Informationen, die verwendet werden können, wenn ein Client User-Agent Client Hints unterstützt (Objekt) | | geo | Nein | Standort des Geräts, angenommen als aktueller Standort des Nutzers, definiert durch ein Geo-Objekt. | | ip | Ja | IPv4-Adresse des Nutzers (String)\* | | ipv6 | Ja | IPv6-Adresse des Nutzers (String)\* | | language | Empfohlen | Browsersprache (String) | | os | Nein | Betriebssystem (String) | | js | Nein | Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Integer) | | ext | Nein | Platzhalter für austauschspezifische Erweiterungen zu OpenRTB | {% hint style="info" %} Sie müssen in Ihrer Anfrage nur entweder ip oder ipv6 angeben, nicht beides. Wenn Sie ipv6 verwenden, entfernen Sie das Attribut ip, und umgekehrt. Beides anzugeben, kann Fehler verursachen. {% endhint %} ### device.geo | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | --------------- | | country | Nein | Ländercode ISO3 | ### device.ext | Attribut | Erforderlich? | Beschreibung | | ----------------- | ------------- | ------------------------------------------------------------------------------ | | remote\_addr | Nein | Haupt-IP-Adresse des Nutzers (String) | | x\_forwarded\_for | Nein | 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 | Erforderlich? | Beschreibung | | ------------ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | browsers | Empfohlen | Implementierer sollten Marken und Versionen senden, die aus dem Header Sec-CH-UA-Full-Version-List abgeleitet wurden. (Array von `BrandVersion` Objekten) | | platform | Empfohlen | Implementierer sollten eine Marke senden, 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 | Empfohlen | Implementierer sollten diesen Wert aus dem Header Sec-CH-UA-Mobile ableiten. (Ganzzahl) | | architecture | Empfohlen | Implementierer sollten diesen Wert aus dem Header Sec-CH-UA-Arch abrufen. (String) | | bitness | Empfohlen | Implementierer sollten diesen Wert aus dem Header Sec-CH-UA-Bitness abrufen. (String) | | model | Empfohlen | Implementierer sollten diesen Wert aus dem Header Sec-CH-UA-Model abrufen. (String) | | source | Empfohlen | 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 | Erforderlich? | Beschreibung | | -------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | brand | Erforderlich | 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 | Empfohlen | Eine Folge von Versionskomponenten in absteigender hierarchischer Reihenfolge \[Major, Minor, Micro, …] (Array von String) | ## user | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | ----------------------------------------------------------------------- | | id | Nein | Eindeutige Benutzer-ID (String) | | ext | Nein | Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt) | ### user.ext | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | ---------------------------------------------------------------------------------------------------------------------- | | consent | Nein | Dies ist die von den IAB-Standards erforderliche Einwilligungszeichenfolge. Derzeit nur negative Einwilligung (String) | ## regs | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | ----------------------------------------------------------------------- | | ext | Nein | Platzhalter für austauschspezifische Erweiterungen von OpenRTB (Objekt) | ### regs.ext | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | gdpr | Nein | 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. | ## ext | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | -------------------------------------------------------------------------------------------------------------------- | | sub | Nein | Die Sub-ID. Dies sollte eine Zahl mit einer bis zehn Ziffern sein: Verwenden Sie keine führenden Nullen bei Sub-IDs. | --- # 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/publisher/open-rtb/pub-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.