Skip to main content

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.  

AttributBeschreibung
unterAuktionstyp, erster Preis = 1 (int)
idEindeutige ID der Angebotsanfrage (String)
impObjekt, das den angebotenen Eindruck darstellt (Objekt).
websiteDetails über ein Site-Objekt über die Website des Herausgebers (Objekt).
gerätAngaben über ein Device-Objekt zum Gerät des Nutzers, an das der Eindruck geliefert wird (Objekt).
benutzerDetails über ein User-Objekt über den menschlichen Nutzer des Geräts; das Werbepublikum (Objekt).
extPlatzhalter für börsenspezifische Erweiterungen.

imp

AttributBeschreibung
idEindeutige Impression-ID in dieser Gebotsanfrage (String)
bidfloorMindestgebot für diese Impression (CPM) / Klick (CPC) und Kontowährung, optional (float).
bidfloorcurWährung für Mindestgebotswert unter Verwendung von ISO-4217-Alpha-Codes, optional (string)
einheimischeEin Native-Objekt; erforderlich, wenn diese Impression als Native Ad Opportunity (Objekt) angeboten wird.
bannerEin Banner-Objekt; erforderlich, wenn diese Impression als Banner-Anzeigengelegenheit (Objekt) angeboten wird.
instlEin interstitielles Objekt; erforderlich, wenn diese Impression als interstitielle Werbegelegenheit (Objekt) angeboten wird.
sicherKennzeichen, 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)
elBase64-kodierte E-Mail (Zeichenfolge)

imp.banner

AttributBeschreibung
wBreite des Banners in Pixel (Ganzzahl).
hHöhe des Banners in Pixel (Ganzzahl).

imp.instl

AttributBeschreibung
instlFlagge, die angibt, ob es sich um eine Popunder/Interstitial-Anzeige handelt (Ganzzahl): 1=true, 0=false

imp.native (Native & Push-Benachrichtigungen)

AttributBeschreibung
anfrageAnfrage-Payload gemäß der Native Ads-Spezifikation - ein JSON-kodierter String der Native Ads-Anfrage einschließlich des nativen Top-Level-Objekts (JSON-Objekt)
verVersion der Dynamic Native Ads API, der request entspricht (string)

imp.native.request

AttributBeschreibung
verVersion der verwendeten Native Markup Version (string)
kontextDer Kontext, in dem die Anzeige erscheint. In diesem Fall ist es 1 (Inhaltsbezogener Kontext wie Newsfeed, Artikel, Bildergalerie, Videogalerie oder ähnliches), optional (ganze Zahl)
plcmttypeDas Design/Format/Layout des angebotenen Anzeigenblocks. Derzeit unterstützen wir 4 (Empfehlungs-Widget) und 500 (Push Notification) (Ganzzahl)
plcmtcntDie Anzahl der identischen Platzierungen in diesem Layout (Integer)
vermögenswerteEin Array von Asset-Objekten. Jede Gebotsantwort muss dem in der Gebotsanfrage angegebenen Array von Elementen entsprechen (Array von JSON-Objekten)
seq0 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

AttributBeschreibung
idEindeutige Asset-ID, die von der Börse vergeben wird. In der Regel ein Zähler für das Array (Integer)
erforderlichAuf 1 gesetzt, wenn Asset erforderlich ist, oder 0, wenn Asset optional ist** (Ganzzahl)
plcmtcntDie Anzahl der identischen Platzierungen in diesem Layout (Integer)
imgImage-Objekt für Bild-Assets* (JSON-Objekt)
titelTitle-Objekt für Titel-Assets* (JSON-Objekt)
datenDatenobjekt für Markenname, Beschreibung, Bewertungen, Preise usw.* (JSON-Objekt)
videoVideo-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

AttributBeschreibung
typTyp-ID des vom Verlag unterstützten Bildelements. Wir unterstützen: 1 (Icon-Bild) (Ganzzahl), 3 (Große Bildvorschau für die Anzeige) (Ganzzahl)
wBreite des Bildes in Pixel, optional (Ganzzahl)
hHöhe des Bildes in Pixel, optional (Ganzzahl)
wminDie geforderte Mindestbreite des Bildes in Pixel (Ganzzahl)
hminDie geforderte Mindesthöhe des Bildes in Pixeln (Ganzzahl)

imp.native.request.assets.title

AttributBeschreibung
lenMaximale Länge des Textes im Titelelement. (Ganzzahl)

imp.native.request.assets.data

AttributBeschreibung
typTyp-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)
lenMaximale Länge des Textes in der Antwort des Elements (Ganzzahl)
<!--
### imp.native.request.assets.video
AttributBeschreibung
mimtListe der unterstützten Mime-Typen (String-Array)
mindurationMindestdauer der Videoanzeige in Sekunden(int).
maxdurationMaximale Dauer der Videoanzeige in Sekunden(int).
protokolleListe der unterstützten Video-Bid-Response-Protokolle (int-Array)
linearitätGibt an, ob der Eindruck linear, nichtlinear usw. sein muss (int)
boxen erlaubtGibt an, ob das Letterboxing von 4:3-Inhalten in einem 16:9-Fenster erlaubt ist (int)
-->

imp.video

AttributBeschreibung
mimtListe der unterstützten Mime-Typen (String-Array)
protokolleListe der unterstützten Video-Bid-Response-Protokolle (int-Array)
überspringenGibt an, ob der Player das Überspringen des Videos zulässt, wobei 0 = nein, 1 = ja
überspringen nachAnzahl der Sekunden, die ein Video abgespielt werden muss, bevor das Überspringen aktiviert wird; gilt nur, wenn die Anzeige überspringbar ist
skipminVideos 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

AttributBeschreibung
id*Eindeutige Standort-ID (String)
bereich*Domänenname der Website (String)
katzeIAB-Kategorie-ID (String-Array)
seiteVollständige URL der Seite, auf der die Anzeige erscheinen soll (String)
schlüsselwörterMit 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
extPlatzhalter für börsenspezifische Erweiterungen von OpenRTB.

*Diese Attribute sind für die Formate Direktlink und E-Mail-Klicks obligatorisch.

site.ext

AttributBeschreibung
austauschkatzeBenutzerdefinierte ExoClick-Kategorie-ID (ganze Zahl)
idzoneBenutzerdefinierte ExoClick-Anzeigenzonen-ID (ganze Zahl)
stichwortPassendes Schlüsselwort, falls vorhanden (String)

Das Attribut idzone wird verwendet, um die Quelle in ExoClick zu identifizieren, aus der der Verkehr kommt.

gerät

AttributBeschreibung
uaBrowser-Benutzer-Agent (String)
geoAls Standort des Geräts wird der aktuelle Standort des Benutzers angenommen, der durch ein Geo-Objekt definiert ist.
ipIP-Adresse des Benutzers (String)*
ipv6IPv6-Adresse des Benutzers (String)*
spracheBrowsersprache nach ISO-639-1-alpha-2 (string)
osBetriebssystem (string)
jsUnterstützung für JavaScript, wobei 0 = nein, 1 = ja (Ganzzahl)
extPlatzhalter für börsenspezifische Erweiterungen zu OpenRTB

gerät.geo

AttributBeschreibung
landLand ISO3

gerät.ext

AttributBeschreibung
remote_addrHaupt-IP-Adresse des Benutzers (String)
x_weitergeleitet_fürX-FORWARDED-FOR IP-Adresse des Benutzers oder leer, wenn nicht festgelegt (string)

benutzer

AttributBeschreibung
idEindeutige Benutzer-ID (String)

ext

AttributErforderlich?Beschreibung
unterNeinDie Sub ist eine ganze Zahl, die die ID der Zone angibt, aus der die Anfrage stammt.

regs.ext

AttributBeschreibung
dsaAnwendungKennzeichen, das angibt, ob DSA auf die Anfrage angewendet wird. 1 = Erforderlich (int)
dsaErweiterung für DSA-Transparenzinformationen (Objekt)

regs.ext.dsa

AttributBeschreibung
erforderlichKennzeichen, 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)
datatopubDer 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.