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 beachten.

Einige Felder werden nicht unterstützt, aber trotzdem geparst. Diese Felder müssen korrekt formatiert sein, wirken sich aber nicht auf das Gebotsergebnis aus.

Spezifikation für Gebotsanfragen

Eine Gebotsanfrage ist eine HTTP-POST-Anfrage mit dem Text 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, kann ein HTTP 200 mit einem Textkörper einer Gebotsantwort mit dem ausgefüllten Feld nbr zurückgegeben werden.

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 sein 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.

Bei Audio-Pods werden mehrere imp-Objekte 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 Erforderlich für Websiteanfragen.
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 zweithöchsten Gebot liegt.
3: Der Mindestpreis ist in der Anfrage enthalten und hat nichts mit konkurrierenden Geboten zu tun.
tmax Ganzzahl Optional, Standardwert 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äuferkonten, 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 sehr empfehlenswert. Die Standardeinstellung ist „Pro Integration“.

Die Währung in der Gebotsanfrage muss mit einer der bei der Integration registrierten Währungen übereinstimmen.

Es wird dringend empfohlen, nur eine Währung pro Börse zu unterstützen.
wlang String-Array Nicht unterstützt
bcat String-Array Blockierte Werbetreibenderkategorien mithilfe der IAB-Inhaltskategorien.
„Nicht festgelegt“ bedeutet, dass keine Kategorien blockiert sind.
badv String-Array Geben Sie den blockierten Werbetreibenden anhand der vom Werbetreibenden angegebenen Domain an.
Wenn die Richtlinie nicht festgelegt ist, sind keine Werbetreibenden blockiert.
bapp String-Array Nicht unterstützt
source Quelle Für schain teilweise erforderlich.
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“ bezieht sich auf Traffic, der von Properties weitergeleitet wird, die nicht dem Publisher gehören und für die die Zugriffe nicht vom Publisher bezahlt wurden oder auf Aktivitäten zurückzuführen sind, die auf Anreizen basieren.
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 (Zugriffsquelle des Publishers) bezeichnet und kann einen der folgenden Werte haben :
0 (Standard): Nicht definiert – Der Wert wird nicht in Gebotsanfragen gesendet. Wert kann nicht erfasst werden;
1: Gekauft: Der Nutzer wurde von Properties weitergeleitet, die nicht Ihnen gehören, 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 verwendet wird, ansonsten nicht zulässig.
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: Anstelle des JSON-Blobs wird auch ein Anzeigen-Tag bereitgestellt.

Quellobjekt

Feld Typ Details
fd Ganzzahl Einheit, 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 bevorzugt gegenüber der Angabe von schain über Gebotsanfrageerweiterungen oder Quellerweiterungen.

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 Name des OMID-Partners NICHT in der IAB-Zertifizierungsliste aufgeführt ist, müssen wir die Sichtbarkeitsmesswerte gemäß MRC-Vorgaben separat von den MRC-zertifizierten Messwerten angeben. Weitere Informationen

Feld Typ Details
omidpn String Kennung der OM SDK-Integration. Dieser Wert entspricht dem Parameter „name“ des OMID-Partnerobjekts.
omidpv String Version der OM SDK-Integration. Dieser Wert 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.
gdpr String Flag, das angibt, ob die Anfrage der DSGVO unterliegt. 0 = Nein, 1 = Ja. Wenn das Flag nicht angegeben ist, ist der Status unbekannt. Weitere Informationen finden Sie in der DV360-Dokumentation zur DSGVO. Es wird nur einer der beiden Werte regs.gdpr und regs.ext.gdpr erwartet.
us_privacy String Übermittelt Signale zum Datenschutz von Verbrauchern gemäß US-Datenschutzbestimmungen. Spezifikationen für US-Datenschutz-String Wenn wir den us_privacy-String in der Gebotsanfrage erhalten und der IAB-String angibt, dass ein Nutzer deaktiviert hat, gilt die Anfrage in Display & Video 360 als nicht für personalisierte Gebote geeignet. Wir geben das IAB-Signal nicht an andere Anbieter weiter.

Es wird nur einer der folgenden Werte erwartet: regs.us_privacy, user.us_privacy und user.ext.us_privacy.
gpp String Enthält den Einwilligungsstring des Global Privacy Protocol. In DV360 werden nur bestimmte GPP-Abschnitte akzeptiert, darunter „US National“ (USA insgesamt) und „California“ (Kalifornien). Abschnitte des IAB Europe TCF werden nicht akzeptiert. Verwenden Sie stattdessen user.consent oder user.ext.consent.
gpp_sid Ganzzahl-Array Array der Abschnitte des Global Privacy Protocol-Einwilligungsstrings, die für diese Transaktion angewendet werden sollen.
ext Regs-Erweiterungen Optional.

Objekt für Regs-Erweiterungen

Feld Typ Details
gdpr Ganzzahl Flag, das angibt, ob die Anfrage den DSGVO-Bestimmungen unterliegt, wie oben unter regs.gdpr beschrieben. Es wird nur einer der Werte regs.gdpr und regs.ext.gdpr erwartet.
us_privacy String Weitere Informationen finden Sie in der Dokumentation zu regs.us_privacy. Es wird nur einer der folgenden Werte erwartet: regs.us_privacy, regs.ext.us_privacy und user.ext.us_privacy.

Impr.-Objekt

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-Empfehlungen.
video Video Erforderlich für Videoanzeigen-Empfehlungen.
audio Audio Erforderlich für Audioanzeigen-Empfehlungen.
native Native Einbindung Für Umsatzchancen mit nativen Anzeigen erforderlich.
pmp Pmp Deals im privaten Marktplatz, 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. Empfohlen für Videos und/oder Apps.
displaymanagerver String Version des Anzeigenvermittlungspartners, 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. Empfohlen für Videos und/oder Apps.
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 geöffnet wird, wenn auf das Creative in einer App geklickt 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 Gebotsablaufdatum wird von DV 360 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 Prämie
1: Prämie

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 werbefreie Musikwiedergabe nutzen. Die Prämie wird in der Regel nach Abschluss der Videoanzeige verteilt.

Impf-Erweiterungsobjekt

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/-over/-under/-on-exit
9: Provokativ oder anzüglich
10: „Störend“, z. B. wackelig, blinkend, flackernd, extreme Animation, Smileys
11: Umfragen
12: Nur Text
13: Nutzerinteraktiv (Spiele)
14: Windows-Dialog- oder Warnungsstil
15: Mit Schaltfläche zum Ein-/Ausschalten von Audio
16: Anzeige kann übersprungen werden
17: Flash

pos Ganzzahl Die Position der Anzeige:

0 (Standard): Unbekannt
1: „above the fold“ (ohne Scrollen sichtbar)
2: Nicht unterstützt:Wahrscheinlich „below the fold“ (mit Scrollen sichtbar)
3: „below the fold“ (mit Scrollen sichtbar)
4: Header
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: Maximierbarer Vollbildmodus
api Ganzzahl-Array Unterstützte API-Frameworks

1: Links
2: Rechts
3: Oben
4: Unten
5: Maximierbarer Vollbildmodus

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 eine Endcard nach dem Video.

Objekt formatieren

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 Feld für den Placement-Typ wird als unbekanntes Placement klassifiziert. Weitere Informationen finden Sie im Artikel zum Positionstargeting.

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 das als unbekannter Placement klassifiziert.

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 das als unbekannter Placement klassifiziert.

0 (Standard): Unbekannt
1: In-Stream
2: Begleitende Inhalte
3: Interstitial
4: Keine Inhalte/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, ermöglicht die Sequenznummer die koordinierte Auslieferung von mehreren Creatives.
battr Ganzzahl-Array Gesperrte Creative-Attribute.
maxextended Ganzzahl Maximale Dauer der erweiterten Videoanzeige, wenn die Erweiterung zulässig ist.

0 (Standard): Verlängerung ist nicht zulässig
-1: 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 mit Letterboxing dargestellt 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 eine beliebige Methode verwendet werden.

0 (Standard): Unbekannt
1: Automatische Wiedergabe, Ton an
2: Automatische Wiedergabe, Ton aus
3: Wiedergabe durch Klicken
4: Mit der Maus überfahren
5: Beim Aufrufen des Viewports starten, Ton an
6: Beim Aufrufen des Viewports starten, Ton aus

Hinweis:Für alle 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: Videoabschlüsse oder vom Nutzer beendet
2: Verlässt den Darstellungsbereich oder vom Nutzer beendet
3: Beim Verlassen des Darstellungsbereichs wird das Video als schwebendes Fenster weiter wiedergegeben, bis es vollständig wiedergegeben wird oder vom Nutzer beendet wird
delivery Ganzzahl-Array Unterstützte Auslieferungsmethoden. Wenn nichts angegeben ist, wird davon ausgegangen, dass alle unterstützt werden.

1: Streaming
2: Progressiv
pos Ganzzahl Anzeigenposition auf dem Bildschirm.

0 (Standard): Unbekannt
1: „above the fold“ (ohne Scrollen sichtbar)
2: Nicht unterstützt:Wahrscheinlich „below the fold“ (mit Scrollen sichtbar)
3: „below the fold“ (mit Scrollen sichtbar)
4: Header
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 die Messung 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 Videopods 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 Prämie
1: Prämie

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 Art des Audiofeeds. Weitere Informationen finden Sie in AdCOM 1.0 unter List: Feed Types (Liste: Feedtypen).

1: Musikstreamingdienst
2: FM/AM-Broadcast (Live-Inhalte, die über Funk, aber auch über Online-Streaming verfügbar sind)
3: Podcast (Originalinhalte, die als Folgen in einer Serie verteilt werden)
4: Catch-up-Radio (aufgezeichnetes Segment einer Radiosendung, die ursprünglich live übertragen wurde)
5: Webradio (Live-Inhalte, die nur über Online-Streaming und nicht als AM/FM-Broadcast verfügbar sind)
6: Videospiel (Hintergrundaudio in Videospielen)
7: Text-to-Speech (Hörbücher, Website-Plug-in, das Artikel vorlesen kann)

stitched Ganzzahl Nicht unterstützt
nvol Ganzzahl Nicht unterstützt

Natives Objekt

Weitere Informationen finden Sie in den DV360-Spezifikationen für native 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 Auftragsobjekten Die einzubeziehenden Angebote.

Auftragsobjekt

Feld Typ Details
id String Ein PMP-Objekt darf nicht mehr als ein Deal-Objekt pro ID enthalten.
bidfloor Double 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 nicht angegeben, entspricht der Standardwert bid_request.at.

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 angegeben sind, gibt es auch keine Einschrä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 Ihre Exchange derzeit einen anderen Mechanismus verwendet, 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 Verlängerung von Angeboten Optional.

Unterstützte Erweiterung für das Deal-Objekt

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 Ihre Exchange derzeit einen anderen Mechanismus verwendet, 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

Wir empfehlen, stattdessen deal.guar 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 Referrer-URL, die die Weiterleitung zur aktuellen Seite verursacht 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 zu den Inhalten 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 Namen von Anwendungen, die auf Anfrage des Publishers aliasiert werden können.

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 Store definierte App-Kennung zu übergeben. Bitte halten Sie sich an die kürzlich veröffentlichten IAB-Richtlinien für OTT-/CTV-Store-IDs.

domain String Die Domain, z. B. mygame.foo.com
storeurl String Erforderlich für die app-ads.txt-Verifizierung 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.

App-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.

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, der mit den Inhalten in Verbindung gebracht wird.
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:
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 Altersfreigabe für Medien gemäß den [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 einbettungsfähiger 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 auf höchster 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 Daten-Erweiterungen 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 der 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 Informationen zum User-Agent
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 möglich
1: Nicht tracken

lmt Ganzzahl Das Signal „Anzeigen-Tracking einschränken“ wird kommerziell unterstützt.

0: Tracking ist uneingeschränkt möglich
1: 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 verwendet, um die Erkennung des Gerätetyps zu verbessern.
make String
model String
os String Betriebssystem des Geräts

ios: In einer App-Anfrage wird damit iOS-Traffic identifiziert.
android: Gibt ein Android-Gerät an, 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 Physische Höhe des Displays in Pixeln.
w Ganzzahl Physische Breite des Displays in Pixeln.
ppi Ganzzahl Nicht unterstützt
pxratio Double 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 offen 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 Gibt an, ob die IP-Adresse im Feld device.ip der Gebotsanfrage gekürzt wurde.

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 Geben Sie die Herkunft des Felds „device.ifa“ an, also 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 FCAP)

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 festgelegt
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 Agent bevorzugt den „Desktop“- oder „Full“-Inhalt.
1: Der Agent bevorzugt mobile Inhalte.
architecture String Gerätearchitektur, z. B. „x86“ oder „arm“.
bitness String Die Bitness 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 ein UserAgent-Objekt übergeben wird.

BrandVersion-Objekt

Feld Typ Details
brand String Marken-ID, 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 Double Nicht unterstützt
lon Double 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 der 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 Anzeigenplattform bereitgestellte Instanzen mit erweiterter ID.
ext Nutzererweiterungen Erweiterungen für das Nutzerobjekt.

Unterstützte Erweiterungen für Nutzerobjekte

Feld Typ Details
eids Array von Objekten mit erweiterter ID Von der Anzeigenplattform bereitgestellte Instanzen mit erweiterter ID.
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, in deren Nutzung die Nutzer eingewilligt haben und die nicht am TCF teilnehmen. Weitere Informationen finden Sie unter Technische Google-Spezifikation „Zusätzliche Einwilligung“.
us_privacy String Weitere Informationen finden Sie in der Dokumentation zu regs.us_privacy. Es wird nur einer der folgenden Werte erwartet: regs.us_privacy, regs.ext.us_privacy und user.ext.us_privacy.

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 ID selbst.
atype Ganzzahl Der Typ des User-Agents, der mit dieser ID verknüpft ist.

Lieferkettenobjekt

Feld Typ Details
complete Ganzzahl 0 (Standard): Die Lieferkette ist unvollständig.
1: Die Lieferkette ist bis zum Publisher vollständig.
ver String Erforderlich.
Der Wert wird im Format „major.minor“ formatiert. Version 1.0 ist beispielsweise der String „1.0“.
nodes Array mit Lieferkettenknoten-Objekten 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 Eigentümer der Website, App oder eines anderen Mediums.

In einer unvollständigen Lieferkette stellt sie den ersten bekannten Knoten dar. Der letzte Knoten steht für die Einheit, 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 denselben Wert enthalten, der in Transaktionen (z.B. OpenRTB-Gebotsanfragen) im Feld verwendet wird, das von der SSP/Anzeigenplattform angegeben wird.

In OpenRTB handelt es sich in der Regel um 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“ Transaktionen ausgeführt wurden.

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 von diesem 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 am Zahlungsfluss für das Inventar beteiligt ist.

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 in zukünftigen Versionen der Spezifikation Knoten für die Verarbeitung ohne Zahlung 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

Gebotsantwort-Objekt

Attribut Unterstützt Implementierungsdetails Immer bestanden
id Wenn ein Parsing-Fehler auftritt, kann hier „0“ anstelle der Gebotsanfrage-ID stehen. Ja
seatbid
bidid
cur Wenn ein Parsing-Fehler auftritt, wird dieser nicht übergeben. Bei gültigem Gebotsanfrage-Traffic wird „cur“ immer angegeben. Ja
customdata
nbr Dieser Wert ist nur enthalten, wenn ein Problem mit der Gebotsanfrage gefunden wurde. Mögliche Werte sind:
2: Ungültige Anfrage
12: Verstoß gegen die ads.txt-Autorisierung
16: Unvollständige SupplyChain
17: Blockierter SupplyChain-Knoten
Hinweis:Wenn ein bestimmter Verstoß gegen (app-)ads.txt oder SupplyChain erkannt wird, wird in einem Bruchteil (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 zur Fehlerbehebung enthalten, 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 Einen 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

In DV360 werden beide Optionen unterstützt.

  • Bei Banneranzeigen gibt DV360 immer Markup im Feld adm zurück. Die Markierung, die in der Benachrichtigung über den Gewinn ausgeliefert wird, ist optional.
  • Bei Video-/Audioanzeigen, für die das VAST-Protokoll verwendet wird, kann in DV360 VAST-XML im Feld adm oder in der Antwort auf die Benachrichtigung über den Zuschlag zurückgegeben werden. Das hängt von den Anforderungen der Anzeigenplattformpartner ab.

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 einer börsenspezifischen Sitzplatz-ID wird nicht empfohlen.

Achten Sie darauf, dass Ihre Publisher ads.txt-Dateien oder Anwendungen mit 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 die app.bundle mit den Informationen zum Mobilgerät und der 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 Funktionen für das Frequency Capping und das Zielgruppen-Targeting auf CTV-Geräten ist die Angabe 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 Börsen die folgenden Felder in OpenRTB-Anfragen hinzufügen, damit DV360 die OMID-Unterstützung des Clients kennt.

  • Erforderlich: Fügen Sie Gebotsanfragen ein API-Framework hinzu (Video.api=7 für Web Video OMSDK, Native.api=7 für Native App OMSDK, Banner.api=7 oder Audio.api=7). Das ist erforderlich, damit Active View die Messung mit OMID durchführen kann.
  • Empfohlen: Das Hinzufügen von omidpn und omidpv zu Source.Ext ist sehr empfehlenswert, da es sich darauf auswirkt, wie Sichtbarkeitsmessungen in DV360 für den Kunden gemeldet werden. Wenn der Name des OMID-Partners nicht in der IAB-Zertifizierungsliste aufgeführt ist, müssen wir die Sichtbarkeitsmesswerte gemäß MRC-Vorgaben separat von den MRC-zertifizierten Messwerten erfassen. Weitere Informationen
Active View-Messung für native Anzeigen

Damit Active View-Messungen für native Anzeigen möglich sind, müssen Publisher und Ad Exchanges in DV360 zusätzliche Schritte ausführen.

  • Native Displayanzeigen:In DV360 wird der Gebotsantwort unter dem Objekt adm.native Folgendes eventtrackers hinzugefügt:

    "eventtrackers": [
  {
    "event": 555,
    "method": 2,
    "url": "https://pagead2.googlesyndication.com/pagead/managed/js/activeview/current/rx_omid.js",
    "ext": {
      "vendorKey": "doubleclickbygoogle.com-omid-dsp",
      "verification_parameters": ""
    }
  }
]

    Börsen sollten zusätzliche Event-Tracker an die Publisher weitergeben und Publisher sollten so vorgehen:

    1. Installieren Sie das OMSDK.
    2. OMSDK beim Rendern nativer Anzeigen laden
    3. Führe JavaScript in eventtrackers.url mit den angegebenen Parametern aus.

  • Native Videoanzeigen:In DV360 wird die Sichtbarkeit gemessen, indem die Standarderweiterung AdVerifications in den VAST-XML-Code eingefügt wird:

    <Extension type="AdVerifications">
  <AdVerifications>
    <Verification vendor="doubleclickbygoogle.com-omid-video">
      <JavaScriptResource apiFramework="omid" browserOptional="true">
        <![CDATA[ https://www.googletagservices.com/activeview/js/current/rx_omid_video.js ]]>
      </JavaScriptResource>
      <VerificationParameters>
        <![CDATA[ {"activeview_flags":"...","activeview_metadata":"...", ...} ]]>
      </VerificationParameters>
      <TrackingEvents>
        <Tracking event="verificationNotExecuted">
          <![CDATA[ https://ade.googlesyndication.com/ddm/activity/... ]]>
        </Tracking>
      </TrackingEvents>
    </Verification>
  </AdVerifications>
</Extension>

    Publisher, die bereits die Messung der Sichtbarkeit von Videoanzeigen unterstützen, müssen nichts weiter tun. Andernfalls müssen Publisher die neue Erweiterung entweder in ihrem Videoplayer verarbeiten oder ignorieren.

EU-KI-Verordnung für native Inhalte auf Plattformen von Drittanbietern

Damit Werbetreibende neue Transparenzbestimmungen einhalten können. Gemäß den KI-Vorschriften in der Europäischen Union, in Indien und im Bundesstaat New York müssen Anzeigen mit bestimmten KI-generierten oder mit KI bearbeiteten Assets Offenlegungen enthalten, die Verbraucherinnen und Verbraucher darüber informieren, dass die Anzeigen mit KI erstellt wurden. Ab Juli 2026 können Werbetreibende in Display & Video 360 (DV360) ein Label hinzufügen, das angibt, dass das Creative mit KI generiert oder geändert wurde. So können sie die neuen Transparenzbestimmungen für KI einhalten.

Werbetreibende können diese Labels direkt ihren Creatives hinzufügen oder die Einstellung für KI-Labels über die Display & Video 360-Benutzeroberfläche und ‑API verwenden. Weitere Informationen zum Verwenden von Einstellungen für KI-Inhaltskennzeichnungen zum Kennzeichnen Ihrer Anzeigen

Bei Anzeigen, die von Google gerendert werden, wird bei unserer gewählten Compliance-Strategie ein minimales KI-Label vor dem Klick und eine Offenlegung nach dem Klick im About This Ad-Bereich (ATA) verwendet.

Bei nativen Anzeigenformaten auf 3PE hat Google keinen Einfluss auf das endgültige Rendering der Anzeige. In diesen Fällen wird dieses Attestierungssignal als Teil der Anzeigenantwort für die Exchange oder Publisher weitergegeben, damit die endgültige Anzeige einschließlich des KI-Labels oder der Offenlegung gerendert werden kann. Das Signal ist Teil des Felds adm.native.ext der Antwort für native Anzeigen. Das neue Feld adm.native.ext hat das folgende Format:

  "ext" {
     "should_disclose_ai": "true",
     "ai_disclosure_url": ""
  }
  • should_disclosure_ai (wahr oder falsch) gibt an, ob die endgültige Anzeige ein KI-Label enthalten muss.
  • Das Feld ai_disclosure_url ist möglicherweise vorhanden. Nur wenn should_disclosure_ai auf „true“ gesetzt und das URL-Feld native.privacy leer ist, ist es vorhanden. In diesem Fall sollte der Nutzer durch Klicken auf das KI-Label zur URL in diesem Feld weitergeleitet werden. Andernfalls sollte der Nutzer durch Klicken auf das KI-Label zum Standardfeld für dienative.privacy-URL weitergeleitet werden.

Diese Signale sollten an Publisher weitergegeben werden, damit sie die Anzeige mit dem KI-Label rendern können.

FAQ

Werden benutzerdefinierte Erweiterungen für Anzeigenplattformen in DV360 unterstützt?
Ja. Zusätzlich zu den in dieser Spezifikation aufgeführten Erweiterungen können in Display & Video 360 auch benutzerdefinierte Erweiterungen unterstützt werden. Dies wird jedoch jeweils im Einzelfall entschieden. Es wird empfohlen, die benutzerdefinierte Erweiterung während des Integrationszeitraums anzugeben und zu testen.
Wird in DV360 das Format „Video mit Prämie“ unterstützt?
Ja, senden Sie uns die Erweiterung für Videos mit Prämie.
Ein Großteil meines Inventars wird als „Demografische Daten unbekannt“ angezeigt. Wie kann ich die demografische Abdeckung verbessern?
Geben Sie user.yob und user.gender in Gebotsanfragen an DV360 an, um die Abdeckung zu erhöhen.
Gibt es in DV360 Endpunkte für jede Region?
Nein, wir verwenden einen einzelnen 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.
Unterstützt DV360 OMID?
Wir können die Sichtbarkeit mit OMID messen, sofern OMID in der Gebotsanfrage als aktiviert deklariert wird. Details dazu finden Sie auf Seite 24–25.
Welche Version von Native wird unterstützt? Haben Sie bestimmte Anforderungen an Native-Anzeigen?
Wir unterstützen nur Native Ver1.2. Spezifikation für native Anzeigen
Unterstützt DV360 als GZIP gesendete Gebotsanfragen?
DV360 kann gzip-komprimierte Gebotsanfragen empfangen und mit gzip-komprimierten Antworten reagieren, wenn der Accept-Encoding-Header angibt, dass dies unterstützt wird.
Unterstützt DV360 DBURL?
Im Moment nicht.
Unterstützt DV360 Benachrichtigungen über Verluste?
Ja, in DV360 wird das Feld bid.lurl in Gebotsantworten ausgefüllt. Wenn das Gebot verloren geht, kann die Exchange diese URL mit einem Grund anpingen. Dieser Grund wird Werbetreibenden angezeigt. Anhand dieser Gründe können Werbetreibende nachvollziehen, wie sie künftig Verluste vermeiden können.
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 Sitze 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 die Begrenzung oder die Anzeige desselben Werbetreibenden für mehrere solcher Impressionen in derselben Anfrage?
In DV360 wird durchgesetzt, dass ein Werbetreibender für jede Anfrage nur auf eine Impression 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 Audioobjekte für Impressionen 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 Börsen.