Seit der Einführung der Unterstützung für Videoanzeigen können Käufer Videoinventar über Authorized Buyers erwerben. In diesem Dokument werden die Integrationsanforderungen für Käufe über RTB mit dem Authorized Buyers-Protokoll beschrieben. Informationen zu den verfügbaren Protokollen finden Sie im Abschnitt Protokoll auswählen im Startleitfaden.
Käufer können Videoinventar auf verschiedenen Placements kaufen, derzeit In-Stream- und Interstitial-Anzeigen. Weitere Informationen
Anforderungen für Käufer
Neue RTB-Käufer sollten ihre Bieter mit dem neuesten Protokollpuffer und den Informationen in den folgenden Abschnitten entwickeln. Informationen zum Herunterladen des Protokolls finden Sie auf der Seite mit Referenzdaten für Echtzeitgebote. Informationen zum Entwickeln einer Gebotsfunktion finden Sie unter Anfrage verarbeiten und Antwort erstellen.
Supported macros
Folgende Makros werden in In-Stream-Video-Creatives unterstützt:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Klick-Makros wie CLICK_URL_ESC
sind nicht erforderlich, da die Klick-Tracker von Authorized Buyers in einem VAST-Wrapper enthalten sind.
Daher werden Klick-Makros für In-Stream-Videoanzeigen nicht unterstützt.
Weitere Informationen zu unterstützten Makros finden Sie unter Antwort erstellen unter Makros angeben.
Details zur Erweiterung mit Zusatzinformationen
Das Protokoll für Echtzeitgebote nutzt eine Videomitteilung, die in der Datei real-time-bidding-proto.txt definiert ist, um Videoanfragen zu identifizieren und zusätzliche videospezifische Informationen zur Anfrage bereitzustellen.
Die folgende Liste der Felder in der verschachtelten Videonachricht enthält ebenfalls detaillierte Beschreibungen und Beispiele:
description_url
-
Die URL der Seite, auf der der Videoinhalt beschrieben wird (ohne Parameter). Der Verlag oder Webpublisher sendet diese URL an Google. Beispiel:
http://www.publisher.com/watchpagelink
EndCapSupport
-
Wenn diese Option aktiviert ist, kann die Companion-Anzeige ausgewählt und als Endbanner (Infokarte) auf der Videofläche gerendert werden, nachdem die Videoanzeige fertig wiedergegeben wurde.
END_CAP_NOT_ENABLED
Die Companion-Anzeige wird nicht als Endbanner gerendert. END_CAP_OPTIONAL
Das Endbanner wird gerendert, wenn die Antwort ein geeignetes Companion-Banner enthält, das Companion-Banner ist jedoch nicht erforderlich. END_CAP_FORBIDDEN
Eine Antwort mit einer Companion-Anzeige wird herausgefiltert. END_CAP_REQUIRED
Eine Antwort ohne Companion-Anzeige wird herausgefiltert. is_embedded_offsite
-
Wenn sie auf
true
gesetzt ist, wird das Video auf Seiten außerhalb der Domain des Publishers eingebettet. is_rewarded
-
Wenn dieser Wert auf
true
gesetzt ist, erhält der Nutzer eine Prämie für das Ansehen der Videoanzeige. Typische Prämien sind beispielsweise das kostenlose Lesen eines zusätzlichen Artikels, das Gewinnen eines zusätzlichen Lebens in einem Spiel oder eine gesponserte Musiksitzung ohne Werbeunterbrechungen. max_ad_duration
-
Die maximal zulässige Dauer der zurückgegebenen Anzeige in Millisekunden. Wenn
0
festgelegt ist, gibt es keine maximale Dauer. max_ads_in_pod
- Die maximale Anzahl von Anzeigen in einem Authorized Buyers-Videopod. Ein Wert ungleich null bedeutet, dass die aktuelle Anzeigenfläche ein Videopod ist, auf dem mehrere Videoanzeigen erscheinen können. Die tatsächliche Anzahl der ausgelieferten Videoanzeigen darf kleiner oder gleich diesem Wert sein, darf diesen Wert aber nicht überschreiten.
min_ad_duration
- Die Mindestdauer der zurückzugebenden Anzeige in Millisekunden. Wenn dieser Wert nicht festgelegt ist oder einen Wert kleiner oder gleich null hat, gibt es keine Mindestdauer.
Placement
-
Beschreibt, wo das Video abgespielt wird.
UNKNOWN_PLACEMENT
Das Placement ist unbekannt oder nicht bestimmbar. INSTREAM
In-Stream bedeutet, dass die Anzeige vor, während oder nach anderen Videoinhalten wiedergegeben wird. Das ist vergleichbar mit einem herkömmlichen TV-Werbespot. Der Videocontent, den sich der Nutzer ansieht, wird nicht wiedergegeben, während die Anzeige wiedergegeben wird. INTERSTITIAL
Interstitial bedeutet, dass die Videoanzeige vor Inhalten ohne Video wiedergegeben wird, z. B. vor einem Nachrichtenartikel oder einem Videospiel. Die Anzeige nimmt die gesamte oder fast gesamte Fläche auf dem Bildschirm ein, die vom Inhalt eingenommen wird. Der Nutzer kann den Inhalt erst aufrufen, wenn die Anzeige beendet oder übersprungen wurde. IN_FEED
Das In-Feed-Videoformat ist ein Video-Creative, das eingeblendet wird, wenn der Nutzer durch einen Content-Feed scrollt, in der Regel ein Feed in einer sozialen App oder einen Nachrichtenartikel. Das Video wird im Hauptfeed und im Lese- und Sehfluss des Nutzers gerendert. Das Video wird nicht wie ein In-Banner-Video seitlich gerendert. skippable_max_ad_duration
- Die maximale Dauer der Anzeige in Millisekunden, die zurückgegeben werden sollte, wenn die Anzeige überspringbar ist. Sie unterscheidet sich in der Regel von der maximal zulässigen Dauer für nicht überspringbare Anzeigen. Wenn dieses Feld nicht festgelegt ist oder einen Wert kleiner oder gleich null hat, ist eine beliebige Dauer zulässig.
VideoPlaybackMethod
-
Beschreibt, wie die Videoanzeige wiedergegeben wird.
Als Wiedergabemethode wird Autoplay oder Click-to-Play anhand der besten verfügbaren Messung bestimmt.
AUTO_PLAY_SOUND_ON
wird die Anzeige automatisch mit Ton wiedergegeben. AUTO_PLAY_SOUND_OFF
wird die Anzeige automatisch ohne Ton wiedergegeben. CLICK_TO_PLAY
bedeutet, dass die Anzeige erst nach einem Klick wiedergegeben wird. video_ad_skippable
- Dies ist ein Wert von
SkippableBidRequestType
, der einen der folgenden Werte enthält:ALLOW_SKIPPABLE
bedeutet, dass sowohl überspringbare als auch nicht überspringbare Anzeigen zulässig sind. REQUIRE_SKIPPABLE
werden nur überspringbare Anzeigen zurückgegeben. BLOCK_SKIPPABLE
bedeutet, dass nur nicht überspringbare Anzeigen zurückgegeben werden können. Wenn dieses Feld nicht konfiguriert ist, werden standardmäßig überspringbare Anzeigen zugelassen.
videoad_start_delay
-
Die Zeit in Millisekunden vom Start des Videos bis zu der Einblendung der Anzeige. 0 bedeutet Pre-Roll und -1 Post-Roll. Alle anderen positiven Werte zeigen an, dass sich die Anzeigenfläche in der Mitte des Videos befindet.
Der Wert ist nur gültig, wenn dieser Parameter festgelegt ist. Wenn die Richtlinie nicht konfiguriert ist, ist die Anzeigeposition unbekannt.
Diese Signale gelten nicht nur für Video-Creatives, sind aber besonders nützlich für Bieter:
advertising_id
- Dieses Feld ist eine 16-Byte-UUID, die nur bei Verwendung von SSL festgelegt wird.
Dies ist die unverschlüsselte Version von
encrypted_advertising_id
. Bei iOS-Geräten enthält er den Identifier for Advertisers (IDFA). Bei Android-Geräten enthält er die Android-ID (AdID). Bei internetfähigen Fernsehern enthält es die eindeutigen IDs (z. B. RIDA von Roku). device_type
- Gibt den Gerätetyp an.
UNKNOWN_DEVICE
ist der Standardwert für dieses Feld. HIGHEND_PHONE
umfasst Mobiltelefone mit Videofunktionen. TABLET
einschließlich Tablets. PERSONAL_COMPUTER
Dazu gehören Desktop- und Laptop-Geräte. CONNECTED_TV
umfasst sowohl verbundene Fernseher (Smart-TVs) als auch verbundene Geräte (wie Roku, Apple TV usw.). GAME_CONSOLE
spezielle Gaming-Geräte gehören. brand
- Gibt die Marke des Geräts an (z. B. Nokia oder Samsung). Dieses Feld ist optional, es ist standardmäßig nicht angegeben.
model
- Gibt das genaue Modell (z. B. N70 oder Galaxy) des Geräts an. Dieses Feld ist optional, es ist standardmäßig nicht angegeben.
screen_orientation
-
Gibt die Ausrichtung des Geräts an, wenn die Anzeigenanfrage gesendet wird.
Gültige Werte sind
LANDSCAPE
,PORTRAIT
undUNKNOWN_ORIENTATION
. viewability
-
Bietet eine Schätzung der Wahrscheinlichkeit, dass dieser Slot für den Endnutzer sichtbar ist. Die Schätzung basiert darauf, wie oft er in der Vergangenheit aufgerufen wurde. Wird als Prozentsatz im Bereich von [0, 100] ausgedrückt. Der Standardwert
-1
gibt an, dass keine Verlaufsdaten für die Sichtbarkeit verfügbar sind. content_attributes.duration_seconds
-
Dauer der Videowiedergabe (z. B. 200)
Dies wird in der
ContentAttributes
-Nachricht deklariert. Hier wird der Wert verwendet, der in den vom Video-Publisher bereitgestellten Videometadaten angegeben ist.
Die Videogebotsanfrage enthält auch Informationen zum Inventar wie die Branche, zulässige Anbieter und Kanalinformationen. Alle anderen vorhandenen Felder in der Gebotsanfrage gelten auch für Videos.
Die Felder für Breite und Höhe in der Mitteilung für die Anzeigenfläche einer Videoanfrage entsprechen der Größe des Videoanzeigenplayers.
allowed_vendor_type
- Der zugelassene Anbieter. Die Datei vendors.txt in der technischen Dokumentation enthält eine Liste der IDs. Beispiel: 309 = DFA-Videoeinheit.
allowed_video_formats
-
Hier werden die zulässigen Videotechnologien für Anzeigen beschrieben, die als Antwort auf diese Anfrage ausgeliefert werden.
Die Antwort sollte mindestens eine davon unterstützen.
Die Werte für dieses wiederholte Feld stammen aus der Liste VideoFormat:
VIDEO_FLASH
Ermöglicht Videos im Flash-Video-Format (FLV). VIDEO_HTML5
Videos im HTML5-Videoformat sind zulässig. VPAID_FLASH
Damit sind Videos im Flash-Videoformat „Video Player Ad-Serving Interface Definition“ (VPAID) zulässig. VPAID_JS
Videos im VPAID JavaScript-Videoformat sind zulässig. companion_slot
-
Dieses Feld steht für eine CompanionSlot-Nachricht mit den folgenden Feldern:
height
Die verfügbaren Höhen für diese Anzeigenfläche. width
Die verfügbaren Breiten für diese Anzeigenfläche. CreativeFormat
Das Creative-Format stellt die möglichen Formate für das Creative in dieser Companion-Fläche dar. url
-
Die URL der Wiedergabeseite des Videos oder die URL der Seite, in die das Video eingebettet ist. Beispiel:
http://www.publisher.com/watchpagelink
Wenn die Gebotsfunktion auf eine Videoanfrage antwortet, sollte sie im Feld video_url
eine VAST-Weiterleitungs-URL zurückgeben.
Die Gebotsantwort muss auch die korrekte Deklaration für die Videoanzeige enthalten.
Nachfolgend finden Sie einen Auszug einer korrekten Videogebotsantwort:
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
Wichtige Felder in einer Videogebotsantwort sind:
attribute
-
Alle Attribute für die Anzeigen, die über dieses Snippet ausgeliefert werden können. Eine Liste der IDs finden Sie in der Datei
buyer-declarable-creative-attributes.txt.
Wir prüfen, ob sich keines dieser Attribute in der
excluded_attribute
-Liste der Gebotsanfrage befindet. Legen Sie dieses Feld nur fest, wenn ein HTML-Snippet oder eine Videoanzeige zurückgegeben wird. Wenn Sie dieses Feld beispielsweise auf30
setzen, bedeutet dies, dass für das Rendern der Anzeige VPAID-Unterstützung erforderlich ist. protocol
-
Beschreibt die unterstützten VAST-Versionen eines Publishers für Videoanzeigenanfragen, mit denen VAST-Anzeigen bis einschließlich der angegebenen Version ausgeliefert werden können.
Enthält ein Array mit unterstützten Videoanzeigenprotokollen.
Das entspricht dem Verhalten in OpenRTB 2.4.
Folgende Werte sind möglich:
VAST_2_0
,VAST_3_0
,VAST_2_0_WRAPPER
,VAST_3_0_WRAPPER
,VAST_4_0
undVAST_4_0_WRAPPER
. video_url
-
Die VAST-Weiterleitungs-URL der Videoanzeige. Beispiel:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
- So können Käufer Videos einschließen
- Von OpenRTB empfohlene Signale für alle Videoformate
- Authorized Buyers-Protokoll – empfohlene Signale für alle Videoformate
- Wie Publisher Videos zulassen oder nicht zulassen
- Grenzfälle
Pre-Targeting
Um Videoinventar empfangen zu können, müssen EZG-Käufer eine Pre-Targeting-Konfiguration für RTB haben, die Videoinventar enthält.
Beispiele für Gebotsanfragen und -antworten
AdX-Videoformate
So können Käufer Videos einschließen
In den folgenden Tabellen sehen Sie, wie Käufer Videos in ihre Creatives und Placements für das Web bzw. in mobile Apps einbinden können.
Web
Video-Creative | In-Stream (alle) | In-Feed/Article | Native In-Feed-/Artikel-Anzeigen | Interstitial | In-Banner |
---|---|---|---|---|---|
VPAID + VAST |
|
||||
VAST |
|
||||
MRAID und JS |
|
|
|
|
|
Benutzerdefiniertes JavaScript |
|
||||
Nativ + VAST |
|
Mobile App
Video-Creative | In-Stream (alle) | In-Feed/Article | Native In-Feed-/Artikel-Anzeigen | Interstitial | In-Banner |
---|---|---|---|---|---|
VPAID + VAST |
|
|
|
|
|
VAST |
|||||
MRAID und JS |
|||||
Benutzerdefiniertes JavaScript |
|||||
Nativ + VAST |
Schlüssel: | Format/Technologie nicht verfügbar | Das Video-Creative wird auf diesem Placement akzeptiert und unterliegt den Publisher-Blockierungen |
Video-Creative ist auf diesem Placement nicht verfügbar |
---|
Empfohlene OpenRTB-Signale
In den folgenden Tabellen sehen Sie empfohlene OpenRTB-Signale für alle Videoformate für Websites für Computer und das mobile Web und mobile Apps.
Computer und mobiles Web
Videoformat | Empfohlene Signale (nur videorelevante Signale) | Ähnliche Signale (nur videorelevante Signale) |
---|---|---|
In-Stream (VPAID) |
VIDEO-Objekt vorhanden & |
|
In-Stream (kein VPAID) |
VIDEO-Objekt vorhanden & |
|
Out-Stream |
VIDEO-Objekt vorhanden
|
|
In-Feed |
VIDEO-Objekt vorhanden & |
|
In-Article |
VIDEO-Objekt vorhanden & |
|
Nativ |
NATIVEs Objekt vorhanden und |
|
In-Banner |
Videoobjekt nicht vorhanden & |
App
Videoformat | Details der Gebotsanfrage (nur die für das Video relevanten Details) | |
---|---|---|
In-Stream |
VIDEO-Objekt vorhanden & |
|
Out-Stream |
VIDEO-Objekt vorhanden
|
|
In-Feed |
VIDEO-Objekt vorhanden & |
|
In-Article |
VIDEO-Objekt vorhanden & |
|
Nativ |
NATIVEs Objekt vorhanden und |
|
Interstitial (VAST) |
VIDEO-Objekt vorhanden & |
|
Interstitial (kein VAST) |
VIDEO-Objekt vorhanden & |
Gefiltert |
In-Banner (MRAID) |
Videoobjekt nicht vorhanden & |
|
In-Banner (kein MRAID) |
Videoobjekt nicht vorhanden & |
Empfohlene Signale für AdX-Proto
In den folgenden Tabellen sehen Sie die empfohlenen Signale für das Authorized Buyers-Protokoll für alle Videoformate für Computer und das mobile Web sowie für mobile Apps.
Websites für Computer und mobiles Web
Videoformat | Empfohlene videorelevante Signale | Für ähnliche Videos relevante Signale |
---|---|---|
In-Stream (VPAID) |
VIDEOnachricht vorhanden & |
|
In-Stream (kein VPAID) |
VIDEOnachricht vorhanden & |
Allowed_video_formats = VIDEO_HTML5 & |
In-Feed |
VIDEOnachricht vorhanden & |
Allowed_video_formats = VIDEO_HTML5 & |
In-Article |
VIDEOnachricht vorhanden & |
|
Nativ |
NATIVE Nachricht vorhanden & |
|
In-Banner |
|
|
App
In den folgenden Tabellen sehen Sie empfohlene Signale im AdX-Protokoll für alle Videoformate für Computer und das mobile Web und mobile Apps.
Videoformat | Details zu Gebotsanfragen für Videos | Videorelevante zugehörige Signale |
---|---|---|
In-Stream |
VIDEOnachricht vorhanden |
|
In-Feed |
VIDEOnachricht vorhanden & |
|
In-Article |
VIDEOnachricht vorhanden & |
|
Nativ |
NATIVE Nachricht vorhanden & |
|
Interstitial |
VIDEOnachricht vorhanden & |
|
In-Banner (MRAID) |
|
|
In-Banner (kein MRAID) |
|
|
So können Publisher Videos zulassen oder nicht zulassen
In den folgenden Tabellen sehen Sie, wie Publisher Videos in ihren Placements zulassen bzw. nicht zulassen können und wie sich dies in der Gebotsanfrage für OpenRTB und AdX Proto widerspiegelt.
OpenRTB
Pub-Option | Anwendbare Formate | In der Gebotsanfrage beschrieben als |
---|---|---|
In-Stream-Video als Einheit festlegen |
In-Stream (alle) |
Videoobjekt vorhanden und |
VPAID aktivieren |
In-Stream-Web |
Videoobjekt vorhanden & |
IBV aktivieren |
In-Banner Interstitial |
|
Out-Stream aktivieren (instructions) |
In-Feed In-Article |
Videoobjekt vorhanden & |
Out-Stream aktivieren (instructions) |
Nativ |
Natives Objekt vorhanden |
Video-Interstitial blockieren |
Interstitial-App |
VIDEO-Objekt nicht vorhanden |
AdX-Protokoll
Pub-Option | Anwendbare Formate | In der Gebotsanfrage so beschrieben (HINWEIS: ALLE Indikatoren für die Publisher-Option in der Gebotsanfrage – empfohlene Signale siehe Tabelle unten) | Standardeinstellung |
---|---|---|---|
In-Stream-Video als Einheit festlegen |
In-Stream (alle) |
Videonachricht vorhanden und |
– |
VPAID aktivieren |
In-Stream-Web |
Videonachricht vorhanden und
|
Deaktiviert |
IBV aktivieren |
In-Banner Interstitial |
|
Deaktiviert |
Out-Stream aktivieren (instructions) |
In-Feed In-Article |
Videonachricht vorhanden und |
Deaktiviert |
Out-Stream aktivieren (instructions) |
Nativ |
NATIVE Botschaft vorhanden und
|
Deaktiviert |
Video-Interstitial blockieren |
Interstitial-App |
VIDEOnachricht nicht vorhanden & |
Aktiviert |
Sonderfälle
# | Fallbeschreibung | Kommentare | Gebotsanfrage |
---|---|---|---|
1 |
Verzögertes benutzerdefiniertes Schließen mit MRAID |
Bei Interstitials kann durch das Schließen der Anzeige über MRAID eine Benachrichtigung an den Käufer gesendet werden, auch wenn er keine benutzerdefinierte Schließen-Funktion verwendet hat. Das von AdX angewendete X wird immer über einem benutzerdefinierten Schließen angezeigt, auch wenn das benutzerdefinierte Schließen nach 5 Sekunden darunter angezeigt wird |
Glossar
Weitere Informationen finden Sie im Videoglossar zu Authorized Buyers.
AdX- und OpenRTB-Felder im In-Stream- und Out-Stream-Format
AdX-Protokoll
BidRequest.Video | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
OpenRTB-Protokoll
Siehe OpenRTB 2.5 (ab Seite 47)
BidRequest.Video | |||||
---|---|---|---|---|---|
Placement
|
|
||||
linearity
|
Gibt an, ob die Impression linear, nicht linear usw. sein muss. Wenn keine angegeben sind, wird davon ausgegangen, dass alle zulässig sind.
|
||||
videoad_start_delay
|
|
Quelle für Wert der Gebotsanfrage
OpenRTB- -Objekt | Felder | AdX /Anzeigenplattform- Gebote Out-Stream |
Beispielwerte | Wer bestimmt sie? /Woher leitet dieser Wert ab? |
---|---|---|---|---|
Objekt | ||||
Video | Pantomime | Ja | ["application/javascript", "video/mp4"]", |
|
Mindestdauer | nein | Vom Publisher konfiguriert | ||
Maxduration | Ja | Vom Publisher konfiguriert | ||
wiedergabemet hod |
Ja | [6] | Normalerweise vom Publisher konfiguriert |
|
API (MRAID) | Ja | [1,2] | ||
Protokolle | Ja | [2,3,5,6,7,8] | ||
Linearität | Ja | [1] | ||
placement | Ja | [1] | ||
Playerbreite | Ja | 400,400,300 | ||
Playerhöhe | Ja | 225,300,153 | ||
Startverzögerung | Ja | 0 | Google, Standard 5 Sek. | |
überspringen | Ja | 1 | Publisher/Google – für Interstitial => Google – für In-Stream => Publisher entscheidet, ob überspringbar, nicht überspringbar oder beides zulässig ist. Anzeigen mit Prämie werden nicht übersprungen und dürfen nicht übersprungen werden. |
|
minimale Bitrate | Nein | |||
Max. Bitrate | nein | |||
pos | Ja | 1 | ||
Gerät | ||||
Px-Verhältnis | Ja | 1 | ||
Impression | ||||
Absichern | Ja | 1 | Google ist standardmäßig auf „true“ gesetzt , da das Anzeigen-Tag immer sicher ist |