> 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.4-request.md). # Open RTB 2.4 Gebotsanfrage Diese Seite beschreibt die verschiedenen Komponenten der RTB-Anfragen, die Sie erhalten werden, um Gebote abzugeben. ## Gebotsanfrage-Header * **OpenRTB-Version-HTTP-Header**: `x-openrtb-version: 2.4` * **Keep-Alive-HTTP-Header**: `Connection: Keep-Alive` * **JSON-Inhalt**: `Content-Type: application/json` * **Header für Datenkodierung**: `Accept-Encoding` ## Gebotsanfrage-Objekt 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 | | -------- | -------------------------------------------------------------------------------------------------------------- | | um | Auktionstyp, First-Price = 1 (int) | | id | Eindeutige Gebotsanfrage-ID (String) | | imp | Objekt, das die angebotene Impression darstellt (Objekt). | | site | Details über die Website des Publishers mithilfe eines Site-Objekts (Objekt). | | device | Details über das Gerät des Nutzers, dem die Impression geliefert wird, mithilfe eines Device-Objekts (Objekt). | | user | Details über den menschlichen Nutzer des Geräts; die Werbezielgruppe (Objekt). | | ext | Platzhalter für austauschspezifische Erweiterungen. | ## imp | Attribut | Beschreibung | | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Eindeutige Impression-ID innerhalb dieser Gebotsanfrage (String) | | bidfloor | Mindestgebot für diese Impression (CPM) / Klick (CPC) und Kontowährung, optional (Float). | | bidfloorcur | Währung für den angegebenen Mindestgebotswert gemäß ISO-4217-Alphabetcodes, optional (String) | | native | Ein Native-Objekt; erforderlich, wenn diese Impression als Native-Anzeigenmöglichkeit angeboten wird (Objekt). | | banner | Ein Banner-Objekt; erforderlich, wenn diese Impression als Banner-Anzeigenmöglichkeit angeboten wird (Objekt). | | instl | Ein Interstitial-Objekt; erforderlich, wenn diese Impression als Interstitial- oder Popunder-Anzeigenmöglichkeit angeboten wird (Objekt).(Objekt). | | secure | 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) | | el | Base64-kodierte E-Mail (String) | ### imp.banner | Attribut | Beschreibung | | -------- | ------------------------------------------------------------------------------------ | | w | Breite des Banners in Pixeln (Integer). | | h | Höhe des Banners in Pixeln (Integer). | | mimes | Unterstützte MIME-Typen. Beispielwerte: image/jpg, image/png, video/mp4, image/webp. | ### imp.instl | Attribut | Beschreibung | | -------- | ------------------------------------------------------------------------------------------------ | | instl | Kennzeichen, das angibt, ob die Anzeige ein Popunder/Interstitial ist (Integer): 1=true, 0=false | ### imp.native (Native- & Push-Benachrichtigungen) | Attribut | Beschreibung | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | request | Anfrage-Payload gemäß der Native-Ad-Spezifikation – ein **JSON-kodierter String** der Native-Ads-Anfrage einschließlich ihres **native** obersten Objekts (JSON-Objekt) | | ver | Version der Dynamic Native Ads API, der **request** entspricht (String) | ### imp.native.request | Attribut | Beschreibung | | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ver | Version der verwendeten Native-Markup-Version (String) | | context | Der Kontext, in dem die Anzeige erscheint. In diesem Fall ist es **1** (*Inhaltszentrierter Kontext wie Newsfeed, Artikel, Bildergalerie, Videogalerie oder Ähnliches*), optional (Integer) | | plcmttype | Das Design/Format/Layout der angebotenen Anzeigeneinheit. Derzeit unterstützen wir **4** (*Empfehlungs-Widget*) und **500** (*Push-Benachrichtigung*) (Integer) | | plcmtcnt | Die Anzahl identischer Platzierungen in diesem Layout (Integer) | | assets | Ein Array von **Asset-Objekten**. Jede Gebotsantwort muss dem im Gebots-Request angegebenen Array von Elementen entsprechen (Array von JSON-Objekten) | | seq | 0 für die erste Anzeige, 1 für die zweite Anzeige usw. Beachten Sie, dass dies im Allgemeinen NICHT in Kombination mit plcmtcnt verwendet wird – entweder versteigern Sie mehrere identische Platzierungen (in diesem Fall plcmtcnt>1, seq=0) oder Sie führen separate Auktionen für unterschiedliche Elemente im Feed durch (in diesem Fall plcmtcnt=1, seq=>=1) | ### imp.native.request.assets | Attribut | Beschreibung | | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Eindeutige Asset-ID, vom Exchange zugewiesen. Typischerweise ein Zähler für das Array (Integer) | | erforderlich | Setzen auf **1** wenn das Asset erforderlich ist oder **0** wenn das Asset optional ist\*\* (Integer) | | plcmtcnt | Die Anzahl identischer Platzierungen in diesem Layout (Integer) | | img | Bildobjekt für Bild-Assets\* (JSON-Objekt) | | title | Titelobjekt für Titel-Assets\* (JSON-Objekt) | | data | Datenobjekt für Markenname, Beschreibung, Bewertungen, Preise usw.\* (JSON-Objekt) | | video | Videoobjekt für Video-Assets. Siehe die Definition des Video-Request-Objekts. Beachten Sie, dass In-Stream-Videowerbung (z. B. Pre-Roll usw.) nicht Teil von Native ist. Native-Anzeigen können ein Video als Werbemittel selbst enthalten (Objekt). | \* In jedem Asset-Objekt sollte nur eines der Objekte {img, title, data} vorhanden sein \*\* Assets werden gemäß der Konfiguration der Publisher-Zone, in der Ihre Anzeige angezeigt werden kann, als erforderlich markiert ### imp.native.request.assets.img | Attribut | Beschreibung | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | type | Typ-ID des vom Publisher unterstützten Bildelements. Wir unterstützen: **1** (*Icon-Bild*) (Integer), **3** (*Große Bildvorschau für die Anzeige*) (Integer) | | w | Breite des Bildes in Pixeln, optional (Integer) | | h | Höhe des Bildes in Pixeln, optional (Integer) | | wmin | Die angeforderte Mindestbreite des Bildes in Pixeln (Integer) | | hmin | Die angeforderte Mindesthöhe des Bildes in Pixeln (Integer) | ### imp.native.request.assets.title | Attribut | Beschreibung | | -------- | ---------------------------------------------- | | len | Maximale Textlänge im Titel-Element. (Integer) | ### imp.native.request.assets.video | Attribut | Beschreibung | | ------------- | -------------------------------------------------------------------------------------- | | mimes | Liste der unterstützten MIME-Typen (String-Array). | | minduration | Minimale Dauer der Videoanzeige in Sekunden (Integer). | | maxduration | Maximale Dauer der Videoanzeige in Sekunden (Integer). | | protocols | Liste der unterstützten Protokolle für Video-Gebotsantworten (Integer-Array). | | linearity | Gibt an, ob die Impression linear, nichtlinear usw. sein muss. (Integer). | | boxingallowed | Gibt an, ob Letterboxing von 4:3-Inhalten in einem 16:9-Fenster erlaubt ist (Integer). | ### imp.native.request.assets.data | Attribut | Beschreibung | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | Typ-ID des vom Publisher unterstützten Elements (Integer). Wir unterstützen: **1** (*sponsored - Sponsored-By-Nachricht, bei der die Antwort den Markennamen des Sponsors enthalten sollte*), **2** (*desc - Beschreibender Text zum beworbenen Produkt oder Dienst*) | | len | Maximale Textlänge in der Antwort des Elements (Integer) | ### imp.video | Attribut | Beschreibung | | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | mimes | Liste der unterstützten MIME-Typen (String-Array) | | protocols | Liste der unterstützten Protokolle für Video-Gebotsantworten (Integer-Array) | | skip | Gibt an, ob der Player das Überspringen des Videos erlaubt, wobei 0 = nein, 1 = ja | | skipafter | Anzahl der Sekunden, die ein Video abgespielt werden muss, bevor das Überspringen aktiviert wird; nur anwendbar, wenn die Anzeige überspringbar ist | | skipmin | Videos mit einer Gesamtdauer von mehr als dieser Anzahl von Sekunden können überspringbar sein; nur anwendbar, wenn die Anzeige überspringbar ist | {% hint style="info" %} Wenn der Publisher "skip" in der Anfrage, aber nicht "skipafter" angibt, ist das Video nach 5 Sekunden überspringbar. Die Antwort setzt "skipoffset" auf 5.\ Wenn der Publisher "skip", aber nicht "skipmin" angibt, ist das Video unabhängig von seiner Dauer überspringbar. {% endhint %} ## 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 zu OpenRTB. | \*Diese Attribute sind für die Formate Direct Link und Email Clicks verpflichtend. ### site.ext | Attribut | Beschreibung | | ----------- | ------------------------------------------------------ | | exchangecat | Benutzerdefinierte ExoClick-Kategorie-ID (Integer) | | idzone | Benutzerdefinierte ExoClick-Anzeigenzonen-ID (Integer) | | keyword | Passendes Keyword, falls vorhanden (String) | Das Attribut idzone wird verwendet, um die Quelle in ExoClick zu identifizieren, von der der Traffic kommt. ## 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, angenommen als aktueller Standort des Nutzers, definiert durch ein Geo-Objekt. | | ip | IP-Adresse des Nutzers (String)\* | | ipv6 | IPv6-Adresse des Nutzers (String)\* | | language | Browsersprache gemäß ISO-639-1-Alpha-2 (String) | | os | Betriebssystem (String) | | js | Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Integer) | | ext | Platzhalter für austauschspezifische Erweiterungen zu OpenRTB | \*Genau eines von ip oder ipv6 ist im Gebots-Request vorhanden. ### device.geo | Attribut | Beschreibung | | -------- | --------------- | | country | Ländercode ISO3 | ### 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) | ## ext | Attribut | Erforderlich? | Beschreibung | | -------- | ------------- | ----------------------------------------------------------------------------------- | | sub | Nein | sub ist eine ganze Zahl, die die ID der Zone darstellt, aus der die Anfrage stammt. | ## regs.ext | Attribut | Beschreibung | | -------- | --------------------------------------------------------------------------------------- | | dsaapply | Kennzeichen, das angibt, ob DSA auf die Anfrage angewendet wird. 1 = erforderlich (Int) | | dsa | Erweiterung für DSA-Transparenzinformationen (Objekt) | ### regs.ext.dsa | Attribut | Beschreibung | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | erforderlich | Kennzeichen, das angibt, ob DSA-Informationen bereitgestellt werden sollen. 0 = nicht erforderlich, 1 = unterstützt, Gebotsantworten mit oder ohne DSA-Objekt werden akzeptiert, 2 = erforderlich, Gebotsantworten ohne DSA-Objekt werden nicht akzeptiert, 3 = erforderlich, Gebotsantworten ohne DSA-Objekt werden nicht akzeptiert, Publisher ist eine Online-Plattform (Int) | | datatopub | Der Publisher benötigt die Transparenzdaten möglicherweise für Prüfzwecke. 0 = keine Transparenzdaten senden, 1 = Transparenzdaten optional senden, 2 = Transparenzdaten senden (Int) | {% hint style="warning" %} Wenn Sie erhalten **dsaapply: 1** als auch **required: 2 oder 3**ist es zwingend erforderlich, der Antwort dsa-Attribute mit Werten hinzuzufügen, andernfalls wird die Antwort abgelehnt. {% endhint %} ## Beispiele Eine vollständige Liste aller Anfragetypen, die Sie erhalten können, finden Sie in unserem [Beispielseite für Advertiser-Anfragen](/rtb/de/werbetreibende/open-rtb/open-rtb-advertiser-code-examples.md). --- # 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.4-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.