Skip to main content

Spezifikationen für offene RTB-Gebotsanfragen

Auf dieser Seite wird erklärt, wie man Angebote einholt

Angebotsanfrage-Kopfzeilen

  • OpenRTB Version HTTP Header: x-openrtb-version: 2.4
  • Keep-Alive HTTP Header: Verbindung: Keep-Alive
  • Inhalt JSON: Inhalt-Typ: application/json

The following objects should be sent encoded as JSON in the request body:  

Angebotsanfrage

AttributErforderlich?Beschreibung
unterJaAuktionstyp, erster Preis = 1 (int)
idJaEindeutige ID der Angebotsanfrage (String)
impJaArray von Imp-Objekten, die die angebotenen Eindrücke darstellen (Objekt).
websiteJaDetails über ein Site-Objekt über die Website des Herausgebers (Objekt).
gerätJaAngaben über ein Device-Objekt zum Gerät des Nutzers, an das der Eindruck geliefert wird (Objekt).
benutzerNeinDetails über ein User-Objekt über den menschlichen Nutzer des Geräts; das Werbepublikum (Objekt).
extNeinPlatzhalter für Erweiterungen zu OpenRTB.

imp

AttributErforderlich?Beschreibung
idJaEindeutige Impression-ID in dieser Gebotsanfrage (String)
bidfloorNeinMindestgebot für diese Impression (CPM) / Klick (CPC) und Kontowährung (Float)
bidfloorcurNeinWährung für Mindestgebotswert unter Verwendung von ISO-4217-Alpha-Codes (String)
einheimischeNur für native und Push-ImpsEine Native Object Opportunity (Objekt).
bannerNur für BannerträgerEin Banner Objekt Gelegenheit (Objekt).
instlNur für Pop-, Direktlink- und E-Mail-KlickimpsEin Fullscreen-Objekt Opportunity (Objekt).
videoNur für VideoA Videoobjekt Gelegenheit (Objekt)
sicherEmpfohlenKennzeichen, das angibt, ob die Impression sichere HTTPS-URL-Creative-Assets und Markup erfordert, wobei 0 = nicht sicher, 1 = sicher (empfohlene Option). Wird dieses Flag nicht angegeben, ist der sichere Status unbekannt, aber es kann von einer nicht sicheren HTTP-Unterstützung ausgegangen werden (Ganzzahl)
elNeinBase64-kodierte E-Mail (Zeichenfolge)
extNeinPlatzhalter für börsenspezifische Erweiterungen

imp.banner

AttributErforderlich?Beschreibung
wJaBreite des Banners (Integer)
hJaHöhe des Banners (Integer)
mimtNeinListe der unterstützten Mime-Typen (String-Array). Wir unterstützen: image/jpeg, image/jpg, image/png, image/png, image/gif, image/webp, video/mp4
extNeinPlatzhalter für börsenspezifische Erweiterungen (Objekt)

imp.banner.ext

AttributErforderlich?Beschreibung
image_outputNeinGibt das Ausgabeformat für Bildbanner an* (string)
video_OutputNeinGibt das Ausgabeformat für Videobanner an* (String)

*Definiert das Format des adm-Feldes für das Bannerformat. Die Optionen sind xml oder html. Standardwert ist xml, falls das Feld nicht angegeben wird.

imp.instl

AttributErforderlich?Beschreibung
instlJa0 = direkter Link/E-Mail-Klicks, 1 = Popunder

imp.native (für Native und Push Notification Ads)

AttributErforderlich?Beschreibung
anfrageJaAnfrage-Payload gemäß der Native Ads-Spezifikation - ein JSON-kodierter String der Native Ads-Anfrage einschließlich des nativen Top-Level-Objekts (JSON-Objekt)
verNeinVersion der Dynamic Native Ads API, der request entspricht (string)

imp.native.request

AttributErforderlich?Beschreibung
verJaVersion der verwendeten Native Markup Version (string)
kontextNeinDer Kontext, in dem die Anzeige erscheint. In diesem Fall ist es 1 (Inhaltsbezogener Kontext wie Newsfeed, Artikel, Bildergalerie, Videogalerie oder ähnliches), optional (ganze Zahl)
plcmttypeJaDas Design/Format/Layout des angebotenen Anzeigenblocks. Derzeit unterstützen wir 4 (Empfehlungs-Widget) und 500 (Push Notification) (Ganzzahl)
plcmtcntNeinDie Anzahl der identischen Placements in diesem Layout. Max: 10 (Ganzzahl) (Ganzzahl)
vermögenswerteJaEin Array von Asset-Objekten. Jede Gebotsantwort muss dem in der Gebotsanfrage angegebenen Array von Elementen entsprechen (Array von JSON-Objekten)
seqNein0 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

AttributErforderlich?Beschreibung
idJaEindeutige Asset-ID, die von der Börse zugewiesen wird. Typischerweise ein Zähler für das Array (Ganzzahl) 1: Bild-Asset-ID, 2: Titel-Asset-ID, 3: Beschreibung-Asset-ID
erforderlichNeinAuf 1 gesetzt, wenn Asset erforderlich ist, oder 0, wenn Asset optional ist (Ganzzahl)
plcmtcntNeinDie Anzahl der identischen Platzierungen in diesem Layout (Integer)
imgJaImage-Objekt für Bild-Assets** (JSON-Objekt)
titelNeinTitle-Objekt für Titel-Assets** (JSON-Objekt)
datenNeinDatenobjekt für Markenname, Beschreibung, Bewertungen, Preise usw.* (JSON-Objekt)

*The amount of bids received for your Native request will be based on the value you set in "plcmtcnt". For example, a bid request with "plcmtcnt":3 will receive 3 different bid objects. You can find an example of this in the Response example page.

** In jedem Asset-Objekt sollte nur eines der Objekte {img, title, data} vorhanden sein

imp.native.request.assets.img

AttributErforderlich?Beschreibung
typNeinTyp-ID des vom Verlag unterstützten Bildelements. Wir unterstützen: 1 (Icon-Bild) (Ganzzahl), 3 (Große Bildvorschau für die Anzeige) (Ganzzahl)
wNeinBreite des Bildes in Pixel, optional (Ganzzahl)
hNeinHöhe des Bildes in Pixel, optional (Ganzzahl)
wminJaDie geforderte Mindestbreite des Bildes in Pixel (Ganzzahl)
hminJaDie geforderte Mindesthöhe des Bildes in Pixeln (Ganzzahl)

*Push Notification-Symbol Abmessungen: 192px x 192px

imp.native.request.assets.title

AttributErforderlich?Beschreibung
lenJaMaximale Länge des Textes im Titelelement. (Ganzzahl)

imp.native.request.assets.data

AttributErforderlich?Beschreibung
typJaTyp-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)
lenNeinMaximale Länge des Textes in der Antwort des Elements (Ganzzahl)

imp.video

AttributErforderlich?Beschreibung
mimtNeinListe der unterstützten Mime-Typen (String-Array)
protokolleNeinListe der unterstützten Video-Bid-Response-Protokolle (int-Array)
überspringenNeinGibt an, ob der Player das Überspringen des Videos zulässt, wobei 0 = nein, 1 = ja
überspringen nachNeinAnzahl der Sekunden, die ein Video abgespielt werden muss, bevor das Überspringen aktiviert wird; gilt nur, wenn die Anzeige überspringbar ist
skipminNeinVideos mit einer Gesamtdauer von mehr als dieser Anzahl von Sekunden können übersprungen werden; gilt nur, wenn die Anzeige überspringbar ist

Hinweis: Wenn Sie in der Anfrage nur "skip", aber nicht "skipafter" angeben, kann das Video nach 5 Sekunden übersprungen werden. In der Antwort wird "skipoffset" auf 5 gesetzt. Wenn Sie "skip", aber nicht "skipmin" angeben, kann das Video unabhängig von seiner Dauer übersprungen werden.


imp.ext

AttributErforderlich?Beschreibung
video_ctaNeinGibt an, ob CTAs bereitgestellt werden sollen, wobei 0 = nein, 1 = ja (Standardwert 1)

To see an example of CTA, please check our Response example page.  

website

AttributErforderlich?Beschreibung
idErforderlichEindeutige Standort-ID (String)
domainErforderlichDomänenname der Website (String)
nameErforderlichName des Standorts (String)
katzeNeinIAB-Kategorie-ID (String-Array)
seiteEmpfohlenVollständige URL der Seite, auf der die Anzeige erscheinen soll (String)
schlüsselwörterNeinMit Hilfe von Schlüsselwörtern kann sichergestellt werden, dass Anzeigenbereiche die richtige Art von Werbung erhalten. Die Schlüsselwörter sollten aus einer durch Kommata getrennten Wortfolge bestehen.
extNeinPlatzhalter für börsenspezifische Erweiterungen von OpenRTB.

site.ext

AttributErforderlich?Beschreibung
austauschkatzeNeinBenutzerdefinierte ExoClick-Kategorie-ID (ganze Zahl)
idzoneNeinBenutzerdefinierte ExoClick-Anzeigenzonen-ID (ganze Zahl)

app

AttributErforderlich?Beschreibung
idErforderlichEindeutige Anwendungs-ID (String)
katzeNeinIAB-Kategorie-ID (String-Array)
schlüsselwörterNeinMit Hilfe von Schlüsselwörtern kann sichergestellt werden, dass Anzeigenbereiche die richtige Art von Werbung erhalten. Schlüsselwörter sollten eine durch Komma getrennte Wortfolge sein (String)
herausgeberNeinDetails über den Herausgeber (Objekt)

Anmerkung: Sie können das Objekt "app" nicht zusammen mit "site" senden oder umgekehrt.


app.publisher

AttributErforderlich?Beschreibung
domainEmpfohlenHöchste Domäne des Herausgebers (z. B. "publisher.com") (string)

gerät

AttributErforderlich?Beschreibung
uaJaBrowser-Benutzer-Agent (String)
geoNeinAls Standort des Geräts wird der aktuelle Standort des Benutzers angenommen, der durch ein Geo-Objekt definiert ist.
ipJaIP-Adresse des Benutzers (String)*
ipv6EmpfohlenIPv6-Adresse des Benutzers (String)*
spracheEmpfohlenBrowsersprache nach ISO-639-1-alpha-2 (string)
osNeinBetriebssystem (string)
jsNeinUnterstützung für JavaScript, wobei 0 = nein, 1 = ja (Ganzzahl)
extNeinPlatzhalter für börsenspezifische Erweiterungen zu OpenRTB

Anmerkung: Sie müssen nur entweder ip oder ipv6 in Ihrer Anfrage angeben, nicht beides. Wenn Sie ipv6 verwenden, entfernen Sie das ip-Attribut, und umgekehrt. Die Angabe beider Attribute kann zu Fehlern führen.


gerät.geo

AttributErforderlich?Beschreibung
landNeinLand ISO3

gerät.ext

AttributErforderlich?Beschreibung
remote_addrNeinHaupt-IP-Adresse des Benutzers (String)
x_weitergeleitet_fürNeinX-FORWARDED-FOR IP-Adresse des Benutzers oder leer, wenn nicht festgelegt (string)

benutzer

AttributErforderlich?Beschreibung
idJaEindeutige Benutzer-ID (String)

Anmerkung: Wenn Sie keine Benutzer-ID-Zeichenkette erzeugen können, können Sie sie leer lassen (""). Die Anfrage erhält eine Antwort, solange das Objekt "user" in der Anfrage enthalten ist.


ext

AttributErforderlich?Beschreibung
unterNeinDie Unter-ID. Dies sollte eine sechs- bis zehnstellige Zahl sein: Verwenden Sie keine Nullen am Anfang von Sub-IDs.
exportierenNeinAntworttyp kann "json" oder "xml" (String) sein. Standard ist "json".

Note: Sub IDs should be a number between 1 and Int32: Do not use zeroes at the beginning of Sub IDs.


Beispiele

You can find a detailed list of Request examples in our example page