Spezifikationen für offene RTB-Gebotsanfragen
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.4
- Keep-Alive HTTP Header: Verbindung: Keep-Alive
- Inhalt JSON: Inhalt-Typ: application/json
- Datenverschlüsselungs-Header: Accept-Encoding
Angebotsanfrage
When requesting bids for a specific context, the platform will perform an HTTP request with a timeout of 300ms and send the following object encoded as JSON in the request body. HTTP is recommended due to extra latency when using HTTPS.
| Attribut | Beschreibung |
|---|
| unter | Auktionstyp, erster Preis = 1 (int) |
| id | Eindeutige ID der Angebotsanfrage (String) |
| imp | Objekt, das den angebotenen Eindruck darstellt (Objekt). |
| website | Details über ein Site-Objekt über die Website des Herausgebers (Objekt). |
| gerät | Angaben über ein Device-Objekt zum Gerät des Nutzers, an das der Eindruck geliefert wird (Objekt). |
| benutzer | Details über ein User-Objekt über den menschlichen Nutzer des Geräts; das Werbepublikum (Objekt). |
| ext | Platzhalter für börsenspezifische Erweiterungen. |
imp
| Attribut | Beschreibung |
|---|
| id | Eindeutige Impression-ID in dieser Gebotsanfrage (String) |
| bidfloor | Mindestgebot für diese Impression (CPM) / Klick (CPC) und Kontowährung, optional (float). |
| bidfloorcur | Währung für Mindestgebotswert unter Verwendung von ISO-4217-Alpha-Codes, optional (string) |
| einheimische | Ein Native-Objekt; erforderlich, wenn diese Impression als Native Ad Opportunity (Objekt) angeboten wird. |
| banner | Ein Banner-Objekt; erforderlich, wenn diese Impression als Banner-Anzeigengelegenheit (Objekt) angeboten wird. |
| instl | Ein interstitielles Objekt; erforderlich, wenn diese Impression als interstitielle Werbegelegenheit (Objekt) angeboten wird. |
| sicher | Kennzeichen, das angibt, ob der Eindruck sichere HTTPS-URL-Creative-Assets und Markup erfordert, wobei 0 = nicht sicher, 1 = sicher. Wird das Kennzeichen weggelassen, ist der sichere Status unbekannt, aber es kann von einer nicht sicheren HTTP-Unterstützung ausgegangen werden, optional (Ganzzahl) |
| el | Base64-kodierte E-Mail (Zeichenfolge) |
imp.banner
| Attribut | Beschreibung |
|---|
| w | Breite des Banners in Pixel (Ganzzahl). |
| h | Höhe des Banners in Pixel (Ganzzahl). |
imp.instl
| Attribut | Beschreibung |
|---|
| instl | Flagge, die angibt, ob es sich um eine Popunder/Interstitial-Anzeige handelt (Ganzzahl): 1=true, 0=false |
imp.native (Native & Push-Benachrichtigungen)
| Attribut | Beschreibung |
|---|
| anfrage | Anfrage-Payload gemäß der Native Ads-Spezifikation - ein JSON-kodierter String der Native Ads-Anfrage einschließlich des nativen Top-Level-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) |
| kontext | Der Kontext, in dem die Anzeige erscheint. In diesem Fall ist es 1 (Inhaltsbezogener Kontext wie Newsfeed, Artikel, Bildergalerie, Videogalerie oder ähnliches), optional (ganze Zahl) |
| plcmttype | Das Design/Format/Layout des angebotenen Anzeigenblocks. Derzeit unterstützen wir 4 (Empfehlungs-Widget) und 500 (Push Notification) (Ganzzahl) |
| plcmtcnt | Die Anzahl der identischen Platzierungen in diesem Layout (Integer) |
| vermögenswerte | Ein Array von Asset-Objekten. Jede Gebotsantwort muss dem in der Gebotsanfrage angegebenen Array von Elementen entsprechen (Array von JSON-Objekten) |
| seq | 0 für die erste Anzeige, 1 für die zweite Anzeige, und so weiter. Beachten Sie, dass dies in der Regel NICHT in Kombination mit plcmtcnt verwendet wird - entweder versteigern Sie mehrere identische Platzierungen (in diesem Fall plcmtcnt>1, seq=0) oder Sie führen getrennte Auktionen für verschiedene Positionen im Feed durch (in diesem Fall plcmtcnt=1, seq=>=1) |
imp.native.request.assets
| Attribut | Beschreibung |
|---|
| id | Eindeutige Asset-ID, die von der Börse vergeben wird. In der Regel ein Zähler für das Array (Integer) |
| erforderlich | Auf 1 gesetzt, wenn Asset erforderlich ist, oder 0, wenn Asset optional ist** (Ganzzahl) |
| plcmtcnt | Die Anzahl der identischen Platzierungen in diesem Layout (Integer) |
| img | Image-Objekt für Bild-Assets* (JSON-Objekt) |
| titel | Title-Objekt für Titel-Assets* (JSON-Objekt) |
| daten | Datenobjekt für Markenname, Beschreibung, Bewertungen, Preise usw.* (JSON-Objekt) |
| video | Video-Objekt für Video-Assets. Siehe die Definition des Video-Anforderungsobjekts. Beachten Sie, dass In-Stream-Videoanzeigen (d. h. Preroll-Anzeigen usw.) nicht Teil von Native sind. Native Anzeigen können ein Video als das eigentliche Anzeigenmotiv (Objekt) enthalten. |
* In jedem Asset-Objekt sollte nur eines der Objekte {img, title, data} vorhanden sein
** Assets werden entsprechend der Konfiguration der Publisher-Zone, in der Ihre Anzeige angezeigt werden kann, als erforderlich gekennzeichnet
imp.native.request.assets.img
| Attribut | Beschreibung |
|---|
| typ | Typ-ID des vom Verlag unterstützten Bildelements. Wir unterstützen: 1 (Icon-Bild) (Ganzzahl), 3 (Große Bildvorschau für die Anzeige) (Ganzzahl) |
| w | Breite des Bildes in Pixel, optional (Ganzzahl) |
| h | Höhe des Bildes in Pixel, optional (Ganzzahl) |
| wmin | Die geforderte Mindestbreite des Bildes in Pixel (Ganzzahl) |
| hmin | Die geforderte Mindesthöhe des Bildes in Pixeln (Ganzzahl) |
imp.native.request.assets.title
| Attribut | Beschreibung |
|---|
| len | Maximale Länge des Textes im Titelelement. (Ganzzahl) |
imp.native.request.assets.data
| Attribut | Beschreibung |
|---|
| typ | Typ-ID des vom Verlag unterstützten Elements (Ganzzahl). Wir unterstützen: 1 (sponsored - Gesponserte Nachricht, deren Antwort den Markennamen des Sponsors enthalten sollte), 2 (desc - Beschreibender Text für das beworbene Produkt oder die Dienstleistung) |
| len | Maximale Länge des Textes in der Antwort des Elements (Ganzzahl) |
imp.video
| Attribut | Beschreibung |
|---|
| mimt | Liste der unterstützten Mime-Typen (String-Array) |
| protokolle | Liste der unterstützten Video-Bid-Response-Protokolle (int-Array) |
| überspringen | Gibt an, ob der Player das Überspringen des Videos zulässt, wobei 0 = nein, 1 = ja |
| überspringen nach | Anzahl der Sekunden, die ein Video abgespielt werden muss, bevor das Überspringen aktiviert wird; gilt nur, wenn die Anzeige überspringbar ist |
| skipmin | Videos mit einer Gesamtdauer von mehr als dieser Anzahl von Sekunden können übersprungen werden; gilt nur, wenn die Anzeige überspringbar ist |
Hinweis: Wenn der Herausgeber in der Anfrage "skip", aber nicht "skipafter" angibt, kann das Video nach 5 Sekunden übersprungen werden. In der Antwort wird "skipoffset" auf 5 gesetzt. Wenn der Herausgeber "skip", aber nicht "skipmin" angibt, ist das Video unabhängig von seiner Dauer überspringbar.
website
| Attribut | Beschreibung |
|---|
| id* | Eindeutige Standort-ID (String) |
| bereich* | 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 von OpenRTB. |
*Diese Attribute sind für die Formate Direktlink und E-Mail-Klicks obligatorisch.
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) |
Das Attribut idzone wird verwendet, um die Quelle in ExoClick zu identifizieren, aus der der Verkehr kommt.
gerät
| Attribut | Beschreibung |
|---|
| ua | Browser-Benutzer-Agent (String) |
| geo | Als Standort des Geräts wird der aktuelle Standort des Benutzers angenommen, der durch ein Geo-Objekt definiert ist. |
| ip | IP-Adresse des Benutzers (String)* |
| ipv6 | IPv6-Adresse des Benutzers (String)* |
| sprache | Browsersprache nach ISO-639-1-alpha-2 (string) |
| os | Betriebssystem (string) |
| js | Unterstützung für JavaScript, wobei 0 = nein, 1 = ja (Ganzzahl) |
| ext | Platzhalter für börsenspezifische Erweiterungen zu OpenRTB |
gerät.geo
| Attribut | Beschreibung |
|---|
| land | Land ISO3 |
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) |
benutzer
| Attribut | Beschreibung |
|---|
| id | Eindeutige Benutzer-ID (String) |
ext
| Attribut | Erforderlich? | Beschreibung |
|---|
| unter | Nein | Die Sub ist eine ganze Zahl, die die ID der Zone angibt, aus der die Anfrage stammt. |
regs.ext
| Attribut | Beschreibung |
|---|
| dsaAnwendung | 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 zur Verfügung gestellt werden sollen. 0 = Nicht erforderlich, 1 = Unterstützt, Angebote mit oder ohne DSA-Objekt werden akzeptiert, 2 = Erforderlich, Angebote ohne DSA-Objekt werden nicht akzeptiert, 3 = Erforderlich, Angebote ohne DSA-Objekt werden nicht akzeptiert, Publisher ist eine Online-Plattform (int) |
| datatopub | Der Verleger benötigt die Transparenzdaten möglicherweise für Prüfungszwecke. 0 = keine Transparenzdaten senden, 1 = optional, um Transparenzdaten zu senden, 2 = Transparenzdaten senden (int) |
Hinweis: *Wenn Sie dsaapply: 1 und erforderlich: 2 oder 3, ist es zwingend erforderlich, dsa-Attribute mit Werten in der Antwort hinzuzufügen, andernfalls wird die Antwort zurückgewiesen.
Beispiele
You can find a complete list of all the types of requests you can receive in our Advertiser Request example page.