Diese Seite wurde von der Cloud Translation API übersetzt.

DV360 OpenRTB-Spezifikation

Halten Sie die OpenRTB 2.6-Spezifikation bereit, während Sie diese Seite lesen.

In Display & Video 360 wird nicht jedes Feld in der OpenRTB-Spezifikation unterstützt und es können Nuancen gelten. Einige Abschnitte dieses Dokuments enthalten Informationen und Empfehlungen, die speziell für die Display & Video 360-Implementierung gelten. Sofern nicht anders angegeben, sollten Sie auch die Richtlinien in der OpenRTB-Spezifikation einhalten.

Einige Felder werden nicht unterstützt, aber trotzdem geparst. Diese Felder müssen korrekt formatiert sein, haben aber keinen Einfluss auf das Gebotsergebnis.

Spezifikation für Gebotsanfragen

Eine Gebotsanfrage ist eine HTTP-POST-Anfrage mit dem Textkörper eines Gebotsanfrageobjekts. Das Format des Texts wird im Header Content-Type definiert.

Die entsprechende Antwort ist entweder ein HTTP 204 ohne Text für ein „Kein Gebot“ oder ein HTTP 200 mit dem Text einer Gebotsantwort.

Wenn eine Gebotsanfrage fehlerhaft ist, wird möglicherweise ein HTTP 200-Fehler mit dem Text einer Gebotsantwort zurückgegeben, in der das Feld nbr ausgefüllt ist.

Das Antwortformat wird durch den Accept-Header gesteuert.

JSON-Format

Das Standardformat wird verwendet, wenn kein akzeptierter MIME-Typ angegeben wird.

JSON-Anfragen und ‑Antworten entsprechen der OpenRTB 2.6-Spezifikation des IAB. In der folgenden Dokumentation werden Erweiterungen und die Unterstützung von Feldern beschrieben.

Der Header Content-Type: application/json gibt eine JSON-Gebotsanfrage an, Accept: application/json gibt an, dass die Gebotsantworten im JSON-Format vorliegen sollen.

Protobuf-Format

HINWEIS: Die Protobuf-Unterstützung befindet sich in der Betaphase. Wenden Sie sich an DV360, wenn Sie daran interessiert sind.

JSON-Anfragen und ‑Antworten entsprechen der OpenRTB 2.6-Protobuf-Spezifikation des IAB.

Erweiterungen werden nur eingeschränkt unterstützt. Wenden Sie sich an den DV360-Support, wenn Sie daran interessiert sind.

Senden Sie den Header Content-Type: application/x-protobuf, um eine Protobuf-Gebotsanfrage anzugeben, und legen Sie Accept: application/x-protobuf fest, um Protobuf-Gebotsantworten zu erhalten.

Gebotsanfrageobjekt

Feld	Typ	Details
`id`	String	Erforderlich. Eindeutige ID der Gebotsanfrage. Damit können einzelne Anfragen für einen sehr begrenzten Zeitraum nach der Bereitstellung identifiziert werden.
`imp`	Imp-Array	Mindestens ein `imp`-Objekt ist erforderlich. Für Audio-Pods wird mehr als ein `imp`-Objekt unterstützt. Bei anderen Anwendungsfällen (z.B. mehrere unabhängige Slots auf der Seite) wird das erste `imp`-Objekt verwendet, die restlichen werden verworfen.
`site`	Website	Für Websiteanfragen erforderlich. `site` und `app` schließen sich gegenseitig aus.
`app`	App	Für App-Anfragen erforderlich. `app` und `site` schließen sich gegenseitig aus.
`device`	Gerät	Erforderlich.
`user`	Nutzer	Erforderlich.
`test`	Ganzzahl	Nicht unterstützt
`at`	Ganzzahl	`1`: Erstpreisauktion, bei der dem Werbetreibenden sein Gebotsbetrag in Rechnung gestellt wird. `2` (Standard): Zweitpreisauktion, bei der dem Werbetreibenden ein Betrag in Rechnung gestellt wird, der knapp über dem Gebot des zweithöchsten Bieters liegt. `3`: Der Mindestpreis ist in der Anfrage enthalten und hat nichts mit konkurrierenden Geboten zu tun.
`tmax`	Ganzzahl	Optional, Standard ist benutzerdefiniert pro Integration.
`wseat`	String-Array	Liste der zulässigen Käuferlizenzen. Empfohlen, sofern nicht alle Werbetreibenden Gebote abgeben dürfen. Wenn der Wert nicht festgelegt ist, gibt es keine Einschränkungen.
`bseat`	String-Array	Liste der Käufer-Seats, deren Gebote blockiert werden sollen. Die aufgeführten Käufer können keine Gebote für Deals und offene Auktionen abgeben.
`allimps`	Ganzzahl	Nicht unterstützt
`cur`	String-Array	Optional, aber dringend empfohlen. Die Standardeinstellung ist „pro Integration“. Die Währung in der Gebotsanfrage muss mit einer der Währungen übereinstimmen, die während der Integration registriert wurden. Wir empfehlen dringend, nur eine Währung pro Börse zu unterstützen.
`wlang`	String-Array	Nicht unterstützt
`bcat`	String-Array	Blockierte Werbetreibendenkategorien anhand der IAB-Inhaltskategorien. „Nicht festgelegt“ bedeutet, dass keine Kategorien blockiert sind.
`badv`	String-Array	Geben Sie den blockierten Werbetreibenden anhand der vom Werbetreibenden bereitgestellten Domain an. „Unset“ bedeutet, dass keine Werbetreibenden blockiert sind.
`bapp`	String-Array	Nicht unterstützt
`source`	Quelle	Teilweise erforderlich für `schain`.
`regs`	Regs	Optional.
`ext`	Erweiterungen für Gebotsanfragen	Optional.

Objekt für Erweiterungen für Gebotsanfragen

Feld	Typ	Details
`schain`	Lieferkette	Bei neuen Integrationen sollte stattdessen das Feld `BidRequest.source.schain` in Source verwendet werden.
`purch`	Ganzzahl	Der Parameter „Gekaufter Traffic“ ist der Traffic, der von Properties weitergeleitet wird, die nicht dem Unternehmen gehören oder durch Akquisitionen oder anderweitig auf Incentives basierende Aktivitäten erzielt wurden. Dies entspricht der neuen MRC-Spezifikation für ungültigen Traffic 2.0. In Berichten für Käufer wird dieses Feld als Publisher Traffic Source bezeichnet und kann einen der folgenden Werte haben : `0` (Standard): Undefined (Nicht definiert) – Der Wert wird nicht in Gebotsanfragen gesendet. Wert kann nicht erfasst werden; `1`: Gekauft: Die Nutzer wurden von Properties weitergeleitet, die nicht den Status „Eigene“ haben, z. B. über Akquisitionen oder anderweitig auf Incentives basierende Aktivitäten. `2`: Organisch – Der Nutzer erreicht Sie über einen direkten URL-Eintrag, die Websitesuche oder einen App-Download.
`gdemsignals`	String	Ein SCAR API-Signal-Blob aus dem GMA SDK. Empfohlen, wenn GMA SDK-Traffic, ansonsten verboten.
`disable_gma_format`	int	Optional, wenn `gdemsignals` angegeben ist, andernfalls nicht zulässig. `0` (Standard): Wenn `gdemsignals` ausgefüllt ist, ist das adm der Gebotsantwort ein JSON-Blob. `1`: Statt des JSON-Blobs wird auch ein Ad-Tag bereitgestellt.

Quellobjekt

Feld	Typ	Details
`fd`	Ganzzahl	Entität, die für die endgültige Entscheidung zum Anzeigenverkauf verantwortlich ist `0` (Standard): Die Entscheidung wird von der Exchange getroffen. `1`: Eine Upstream-Quelle entscheidet.
`tid`	String	Nicht unterstützt
`pchain`	String	Nicht unterstützt
`schain`	Lieferkette	In fast allen Fällen erforderlich. Dieses Feld wird gegenüber der Bereitstellung von `schain` über Gebotsanfrageerweiterungen oder Quellerweiterungen bevorzugt.
`ext`	Quellerweiterungen	Optional.

Quellerweiterungsobjekt

Diese Erweiterung wird dringend empfohlen, da sie sich darauf auswirkt, wie Sichtbarkeitsmessungen in DV3 für den Kunden gemeldet werden. Wenn der OMID-Partnername NICHT auf der IAB-Zertifizierungsliste steht, müssen wir die Sichtbarkeitsmesswerte gemäß MRC-Vorgaben separat von den MRC-zertifizierten Messwerten erfassen. Weitere Informationen

Feld	Typ	Details
`omidpn`	String	Kennung der OM SDK-Integration. Das ist derselbe Wert wie der Parameter „name“ des OMID-Partnerobjekts.
`omidpv`	String	Version der OM SDK-Integration. Dies entspricht dem Parameter „versionString“ des OMID-Partnerobjekts.
`schain`	Lieferkette	Bei neuen Integrationen sollte stattdessen das Feld `schain` in Source verwendet werden.

Regs-Objekt

Feld	Typ	Details
`coppa`	Ganzzahl	`0` (Standard): COPPA ist für diese Anfrage nicht anwendbar. `1`: Diese Anfrage unterliegt COPPA.
`ext`	Regs-Erweiterungen	Optional.

Objekt für Erweiterungen für Verordnungen

Feld	Typ	Details
`gdpr`	Ganzzahl	Gibt an, ob die Gebotsanfrage aus dem EWR stammt. `0` (Standard): Region außerhalb des EWR. `1`: EWR-Region. Weitere Informationen finden Sie unter Consented Provider Solution for GDPR.
`us_privacy`	String	Bitte folgen Sie der vom IAB Tech Lab bereitgestellten technischen Spezifikation, um den String `us_privacy` zu implementieren. Wenn wir den `us_privacy`-String in der Gebotsanfrage erhalten und wenn im IAB-String angegeben ist, dass ein Nutzer die Datenverarbeitung und -erhebung nicht deaktiviert hat, wird in Display & Video 360 ein Gebot für solche Anfragen abgegeben. Wir geben das IAB-Signal nicht an andere Anbieter weiter. Hat der Nutzer laut IAB-String die Erhebung dieser Daten deaktiviert, gibt Google für solche Anfragen kein Gebot ab.

Objekt für Impressionen

Feld	Typ	Details
`id`	String	Eine eindeutige Kennung für diese Impression im Kontext der Gebotsanfrage. Der Wert beginnt in der Regel mit 1 und wird für n Impressionen auf n erhöht.
`metric`	Objekt	Nicht unterstützt
`banner`	Banner	Erforderlich für Banneranzeigen.
`video`	Video	Erforderlich für Videoanzeigen-Empfehlungen.
`audio`	Audio	Erforderlich für Audioanzeigen-Empfehlungen.
`native`	Nativ	Erforderlich für native Umsatzchancen.
`pmp`	Pmp	Deals des privaten Marktplatzes, die für diese Impression gelten.
`displaymanager`	String	Name des Vermittlungspartners, der SDK-Technologie oder des Players, der für das Rendern der Anzeige verantwortlich ist (in der Regel Video oder Mobilgerät). Wird von einigen Ad-Servern verwendet, um den Anzeigencode nach Partner anzupassen. Für Videos und/oder Apps empfohlen.
`displaymanagerver`	String	Version des Vermittlungspartners, der SDK-Technologie oder des Players, der für das Rendern der Anzeige verantwortlich ist (in der Regel Video oder Mobilgerät). Wird von einigen Ad-Servern verwendet, um den Anzeigencode nach Partner anzupassen. Für Videos und/oder Apps empfohlen.
`instl`	Ganzzahl	`0` (Standard): kein Interstitial. `1`: Die Anzeige ist ein Interstitial oder wird im Vollbildmodus präsentiert.
`tagid`	String	Kennung für ein bestimmtes Anzeigen-Placement oder ein bestimmtes Anzeigen-Tag, mit dem die Auktion gestartet wurde. Das kann bei der Fehlerbehebung oder bei der Optimierung durch den Käufer hilfreich sein.
`bidfloor`	Gleitkommazahl	Mindestgebot für diese Impression in CPM.
`bidfloorcur`	String	Die Währung wird mit ISO 4217-Alphacodes angegeben.
`clickbrowser`	Ganzzahl	Gibt den Browsertyp an, der beim Klicken auf das Creative in einer App geöffnet wird. `0` (Standard): eingebettet `1`: nativ Der Safari View Controller auf iOS 9.x-Geräten gilt für dieses Feld als nativer Browser.
`secure`	Ganzzahl	Gibt an, ob für diese Impression eine sichere HTTPS-URL oder eine unsichere HTTP-URL erforderlich ist. `0` (Standard):insecure `1`: secure
`iframebuster`	String-Array
`exp`	Ganzzahl	Das Ablaufdatum für Gebote wird von DV360 festgelegt, unabhängig vom Wert, der von einem Partner in diesem Feld gesendet wird. Impressionsereignisse, die nach dem Zeitfenster für veraltete Impressionen (in der Regel 1 Stunde) eingehen, werden als veraltet verworfen und von DV360 nicht als abrechenbar betrachtet.
`rwdd`	Ganzzahl	Gibt an, ob der Nutzer eine Prämie für das Ansehen der Anzeige erhält. `0` (Standard): Keine Belohnung `1`: Belohnung Bei Videoanzeigen können Nutzer in der Regel einen zusätzlichen Nachrichtenartikel kostenlos lesen, ein zusätzliches Leben in einem Spiel erhalten oder eine gesponserte Musikwiedergabe ohne Anzeigen nutzen. Die Prämie wird in der Regel nach dem Ende der Videoanzeige verteilt.

Objekt für die Reichweitenerweiterung

Feld	Typ	Details
`bcrid`	String	Liste der Creative-IDs, die blockiert werden sollen.

Feld	Typ	Details
`format`	Format-Array	Eine Liste der unterstützten Formate.
`w`	Ganzzahl	`h` und `w` werden im Feld `format` zusammengeführt. Es wird empfohlen, stattdessen `format` zu verwenden.
`h`	Ganzzahl	`h` und `w` werden im Feld `format` zusammengeführt. Es wird empfohlen, stattdessen `format` zu verwenden.
`wmax`	Ganzzahl	Nicht unterstützt
`hmax`	Ganzzahl	Nicht unterstützt
`wmin`	Ganzzahl	Nicht unterstützt
`hmin`	Ganzzahl	Nicht unterstützt
`btype`	Ganzzahl-Array	Liste der gesperrten Banneranzeigentypen: `1`: HTML-Textanzeigen `2`: HTML-Banneranzeigen `3`: JavaScript-Anzeigen `4`: IFrame-Anzeigen
`battr`	Ganzzahl-Array	Folgende Werte werden unterstützt: `1`: Automatische Audiowiedergabe `2`: Vom Nutzer initiierte Audiowiedergabe `3`: Automatisch maximierbar `4`: Durch Klicken maximierbar `5`: Durch Mouseover maximierbar `6`: Automatische Videowiedergabe im Banner `7`: Vom Nutzer initiierte Videowiedergabe im Banner `8`: Pop-up(über/unter/beim Verlassen) `9`: Provokativ oder anzüglich `10`: „Ärgerlich“, z. B. wackelig, blinkend, flackernd, extreme Animation, Smileys `11`: Umfragen `12`: Nur Text `13`: Nutzerinteraktiv (Spiele) `14`: Windows-Dialog oder ‑Benachrichtigung `15`: Mit Ein/Aus-Schaltfläche für Audio `16`: Anzeige kann übersprungen werden `17`: Flash
`pos`	Ganzzahl	Die Position der Anzeige: `0` (Standard): Unbekannt `1`: Über der Falte `2`: Nicht unterstützt:Wahrscheinlich unter der Falte `3`: Unter der Falte `4`: Kopfzeile `5`: Fußzeile `6`: Seitenleiste `7`: Vollbild
`mimes`	String-Array	Nicht unterstützt In DV360 wird für alle Banner-Creatives „text/html“ verwendet.
`topframe`	Ganzzahl	`0` (Standard): Das Banner wird in einem iFrame ausgeliefert. `1`: Nicht unterstützt: Das Banner wird im oberen Frame ausgeliefert.
`expdir`	Ganzzahl-Array	`1`: Links `2`: Rechts `3`: Oben `4`: Unten `5`: Maximierbares Vollbild
`api`	Ganzzahl-Array	Unterstützte API-Frameworks `1`: Links `2`: Rechts `3`: Oben `4`: Unten `5`: Maximierbares Vollbild
`id`	String	Eine Kennung für das Bannerobjekt, die im Impression eindeutig sein sollte. Empfohlen, wenn `banner`-Objekte mit einem Video-Objekt verwendet werden.
`vcm`	Ganzzahl	Nur relevant für ein `banner`, das mit einem Videoobjekt verwendet wird. `0`: Das Banner ist gleichzeitig mit dem Video-Creative zu sehen. `1`: Das Banner ist ein Endbild nach dem Video.

Formatobjekt

Feld	Typ	Details
`w`	Ganzzahl	Breite in geräteunabhängigen Pixeln (DIPs).
`h`	Ganzzahl	Höhe in geräteunabhängigen Pixeln (DIPs).
`wratio`	Ganzzahl	Nicht unterstützt
`hratio`	Ganzzahl	Nicht unterstützt
`wmin`	Ganzzahl	Nicht unterstützt

Videoobjekt

Wir empfehlen dringend, das Video-Placement in der Gebotsanfrage anzugeben. Ein fehlendes Placement-Feld wird als unbekanntes Placement klassifiziert. Weitere Informationen zum Ausrichten auf Positionen

Feld	Typ	Details
`mimes`	String-Array	Mindestens ein MIME-Typ ist erforderlich. `video/flv` oder `video/x-f4v` `video/mp4`, `video/x-mp4` oder `application/mp4` `video/webm` oder `video/x-webm` `video/x-ms-wmv` `video/3gpp` `video/ogg` oder `application/ogg` `application/javascript` oder `application/x-javascript`
`minduration`	Ganzzahl	Die Mindestdauer des Videos in Sekunden. Standardmäßig gibt es kein Minimum.
`maxduration`	Ganzzahl	Die maximale Dauer eines Videos in Sekunden. Standardmäßig gibt es keine Obergrenze.
`protocols`	Ganzzahl-Array	Mindestens ein unterstütztes Protokoll ist erforderlich. `1`: VAST 1.0 `2`: VAST 2.0 `3`: VAST 3.0 `4`: VAST 1.0-Wrapper `5`: VAST 2.0-Wrapper `6`: VAST 3.0-Wrapper `7`: VAST 4.0 `8`: VAST 4.0-Wrapper `9`: DAAST 1.0 `10`: DAAST 1.0-Wrapper
`w`	Ganzzahl	Breite des Videoplayers in geräteunabhängigen Pixeln (DIPs).
`h`	Ganzzahl	Höhe des Videoplayers in geräteunabhängigen Pixeln (DIPs).
`startdelay`	Ganzzahl	Startverzögerung in Sekunden für Pre-Roll-, Mid-Roll- oder Post-Roll-Anzeigen-Placements.
`placement`	Ganzzahl	Es wird dringend empfohlen, „plcmt“ und/oder die Platzierung des Videos in der Gebotsanfrage anzugeben. Wenn beide Felder fehlen, wird die Platzierung als unbekannt eingestuft. `0` (Standard): Unknown `1`: In stream `2`: In banner `3`: In article `4`: In feed `5`: Floating Hinweis:Damit Video-Placements/-Impressionen als In-Stream (Placement oder Plcmt-Typ 1) gelten, muss der Ton aktiviert sein und die Wiedergabemethode muss korrekt signalisiert werden (die Werte 1, 3, 4 und 5 sind alle zulässig).
`plcmt`	Ganzzahl	Es wird dringend empfohlen, „plcmt“ und/oder die Platzierung des Videos in der Gebotsanfrage anzugeben. Wenn beide Felder fehlen, wird die Platzierung als unbekannt eingestuft. `0` (Standard): Unbekannt `1`: In-Stream `2`: Begleitende Inhalte `3`: Interstitial `4`: Kein Inhalt/Eigenständig Hinweis:Damit Video-Placements/-Impressionen als In-Stream (Placement oder Plcmt-Typ 1) gelten, muss der Ton aktiviert sein und die Wiedergabemethode muss korrekt signalisiert werden (die Werte 1, 3, 4 und 5 sind alle zulässig). Hinweis:Wenn Sie sowohl `plcmt` als auch `placement` angeben, hat `plcmt` Vorrang. Weitere Informationen finden Sie im IAB-Leitfaden zur Migration zu plcmt. Hinweis:`plcmt: Accompanying Content (2)` wird als `placement: In Article (3)` betrachtet. `plcmt: No Content/Standalone (4)` wird als `placement: In feed (4)` betrachtet. `placement: In Banner` hat keine Zuordnung in `plcmt`.
`linearity`	Ganzzahl	Nicht unterstützt
`skip`	Ganzzahl	Gibt an, ob die Anzeige im Videoplayer übersprungen werden kann. `0` (Standard): Nicht überspringbar `1`: Überspringbar
`skipmin`	Ganzzahl	Nicht unterstützt
`skipafter`	Ganzzahl	Nicht unterstützt
`sequence`	Ganzzahl	Wenn in derselben Gebotsanfrage mehrere Anzeigenimpressionen angeboten werden, kann mit der Sequenznummer die koordinierte Auslieferung mehrerer Creatives ermöglicht werden.
`battr`	Ganzzahl-Array	Blockierte Creative-Attribute.
`maxextended`	Ganzzahl	Maximale Dauer der erweiterten Videoanzeige, sofern die Erweiterung zulässig ist. `0` (Standard): Die Verlängerung ist nicht zulässig. `-1`: Die Verlängerung ist zulässig und es gibt kein Zeitlimit. `>0`: Die Anzahl der Sekunden, die über den Wert „maxduration“ hinaus verlängert werden können.
`minbitrate`	Ganzzahl	Mindestbitrate in Kbit/s.
`maxbitrate`	Ganzzahl	Maximale Bitrate in Kbit/s.
`boxingallowed`	Ganzzahl	Gibt an, ob 4:3-Inhalte in einem 16:9-Fenster letterboxiert werden dürfen. `0`: Nicht zulässig `1` (Standard): Zulässig
`playbackmethod`	Ganzzahl-Array	Wiedergabemethoden, die möglicherweise verwendet werden. Wenn keine angegeben sind, kann jede Methode verwendet werden. `0` (Standard): Unbekannt `1`: Automatische Wiedergabe, Ton an `2`: Automatische Wiedergabe, Ton aus `3`: Wiedergabe durch Klicken `4`: Mouseover `5`: Wiedergabe beim Aufrufen des Viewports, Ton an `6`: Wiedergabe beim Aufrufen des Viewports, Ton aus Hinweis:Bei allen Impressionen mit „Standardmäßig kein Ton“ (Wiedergabemethode 2, 6 oder 0) muss ein Out-Stream-Placement vom Typ 2, 3, 4 oder 5 (oRTB 2.5) oder ein Placement-Untertyp von 2, 3 oder 4 angegeben werden.
`playbackend`	Ganzzahl	Das Ereignis, das das Ende der Wiedergabe verursacht. `1`: Video wird bis zum Ende wiedergegeben oder vom Nutzer beendet `2`: Video wird beendet, wenn es aus dem Sichtbereich verschwindet oder vom Nutzer beendet wird `3`: Video wird als schwebendes Fenster weiter wiedergegeben, wenn es aus dem Sichtbereich verschwindet, bis es vollständig wiedergegeben wird oder vom Nutzer beendet wird
`delivery`	Ganzzahl-Array	Unterstützte Auslieferungsmethoden. Wenn keine angegeben sind, wird davon ausgegangen, dass alle unterstützt werden. `1`: Streaming `2`: Progressiv
`pos`	Ganzzahl	Anzeigenposition auf dem Bildschirm. `0` (Standard): Unbekannt `1`: Über der Falte `2`: Nicht unterstützt:Wahrscheinlich unter der Falte `3`: Unter der Falte `4`: Kopfzeile `5`: Fußzeile `6`: Seitenleiste `7`: Vollbild
`companionad`	Banner-Array	Companion-Anzeigen, sofern verfügbar.
`api`	Ganzzahl-Array	`0` (Standard): Unbekannt `1`: VPAID 1 `2`: VPAID 2 `3`: MRAID 1 `4`: ORMMA `5`: MRAID 2 `6`: MRAID 3 `7`: OMID 1 – erforderlich, um Messungen mit OMID für Active View zu aktivieren. `8`: SIMID 1
`companiontype`	Ganzzahl-Array	Nicht unterstützt
`maxseq`	Ganzzahl	Die maximale Anzahl von Anzeigen, die in einem dynamischen Video-Pod zurückgegeben werden sollen.
`poddur`	Ganzzahl-Array	Die maximale Länge eines dynamischen Video-Pods in Sekunden.

Unterstützte Erweiterung für Videoobjekte

Feld	Typ	Details
`rewarded`	Ganzzahl	Dieses Feld gibt an, ob die Anfragen belohnt werden oder nicht. Dieser Wert sollte als Ganzzahl gesendet werden. `0` (Standard): keine Teilnahmebelohnung `1`: Teilnahmebelohnung

Audioobjekt

Feld	Typ	Details
`mimes`	String-Array	Mindestens ein MIME-Typ ist erforderlich. `audio/m4a`, `audio/mp4` oder `audio/x-m4a` `audio/mpeg` oder `audio/mp3` `audio/ogg` oder `audio/x-ogg`
`minduration`	Ganzzahl	Minimale Anzeigendauer in Sekunden.
`maxduration`	Ganzzahl	Maximale Anzeigendauer in Sekunden.
`protocols`	Ganzzahl-Array	`3`: VAST 3.0 `6`: VAST 3.0-Wrapper `7`: VAST 4.0 `8`: VAST 4.0-Wrapper
`startdelay`	Ganzzahl	Die Startverzögerung in Sekunden für Pre-Roll-, Mid-Roll- oder Post-Roll-Anzeigen-Placements. `-2`: Post-Roll `-1`: Mid-Roll `0`: Pre-Roll `>0`: Mid-Roll
`sequence`	Ganzzahl	Nicht unterstützt
`battr`	Ganzzahl-Array	Nicht unterstützt
`maxextended`	Ganzzahl	Nicht unterstützt
`minbitrate`	Ganzzahl	Die Mindestbitrate in Kbit/s.
`maxbitrate`	Ganzzahl	Die maximale Bitrate in Kbit/s.
`delivery`	Ganzzahl-Array	Nicht unterstützt
`companionad`	Array mit Bannerobjekten	Alle Companion-Creative-Slots für Banner.
`api`	Ganzzahl-Array	Liste der unterstützten API-Frameworks für diese Impression. `7`: Omid V1
`companiontype`	Ganzzahl-Array	Nicht unterstützt
`maxseq`	Ganzzahl-Array	Nicht unterstützt
`feed`	Ganzzahl	Typ des Audiofeeds. `1`: Musikdienst `2`: Broadcast `3`: Podcast
`stitched`	Ganzzahl	Nicht unterstützt
`nvol`	Ganzzahl	Nicht unterstützt

Natives Objekt

Weitere Informationen finden Sie in den Spezifikationen für native DV360-Anzeigen.

Feld	Typ	Details
`request`	String	Das als String codierte native JSON-Objekt.
`ver`	String	`1.0`: Nicht unterstützt `1.1`: Nicht unterstützt `1.2`
`api`	Ganzzahl-Array	Liste der unterstützten API-Frameworks für diese Impression. `7`: Omid V1
`battr`	Ganzzahl-Array	Nicht unterstützt

PMP-Objekt

Feld	Typ	Details
`private_auction`	Ganzzahl	`0` (Standard): Alle Gebote zulässig `1`: Nur Deals
`deals`	Array mit Deal-Objekten	Die Angebote, die einbezogen werden sollen.

Deal-Objekt

Feld	Typ	Details
`id`	String	Ein PMP-Objekt darf nicht mehr als ein Deal-Objekt pro ID enthalten.
`bidfloor`	Doppelt	Mindestgebot für diese Impression in CPM. Erforderlich, wenn `at=3`.
`bidfloorcur`	String	Die Währung wird mit ISO 4217-Alphacodes angegeben. Wenn keine Angabe erfolgt, wird standardmäßig die Währung der Gebotsanfrage verwendet.
`at`	Ganzzahl	Wenn keine Angabe erfolgt, wird standardmäßig `bid_request.at` verwendet. `1`: Erster Preis `2`: Zweiter Preis `3`: Festpreis
`wseat`	String-Array	Die Partner-IDs der Partner, die für den Deal infrage kommen. Wenn keine Plätze verfügbar sind, gibt es auch keine Platzbeschränkungen.
`wadomain`	String-Array	Die Werbetreibendendomains, die für diesen Deal Gebote abgeben dürfen. Wenn keine Arbeitsplätze vorhanden sind, gibt es auch keine Domainbeschränkungen.
`guar`	Ganzzahl	Dieses Feld gibt an, ob es sich bei dem Deal um einen garantierten Deal handelt. Dieser Wert sollte als Ganzzahl gesendet werden. Eine Anzeigenplattform muss auf der Zulassungsliste für DV360 stehen, damit garantierte Deals akzeptiert werden. Wenden Sie sich an uns, um dies zu beantragen. Wenn für Ihren Exchange derzeit ein anderer Mechanismus verwendet wird, um garantierte Deals mit DV360 zu signalisieren, wenden Sie sich an uns, um die Umstellung auf diese bevorzugte Erweiterung zu besprechen. `0` (Standard): Nicht garantiert `1`: Garantiert
`ext`	Erweiterungen für Angebote	Optional.

Unterstützte Erweiterung für das Angebotsobjekt

Feld Typ Details

Feld	Typ	Details
`guaranteed`	Ganzzahl	Dieses Feld gibt an, ob es sich bei dem Deal um einen garantierten Deal handelt. Dieser Wert sollte als Ganzzahl gesendet werden. Eine Anzeigenplattform muss auf der Zulassungsliste für DV360 stehen, damit garantierte Deals akzeptiert werden. Wenden Sie sich an uns, um dies zu beantragen. Wenn für Ihren Exchange derzeit ein anderer Mechanismus verwendet wird, um garantierte Deals mit DV360 zu signalisieren, wenden Sie sich an uns, um die Umstellung auf diese bevorzugte Erweiterung zu besprechen. `0` (Standard): Nicht garantiert `1`: Garantiert Es wird empfohlen, `deal.guar` anstelle dieses Felds zu verwenden.

guaranteed

Ganzzahl

Dieses Feld gibt an, ob es sich bei dem Deal um einen garantierten Deal handelt. Dieser Wert sollte als Ganzzahl gesendet werden.

Eine Anzeigenplattform muss auf der Zulassungsliste für DV360 stehen, damit garantierte Deals akzeptiert werden. Wenden Sie sich an uns, um dies zu beantragen.

Wenn für Ihren Exchange derzeit ein anderer Mechanismus verwendet wird, um garantierte Deals mit DV360 zu signalisieren, wenden Sie sich an uns, um die Umstellung auf diese bevorzugte Erweiterung zu besprechen.

0 (Standard): Nicht garantiert
1: Garantiert

Es wird empfohlen, deal.guar anstelle dieses Felds zu verwenden.

Websiteobjekt

Feld	Typ	Details
`id`	String	Die ID der Website auf der Anzeigenplattform.
`name`	String	Nicht unterstützt
`domain`	String	Die Domain der Website. Es wird empfohlen, eine vollständige URL in „site.page“ zu senden, anstatt nur „site.domain“ auszufüllen.
`cat`	String-Array	Nicht unterstützt
`sectioncat`	String-Array	Nicht unterstützt
`pagecat`	String-Array	Nicht unterstützt
`page`	String	Die vollständige URL, unter der die Impression ausgeliefert werden soll. Es wird empfohlen, die vollständige URL für das Targeting zu senden.
`ref`	String	Die Verweis-URL, die die Navigation zur aktuellen Seite ausgelöst hat.
`search`	String	Nicht unterstützt
`mobile`	Ganzzahl	Nicht unterstützt
`privacypolicy`	Ganzzahl	Nicht unterstützt
`publisher`	Publisher-Objekt	Details zum Publisher der Website.
`content`	Inhaltsobjekt	Details zum Inhalt einer Website.
`keywords`	String (CSV-Format)	Nicht unterstützt
`ext`	Website-Erweiterungen	Erweiterungen für das Websiteobjekt.

Website-Erweiterungsobjekt

Feld	Typ	Details
`inventorypartnerdomain`	String	Wird für die Freigabe von CTV-Inventar verwendet. Weitere Informationen finden Sie im IAB-Leitfaden zu CTV-App-Adds.

App-Objekt

Feld	Typ	Details
`id`	String	Anwendungs-ID auf der Anzeigenplattform.
`name`	String	Anwendungsnamen, die auf Anfrage von Publishern möglicherweise als Alias verwendet werden. App-Namen für Anfragen ohne SDK (hauptsächlich internetfähige Fernseher) können vom Publisher direkt in der Anfrage angegeben werden.
`bundle`	String	Erforderlich. Bei iOS muss es sich um die numerische App-Shop-ID handeln. Wir akzeptieren keine Paket-ID im Reverse-DNS-Stil. Bei CTV-Apps empfehlen wir, die vom App-Shop definierte App-ID zu übergeben. Bitte halten Sie sich an die kürzlich veröffentlichten IAB-Richtlinien für die Zuweisung von IDs für OTT-/CTV-Stores.
`domain`	String	Die Domain, z. B. `mygame.foo.com`
`storeurl`	String	Erforderlich für die app-ads.txt-Überprüfung und die Validierung im App-Shop für internetfähige Fernseher.
`cat`	String-Array	Nicht unterstützt
`sectioncat`	String-Array	Nicht unterstützt
`pagecat`	String-Array	Nicht unterstützt
`ver`	String	Nicht unterstützt
`privacypolicy`	Ganzzahl	Nicht unterstützt
`paid`	Ganzzahl	Nicht unterstützt
`publisher`	Publisher-Objekt	Informationen zum App-Publisher.
`content`	Inhaltsobjekt	Informationen zu den App-Inhalten.
`keywords`	String (CSV-Format)	Nicht unterstützt
`ext`	App-Erweiterungen	Erweiterungen für das App-Objekt.

Objekt für App-Erweiterung

Feld	Typ	Details
`inventorypartnerdomain`	String	Wird für die Freigabe von CTV-Inventar verwendet. Weitere Informationen finden Sie im IAB-Leitfaden zu CTV-App-Adds.

Inhaltsobjekt

Wir empfehlen, diese Attribute anzugeben, sofern verfügbar.

Feld	Typ	Details
`id`	String	Eine ID, die den Inhalt eindeutig identifiziert.
`episode`	Ganzzahl	Folgennummer des Inhalts (normalerweise für Videoinhalte).
`title`	String	Empfohlen für CTV-, Video- und Audioanfragen.
`series`	String	Empfohlen für CTV-, Video- und Audioanfragen.
`season`	String	Ein Label für die Staffel der Inhalte.
`artist`	String	Der Künstler, dem die Inhalte zugeschrieben werden.
`genre`	String	Das Genre, das den Inhalt am besten beschreibt. In DV360 wird empfohlen, dieses Signal für CTV-, Video- und Audioanfragen bereitzustellen. DV360 unterstützt für dieses Feld einige Taxonomien von Videogenrewerten: Google-Liste der Genres (Herunterladen) IAB-Kategorien für TV/Filme/Sport (Herunterladen) Gracenote-Videogenre-Taxonomie von Nielsen
`album`	String	Das Album, zu dem die Inhalte gehören, in der Regel für Audioinhalte.
`isrc`	String	International Standard Recording Code gemäß ISO 3901.
`producer`	Erstellerobjekt	Details zum Produzenten der Inhalte.
`url`	String	URL des Inhalts.
`cat`	String-Array	IAB-Inhaltskategorien, die den Inhalt beschreiben.
`prodq`	Ganzzahl	Produktionsqualität: `0` (Standard): Unbekannt `1`: Professionell `2`: Prosumer `3`: Von Nutzern erstellt
`videoquality`	Ganzzahl	Nicht unterstützt
`context`	Ganzzahl	Art der Inhalte: `1`: Video `2`: Spiel `3`: Musik `4`: Anwendung `5`: Text `6`: Sonstiges `7`: Unbekannt
`contentrating`	String	Empfohlen für Audio und Video/CTV, da wir mit der Entscheidungsfindung für dieses Attribut beginnen.
`userrating`	String	Anzahl der Sterne, Likes usw.
`qagmediarating`	Ganzzahl	Media-Bewertung gemäß [QAG-Richtlinien](http://www.iab.net/ne_guidelines). `1`: Alle Zielgruppen `2`: 12+ `3`: Nicht jugendfrei
`keywords`	String (CSV-Format)	Nicht unterstützt
`livestream`	Ganzzahl	Wenn es sich bei den Inhalten um Livestream-Inhalte handelt. `0`: Nicht live `1`: Inhalt ist live
`sourcerelationship`	Ganzzahl	`0`: Indirekt `1`: Direkt
`len`	Ganzzahl	Die Länge des Inhalts in Sekunden. Empfohlen für CTV-/Video- und Audioanfragen.
`language`	String (ISO-639-1-alpha-2)	Die Sprache des Inhalts.
`embeddable`	Ganzzahl	Gibt an, ob die Inhalte eingebettet werden können (z. B. ein einbettbarer Videoplayer). `0`: Nicht einbettbar `1`: Einbettbar
`data`	Array von Datenobjekten	Zusätzliche Daten.

Erstellerobjekt

Feld	Typ	Details
`id`	String	Nicht unterstützt
`name`	String	Nicht unterstützt
`cat`	String-Array	Nicht unterstützt
`domain`	String	Domain der obersten Ebene des Erstellers.

Datenobjekt

Feld	Typ	Details
`id`	String	Eine ID des Datenanbieters.
`name`	String	Name des Datenaustauschs für den Datenanbieter.
`segment`	Array von Segmentobjekten	Die tatsächlichen Datenwerte.
`ext`	Datenerweiterungen	Erweiterungen für das Data-Objekt.

Unterstützte Erweiterungen für Datenobjekte

Feld	Typ	Details
`segtax`	Ganzzahl	Taxonomie-ID. Weitere Informationen finden Sie unter Segmenttaxonomien.
`segclass`	String	Die Version des Klassifikators, mit dem die Segment-IDs in der Taxonomie erstellt wurden.

Segmentobjekt

Feld	Typ	Details
`id`	String	Eine ID des Datensegments, die für den Datenanbieter spezifisch ist.
`name`	String	Name des Datensegments.
`value`	String	Wert des Datensegments.

Publisher-Objekt

Feld	Typ	Details
`id`	String	Erforderlich.
`name`	String	Nicht unterstützt
`cat`	String-Array	Nicht unterstützt
`domain`	String	Nicht unterstützt

Geräteobjekt

Feld	Typ	Details
`ua`	String	Erforderlich.
`sua`	UserAgent-Objekt	Strukturierte User-Agent-Informationen.
`geo`	Geografisches Objekt	Der Standort des Geräts.
`dnt`	Ganzzahl	Das „Do Not Track“-Flag, wie es im Header des Browsers festgelegt ist. `0`: Tracking ist uneingeschränkt `1`: Nicht tracken
`lmt`	Ganzzahl	Das Signal „Anzeigen-Tracking einschränken“ wird kommerziell unterstützt. `0`: Das Tracking ist uneingeschränkt möglich. `1`: Das Tracking muss gemäß den kommerziellen Richtlinien eingeschränkt werden.
`ip`	String	Erforderlich, wenn IPv4. Wenn die IP-Adresse gekürzt wird, muss dies in der `device.ext.truncated_ip` angegeben werden.
`ipv6`	String	Erforderlich, wenn IPv6. Wenn die IP-Adresse gekürzt wird, muss dies in der `device.ext.truncated_ip` angegeben werden.
`devicetype`	Ganzzahl	Für alle Inventartypen dringend empfohlen. Wird zur Verbesserung der Erkennung des Gerätetyps verwendet.
`make`	String
`model`	String
`os`	String	Betriebssystem des Geräts `ios`: In einer App-Anfrage wird damit iOS-Traffic identifiziert. `android`: Identifiziert ein Android-Gerät, wenn das Gerät nicht durch `ua` oder `sua` identifiziert wird. `[anything else]`: Wird in der Diagnose verwendet, um Probleme zu isolieren. Bei diesem Feld wird Groß- und Kleinschreibung nicht berücksichtigt.
`osv`	String	Nicht unterstützt
`hwv`	String	Die Hardwareversion des Geräts.
`h`	Ganzzahl	Die physische Höhe des Displays in Pixeln.
`w`	Ganzzahl	Die physische Breite des Displays in Pixeln.
`ppi`	Ganzzahl	Nicht unterstützt
`pxratio`	Doppelt	Das Verhältnis von physischen Pixeln zu geräteunabhängigen Pixeln.
`js`	Ganzzahl	Nicht unterstützt
`geofetch`	Ganzzahl	Nicht unterstützt
`flashver`	String	Nicht unterstützt
`language`	String (ISO-639-1-alpha-2)	Die Sprache des Geräts.
`carrier`	String	Nicht unterstützt
`mccmnc`	String	Nicht unterstützt
`connectiontype`	Ganzzahl	Art der Netzwerkverbindung
`ifa`	String	ID, die der Werbetreibende im Klartext verwenden darf.
`didsha1`	String	Nicht unterstützt
`didmd5`	String	Nicht unterstützt
`dpidsha1`	String	Nicht unterstützt
`dpidmd5`	String	Nicht unterstützt
`macsha1`	String	Nicht unterstützt
`macmd5`	String	Nicht unterstützt
`ext`	Geräteerweiterungen	Erweiterungen für das Geräteobjekt.

Unterstützte Erweiterung für Geräteobjekt

Wenn ip geändert oder gekürzt wird, empfehlen wir dringend, die folgenden Erweiterungen zu senden, um zu verhindern, dass Traffic als ungültiger Traffic deklariert wird.

Feld	Typ	Details
`truncated_ip`	Ganzzahl	Geben Sie an, ob die IP-Adresse im Feld `device.ip` der Gebotsanfrage gekürzt ist. `0`: Nicht gekürzt `1`: Gekürzt Standardmäßig wird die IP-Adresse nicht gekürzt. Sie ist erforderlich, wenn die IP-Adresse gekürzt wird. Wenn sie nicht deklariert wird, kann die Gebotsanfrage als ungültiger Traffic klassifiziert werden.
`ifa_type`	String	Gibt den Ursprung des Felds „device.ifa“ an, d. h., ob es vom Gerät selbst bereitgestellt oder vom Publisher oder der SSP in der Lieferkette generiert wurde. `aaid`: Android TV `rida`: Roku `afai`: Amazon Fire `idfa`: Apple tvOS `msai`: Xbox/Microsoft `dpid`: Allgemeine Geräteplattform-ID `ppid`: Vom Publisher bereitgestellte ID `sspid`: Von der SSP bereitgestellte ID `sessionid`: Kurzlebige Sitzungs-ID (nur für Frequency Capping)
`attestation_token`	String (Base64-Codierung)	Ein gerätebasiertes Attestierungstoken für Börsen, die diese Art der Gerätevalidierung unterstützen.
`atts`	Ganzzahl	(Nur iOS) Eine Ganzzahl, die den Autorisierungsstatus für das App-Tracking der App darstellt. `0`: Nicht ermittelt `1`: Eingeschränkt `2`: Abgelehnt `3`: Autorisierte
`cdep`	String	Label für die Einstellung von Drittanbieter-Cookies in Chrome. Weitere Informationen finden Sie unter Von Chrome unterstützte Tests und in der IAB Community Specification.

UserAgent-Objekt

Feld	Typ	Details
`browsers`	Array von BrandVersion-Objekten	Jedes BrandVersion-Objekt identifiziert einen Browser oder eine ähnliche Softwarekomponente.
`platform`	BrandVersion-Objekt	Gibt die Plattform an.
`mobile`	Ganzzahl	`0` (Standard): Der Kundenservicemitarbeiter bevorzugt den „Desktop“- oder „Full“-Inhalt. `1`: Der Nutzer bevorzugt Inhalte für Mobilgeräte.
`architecture`	String	Gerätearchitektur, z. B. „x86“ oder „arm“.
`bitness`	String	Die Bit-Anzahl des Geräts, z. B. „64“ für eine 64-Bit-Architektur.
`model`	String	Gerätemodell
`source`	Ganzzahl	Die Quelle der Daten, die zum Erstellen dieses Objekts verwendet wurden. Weitere Informationen finden Sie unter Liste: User-Agent-Quelle. Empfohlen, wenn das UserAgent-Objekt übergeben wird.

BrandVersion-Objekt

Feld	Typ	Details
`brand`	String	Markenkennung, z. B. „Chrome“ oder „Windows“. Erforderlich.
`version`	String-Array	Eine Sequenz von Versionskomponenten in absteigender hierarchischer Reihenfolge (Haupt-, Neben-, Mikroversion usw.).

Geografisches Objekt

Feld	Typ	Details
`lat`	Doppelt	Nicht unterstützt
`lon`	Doppelt	Nicht unterstützt
`type`	Ganzzahl	Nicht unterstützt
`accuracy`	Ganzzahl	Nicht unterstützt
`lastfix`	Ganzzahl	Nicht unterstützt
`ipservice`	Ganzzahl	Nicht unterstützt
`country`	String	Nicht unterstützt
`region`	String	Nicht unterstützt
`regionfips104`	String	Nicht unterstützt
`metro`	String	Nicht unterstützt
`city`	String	Nicht unterstützt
`zip`	String	Nicht unterstützt
`utcoffset`	Ganzzahl	Nicht unterstützt

Nutzerobjekt

Feld	Typ	Details
`id`	String	Wird unterstützt, wenn Google die ID-Abgleichstabelle hostet.
`buyeruid`	String	Wird unterstützt, wenn die SSP die ID-Abgleichstabelle hostet.
`yob`	Ganzzahl	Empfohlen für demografisches Targeting.
`gender`	String	Empfohlen für demografisches Targeting.
`keywords`	String (CSV)	Nicht unterstützt
`customdata`	String	Nicht unterstützt
`geo`	Geografisches Objekt	Nicht unterstützt
`data`	Array von Datenobjekten	Zusätzliche Daten.
`eids`	Array von Objekten mit erweiterter ID	Von der Börse bereitgestellte Instanzen mit erweiterter ID.
`ext`	Nutzererweiterungen	Erweiterungen für das Nutzerobjekt.

Unterstützte Erweiterungen für das Nutzerobjekt

Feld	Typ	Details
`consent`	String (websicheres Base64)	IAB-Einwilligungsstring. Enthält Metadaten dazu, welche Informationen der Nutzer zur Erhebung freigegeben hat und welche Anbieter diese Informationen verwenden dürfen. Der Wert ist ein websicherer, Base64-codierter binärer String in einem benutzerdefinierten binären Format.
`us_privacy`	String	Ob der Nutzer die Compliance für das CCPA oder ähnliche Gesetze gesehen hat.
`consented_providers_settings`.`consented_providers`	Äußeres Objekt (consented_providers_settings), das ein inneres Integer-Array (consented_providers) umschließt.	Wenn die DSGVO-Einwilligung über das TCF eingeholt wird, werden in diesem Feld die Anzeigentechnologie-Anbieter aufgeführt, die nicht am TCF teilnehmen und für die Nutzer ihre Einwilligung gegeben haben. Weitere Informationen finden Sie unter Technische Google-Spezifikation „Zusätzliche Einwilligung“.
`eids`	Array von Objekten mit erweiterter ID	Von der Börse bereitgestellte Instanzen mit erweiterter ID.

Objekt mit erweiterter ID

Feld	Typ	Details
`source`	String	Der Anbieter der Kennung
`uids`	Array von Extended ID UID-Objekten	Die tatsächlichen Kennungen

Erweiterte ID – UID-Objekt

Feld	Typ	Details
`id`	String	Die Kennung selbst.
`atype`	Ganzzahl	Der User-Agent-Typ, der dieser ID zugeordnet ist.

Lieferkettenobjekt

Feld Typ Details

complete Ganzzahl 0 (Standard): Die Lieferkette ist unvollständig.
1: Die Supply Chain ist bis zum Publisher vollständig.

ver String Erforderlich.
Der Wert wird im Format „major.minor“ angegeben. Version 1.0 ist beispielsweise der String „1.0“.

Feld	Typ	Details
`complete`	Ganzzahl	`0` (Standard): Die Lieferkette ist unvollständig. `1`: Die Supply Chain ist bis zum Publisher vollständig.
`ver`	String	Erforderlich. Der Wert wird im Format „major.minor“ angegeben. Version 1.0 ist beispielsweise der String „1.0“.
`nodes`	Array mit Lieferkettenknoten	Erforderlich. In einer vollständigen Lieferkette stellt der erste Knoten das ursprüngliche Werbesystem und die Verkäufer-ID dar, die an der Transaktion beteiligt sind, d.h. den Inhaber der Website, App oder eines anderen Mediums. In einer unvollständigen Lieferkette stellt sie den ersten bekannten Knoten dar. Der letzte Knoten stellt die Einheit dar, die diese Gebotsanfrage sendet.

nodes

Array mit Lieferkettenknoten

Erforderlich.

In einer vollständigen Lieferkette stellt der erste Knoten das ursprüngliche Werbesystem und die Verkäufer-ID dar, die an der Transaktion beteiligt sind, d.h. den Inhaber der Website, App oder eines anderen Mediums.

In einer unvollständigen Lieferkette stellt sie den ersten bekannten Knoten dar. Der letzte Knoten stellt die Einheit dar, die diese Gebotsanfrage sendet.

Lieferkettenknotenobjekt

Feld	Typ	Details
`asi`	String	Der kanonische Domainname der SSP, der Anzeigenplattform, des Header-Wrappers oder des Systems, mit dem Bieter sich verbinden können. Hier kann die operative Domain des Systems angegeben werden, wenn sie sich von der übergeordneten Domain des Unternehmens unterscheidet. Dies erleichtert es, durch das Abrufen von WHOIS-Informationen und umgekehrte IP-Suchen klaren Aufschluss über die Eigentumsrechte des delegierten Systems zu erhalten. Dieser Wert sollte mit dem Wert übereinstimmen, der zum Identifizieren von Verkäufern in einer ads.txt-Datei verwendet wird, sofern eine solche Datei vorhanden ist.
`sid`	String	Die ID des Verkäufer- oder Reseller-Kontos innerhalb des Werbesystems. Dieser Wert muss mit dem Wert übereinstimmen, der in Transaktionen (z.B. OpenRTB-Gebotsanfragen) im Feld verwendet wird, das von der SSP/Anzeigenplattform angegeben wird. In OpenRTB ist dies in der Regel „publisher.id“. Bei OpenDirect ist es normalerweise die Organisations-ID des Publishers. Sollte auf 64 Zeichen begrenzt sein.
`rid`	String	Die OpenRTB-RequestId der Anfrage, die von diesem Verkäufer ausgestellt wurde.
`name`	String	Der Name des Unternehmens (der juristischen Person), das für Inventar bezahlt wird, für das unter der angegebenen seller_id eine Transaktion erfolgt ist. Dieser Wert ist optional und sollte NICHT angegeben werden, wenn er in der sellers.json-Datei des Werbesystems vorhanden ist.
`domain`	String	Der Domainname des Unternehmens der Entität, die durch diesen Knoten dargestellt wird. Dieser Wert ist optional und sollte NICHT angegeben werden, wenn er in der sellers.json-Datei des Werbesystems vorhanden ist.
`hp`	Ganzzahl	Gibt an, ob dieser Knoten in den Zahlungsfluss für das Inventar einbezogen wird. `1`: Das Werbesystem im Feld „asi“ zahlt den Verkäufer im Feld „sid“, der für die Zahlung des vorherigen Knotens in der Kette verantwortlich ist. `0`: Dieser Knoten ist nicht am Zahlungsfluss für das Inventar beteiligt. Bei Version 1.0 von SupplyChain sollte diese Property immer 1 sein. Sie muss explizit enthalten sein, da davon ausgegangen wird, dass in zukünftigen Versionen der Spezifikation Knoten für die Nicht-Zahlungsabwicklung eingeführt werden. Implementierer sollten dafür sorgen, dass dieses Feld unterstützt und weitergegeben wird, wenn SupplyChain-Objekte in Gebotsanfragen erstellt werden, die an ein Downstream-Werbesystem gesendet werden.

Spezifikation für Gebotsantworten

BidResponse-Objekt

Attribut	Implementierungsdetails	Immer bestanden
id	Bei einem Parsing-Fehler kann hier „0“ anstelle der Gebotsanfrage-ID stehen.	Ja
seatbid
bidid
cur	Wenn ein Parsing-Fehler auftritt, wird dieser nicht übergeben. Bei gültigem Traffic für Gebotsanfragen wird immer „cur“ angegeben.	Ja
customdata
nbr	Wird nur angegeben, wenn ein Problem mit der Gebotsanfrage gefunden wurde. Mögliche Werte: `2`: Invalid Request (Ungültige Anfrage) `12`: Ads.txt Authorization Violation (ads.txt-Autorisierungsverstoß) `16`: Incomplete SupplyChain (Unvollständige SupplyChain) `17`: Blocked SupplyChain Node (Blockierter SupplyChain-Knoten) Hinweis:Wenn ein bestimmter Verstoß gegen (app-)ads.txt oder SupplyChain erkannt wird, wird bei einem Teil (1%) der Antworten einer der Codes 12, 16 oder 17 ausgegeben. Code 2 wird für alle anderen ungültigen Anfragen ausgegeben. Anfragen mit NBR sehen etwa so aus: { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } }
ext	Wenn ein Problem mit der Gebotsanfrage vorliegt, kann das Feld „ext“ Informationen enthalten, die bei der Diagnose des Fehlers helfen, sofern dies unterstützt wird.

Unterstützte Erweiterungen für das BidResponse-Objekt

Attribut	Implementierungsdetails
err	Eine für Menschen lesbare Beschreibung des Fehlers bei der Gebotsanfrage. Antworten können Folgendes umfassen: Der Textkörper der Gebotsanfrage war leer. Die Gebotsanfrage enthielt keine Währung, die für die jeweilige Anzeigenplattform auf der Zulassungsliste steht. Die Gebotsanfrage enthielt keinen akzeptierten MIME-Typ.
errHelp	Ein Link zu dieser Seite.

Attribut

Implementierungsdetails

err

Eine für Menschen lesbare Beschreibung des Fehlers bei der Gebotsanfrage. Antworten können Folgendes umfassen:

Der Textkörper der Gebotsanfrage war leer.
Die Gebotsanfrage enthielt keine Währung, die für die jeweilige Anzeigenplattform auf der Zulassungsliste steht.
Die Gebotsanfrage enthielt keinen akzeptierten MIME-Typ.

errHelp

Ein Link zu dieser Seite.

Seatbid-Objekt

Attribut	Unterstützt	Implementierungsdetails	Immer bestanden
Gebot			Ja
Nutzerlizenz			Ja
Gruppe

Gebotsobjekt

Attribut	Unterstützt	Implementierungsdetails	Immer bestanden
id			Ja
impid			Ja
Preis			Ja
nurl
Maser
lurl
adm
adid
adomain
Set
iurl
cid			Ja
crid			Ja
Taktik
Katze
attr
API
Protokoll
qagmediarating
Sprache
dealid
w
Std.
wratio
hratio
exp

Unterstützte Erweiterungen für das Gebotsobjekt

Attribut	Implementierungsdetails
`apis`	In DV360 wird `seatbid.bid.apis` gesendet, wenn sowohl OMID als auch MRAID unterstützt werden. In DV360 werden sowohl OMID_1 als auch MRAID als Integer-Array festgelegt.

Optionen für die Anzeigenbereitstellung

Im Abschnitt 4.3 der OpenRTB-Spezifikation gibt es zwei verschiedene Bereitstellungsoptionen:

Markup in der Gewinnbenachrichtigung
Markup im Gebot bereitgestellt

DV360 unterstützt beide Optionen.

Bei Banneranzeigen gibt DV360 immer Markup im Feld adm zurück. Das Markup, das in der Benachrichtigung über den Gewinn ausgeliefert wird, ist optional.
Bei Video-/Audioanzeigen, für die das VAST-Protokoll verwendet wird, unterstützt DV360 die Rückgabe von VAST-XML im Feld adm oder in der Antwort auf die Benachrichtigung über den Zuschlag, je nach den Anforderungen der Exchange-Partner.

In der OpenRTB-Spezifikation finden Sie die Vor- und Nachteile dieser beiden Optionen.

Best Practices

Wir empfehlen dringend, die Partner-ID von Display & Video 360 als Sitz-ID zu verwenden. Die Verwendung von börsenspezifischen Sitz-IDs wird nicht empfohlen.

Sorgen Sie dafür, dass Ihre Publisher ads.txt-Dateien oder Anwendungen mit zugehörigen app-ads.txt-Dateien haben und Sie in der Datei als autorisierter Verkäufer oder Wiederverkäufer aufgeführt sind. Weitere Informationen

Achten Sie außerdem darauf, dass in Gebotsanfragen einheitliche Informationen übergeben werden. Beispielsweise muss app.bundle mit den Informationen zum Mobilgerät und app.storeurl übereinstimmen.

Internetfähiger Fernseher

Halten Sie sich beim Übergeben von device.ifa und device.lmt an die IAB-Richtlinien für OTT-IFA. Außerdem sollten Sie device.ext.ifa_type implementieren, um die Richtlinien einzuhalten. Für alle unsere CTV-Frequency-Capping- und Zielgruppenausrichtungsfunktionen ist die Verfügbarkeit einer IFA erforderlich.

Halten Sie sich außerdem an die kürzlich veröffentlichten IAB OTT/CTV Store Assigned ID Guidelines. Darin wird definiert, wie app.bundle für CTV-Apps übergeben werden sollte. Dabei wird größtenteils die vom App-Shop definierte ID verwendet.

Active View-Messung

Active View ist eine Google-Technologie, mit der gemessen wird, ob eine Impression sichtbar war und wie lange. Active View verwendet OMID sowohl für Display- als auch für Videoanzeigen. Damit die Messung mit OMID möglich ist, müssen Exchanges die folgenden Felder in OpenRTB-Anfragen hinzufügen, damit DV360 weiß, dass der Client OMID unterstützt.

Erforderlich: Fügen Sie Gebotsanfragen ein API-Framework (Video.api=7 für OMSDK) hinzu. Das ist erforderlich, damit Active View die Messung mit OMID durchführen kann.
Empfohlen: Das Hinzufügen von omidpn und omidpv zu Source.Ext wird dringend empfohlen, da es sich auf die Art und Weise auswirkt, wie Sichtbarkeitsmessungen in DV360 für den Kunden gemeldet werden. Wenn der OMID-Partnername nicht in der Liste der IAB-Zertifizierungen aufgeführt ist, müssen wir die Sichtbarkeitsmesswerte gemäß MRC-Vorgaben separat von den MRC-zertifizierten Messwerten angeben. Weitere Informationen

FAQ

Werden benutzerdefinierte Erweiterungen für Anzeigenplattformen in DV360 unterstützt?

Ja. Zusätzlich zu den in dieser Spezifikation aufgeführten Erweiterungen unterstützt Display & Video 360 unter Umständen auch benutzerdefinierte Erweiterungen. Es wird empfohlen, die benutzerdefinierte Erweiterung während des Integrationszeitraums zu definieren und zu testen.

Werden Videoanzeigen mit Prämie in DV360 unterstützt?

Ja, senden Sie uns die Erweiterung für Videos mit Prämie.

Bei einem Großteil meines Inventars werden keine demografischen Daten angezeigt. Wie kann ich die demografische Abdeckung verbessern?

user.yob und user.gender in Gebotsanfragen an DV360 angeben, um die Abdeckung zu erhöhen.

Gibt es in DV360 Endpunkte für jede Region?

Nein, wir verwenden einen einzigen globalen Endpunkt und leiten Anfragen automatisch an das nächstgelegene Rechenzentrum weiter. Daher können wir keinen regionsspezifischen Endpunkt angeben.

Welche Anforderungen gelten für Server-zu-Server-Anfragen?

Wenden Sie sich an uns, um eine Aufnahme in unsere Zulassungsliste zu beantragen. Der User-Agent des Clients muss weitergeleitet werden und es muss dafür gesorgt werden, dass Cookies in der Antwort auf einen S2S-VAST-Abruf deaktiviert bzw. ignoriert werden.

Wird OMID in DV360 unterstützt?

Wir können die Sichtbarkeit mit OMID messen, sofern OMID zum Zeitpunkt der Gebotsanfrage als OMID-fähig deklariert wird. Details dazu finden Sie auf den Seiten 24–25.

Welche Version von Native wird unterstützt? Haben Sie bestimmte Anforderungen an Native Ads?

Wir unterstützen nur Native Ver1.2. Spezifikation für native Anzeigen

Unterstützt DV360 Gebotsanfragen, die als GZIP gesendet werden?

DV360 kann gzip-komprimierte Gebotsanfragen empfangen und mit gzip-komprimierten Antworten reagieren, wenn der Accept-Encoding-Header angibt, dass dies unterstützt wird.

Wird die DBURL in DV360 unterstützt?

Derzeit nicht.

Wird die Benachrichtigung über gewonnene und verlorene Gebote in DV360 unterstützt?

Derzeit nicht. Wenn Sie der Meinung sind, dass wir diese Funktion unterstützen sollten, wenden Sie sich bitte mit weiteren Informationen an uns.

Ist für das Targeting in DV360 der App-Name erforderlich?

Nein. In DV360 wird „App.name“ als Referenz verwendet, ist aber nicht für das Targeting erforderlich.App.bundle wird für das Targeting verwendet.

Kann DV360 mehrere Anzeigengrößen unterstützen, die in einer einzelnen Gebotsanfrage gesendet werden?

Ja, wir berücksichtigen alle zulässigen Creative-Größen in „banner.format“.

Werden in DV360 mehrere Formate in derselben Gebotsanfrage unterstützt?

Wir bieten nur eingeschränkten Support für Gebotsanfragen mit mehreren Formaten, arbeiten aber an Verbesserungen. Wir unterstützen Display- und Videoformate für Interstitials, aber derzeit keine Display- und Native-Formate. Wenn Sie Gebotsanfragen mit mehreren Formaten senden, wenden Sie sich bitte an uns, um einen Test anzufordern.

Werden in DV360 gemischte Impressionstypen in derselben Anfrage unterstützt?

Derzeit werden nur Video-/Banner-Interstitials unterstützt. Wir arbeiten an nativen Anzeigen/Bannern und Videoanzeigen/Bannern. Wenn es andere Kombinationen gibt, wenden Sie sich bitte an unser Team.

Können mehrere Seats jeweils mehrere Gebote für eine oder mehrere dieser Impressionen in derselben Anfrage senden?

Ja.

Gibt es in DV360 eine Lösung oder einen besonderen Bedarf in Bezug auf das Begrenzen oder Anzeigen desselben Werbetreibenden für mehrere solcher Impressionen in derselben Anfrage?

In DV360 wird durchgesetzt, dass ein Werbetreibender nur für eine Impression pro Anfrage bieten kann. Wir erwarten, dass SSPs Imp-Objekte sinnvoll gruppieren, z.B. alle auf derselben Seite oder alle in derselben App.

Werden in DV360 mehrere Impressionen in derselben Gebotsanfrage unterstützt?

In DV360 werden derzeit mehrere Audio-Impressionsobjekte unterstützt. Wir müssen jedoch jede Börse, die diese Funktion nutzen möchte, testen und aktivieren. Weitere Informationen finden Sie in der Spezifikation für Gebotsanfragen. Wir arbeiten daran, die Funktion auf weitere Formate auszuweiten:

{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

Kontakt

Wenn Sie Fragen oder Probleme haben, wenden Sie sich bitte an unser Supportteam für den Umtausch.