Mit der Einführung der Unterstützung für Videoanzeigen können Käufer Videoinventar über Authorized Buyers kaufen. In diesem Dokument werden die Integrationsanforderungen für Käufe über RTB beschrieben. mit dem Authorized Buyers-Protokoll. Informationen zu den verfügbaren Protokollen finden Sie in der Protokoll auswählen im Startleitfaden.
Käufer können Videoinventar auf verschiedenen Placements kaufen, In-Stream- und Interstitial-Anzeigen. Weitere Informationen finden Sie unter . Interstitial-Anzeigen.
Anforderungen an Käufer
Neue RTB-Käufer sollten ihre Gebotsfunktionen mit dem neuesten Protokollzwischenspeicher entwickeln. und die Informationen in den folgenden Abschnitten. Sie können das Protokoll auf der Seite mit den Referenzdaten für Echtzeitgebote herunterladen. Informationen zum Entwickeln einer Gebotsfunktion Siehe Anfrage bearbeiten und Antwort erstellen.
Unterstützte Makros
Folgende Makros werden für In-Stream-Video-Creatives unterstützt:
%%CACHEBUSTER%%
%%WINNING_PRICE%%
%%SITE%%
Klick-Makros (z. B. 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
Siehe Makros angeben
unter Antwort erstellen.
Details zu Zusatzinformationen
Das Protokoll für Echtzeitgebote verwendet eine Videonachricht, die in den <ph type="x-smartling-placeholder"></ph> real-time-bidding-proto.txt-Datei zur Identifizierung von Videoanfragen und zusätzliche videospezifische Informationen über die Anfrage angeben.
Die folgende Liste der Felder in der verschachtelten Videonachricht enthält außerdem detaillierte Beschreibungen und Beispiele:
description_url
-
Die URL ohne Parameter der Seite ein, auf der der Videoinhalt beschrieben wird. 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
wird als Endbanner (Infokarte) in der Videofläche gerendert.
wenn die Videoanzeige fertig wiedergegeben wurde.
END_CAP_NOT_ENABLED
Companion-Anzeige wird nicht als Endbanner gerendert. END_CAP_OPTIONAL
Endbanner wird gerendert, wenn die Antwort einen zulässigen Companion-Banner, aber das Companion-Banner ist 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 es auf
true
gesetzt ist, das Video auf Seiten außerhalb der Domain des Publishers eingebettet ist. is_rewarded
-
Wenn dieser Wert auf
true
gesetzt ist, bedeutet das, dass der Nutzer eine Prämie für das Ansehen der Videoanzeige. Übliche Belohnungen sind das Lesen eines Artikel kostenlos erhalten, ein zusätzliches Leben in einem Spiel erhalten Musik ohne Werbeanzeigen. 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 gibt an, dass die aktuelle Anzeigenfläche ein Videopod ist. die mehrere Videoanzeigen schalten können. Die tatsächliche Anzahl der geschalteten Videoanzeigen kann ist kleiner oder gleich diesem Wert, darf ihn aber nicht überschreiten.
min_ad_duration
- Die Mindestdauer der zurückgegebenen Anzeige in Millisekunden. Wenn dieses Feld nicht festgelegt ist oder kleiner oder gleich null ist, gibt es keine Mindestdauer.
Placement
-
Beschreibt, wo das Video abgespielt wird.
UNKNOWN_PLACEMENT
Die Platzierung ist unbekannt oder nicht bestimmbar. INSTREAM
In-Stream bedeutet, dass die Anzeige vor, während oder nach anderen Videoinhalte. Dies ist mit einem herkömmlichen TV-Werbespot vergleichbar. Der Videoinhalt, den sich der Nutzer ansieht, wird nicht abgespielt, während die Anzeige wiedergegeben wird. INTERSTITIAL
Interstitial bedeutet, dass die Videoanzeige vor Inhalte, die keine Videos sind, z. B. ein Nachrichtenartikel oder ein Videospiel. Die Anzeige nimmt den gesamten Bildschirm oder fast den gesamten Bildschirm ein. von den Inhalten belegt ist und der Nutzer nicht fortfahren kann. bis die Anzeige beendet oder übersprungen wird. IN_FEED
Das In-Feed-Videoformat ist ein Video-Creative, das ausgeliefert wird, das Scrollen durch einen Content-Feed, in der Regel ein Feed in sozialen Apps, Nachrichtenartikels usw. werden. Das Video wird im Hauptfeed und im Seh- und Lesefluss. Das Video wird nicht wie seitlich In-Banner-Video. skippable_max_ad_duration
- Die maximale Dauer der Anzeige in Millisekunden die zurückgegeben werden soll, wenn diese Anzeige überspringbar ist. Dies unterscheidet sich im Allgemeinen von der maximalen Dauer nicht überspringbare Anzeigen zulässig. Wenn dieses Feld nicht festgelegt ist oder einen Wert kleiner oder gleich null hat, Beliebige Dauer ist zulässig.
VideoPlaybackMethod
-
Beschreibt, wie die Videoanzeige wiedergegeben wird.
Als Wiedergabemethode wird Autoplay oder Click-to-Play festgelegt
basierend auf der besten verfügbaren Messung.
AUTO_PLAY_SOUND_ON
wird die Anzeige automatisch mit eingeschaltetem Ton abgespielt. AUTO_PLAY_SOUND_OFF
wird die Anzeige automatisch ohne Ton abgespielt. CLICK_TO_PLAY
wird die Anzeige erst wiedergegeben, wenn der Nutzer darauf klickt. 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
bedeutet, dass nur überspringbare Anzeigen zurückgegeben werden können. BLOCK_SKIPPABLE
bedeutet, dass nur nicht überspringbare Anzeigen zurückgegeben werden können. Wenn dieses Feld nicht konfiguriert ist, werden überspringbare Anzeigen standardmäßig zugelassen.
videoad_start_delay
-
Die Zeit in Millisekunden ab Beginn des Videos bis die Anzeige erscheint. 0 bedeutet Pre-Roll und -1 Post-Roll. Alle anderen positiven Werte geben die Anzeigenfläche an befindet sich in der Mitte des Videos.
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, aber für Bieter besonders nützlich:
advertising_id
- Dieses Feld ist eine 16-Byte-UUID, die nur bei Verwendung von SSL festgelegt wird.
Es ist die unverschlüsselte Version von
encrypted_advertising_id
. Bei iOS-Geräten enthält sie den Identifier for Advertisers (IDFA). Bei Android-Geräten enthält sie die Android-Kennung (ADID). Bei internetfähigen Fernsehern enthält er 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 Videofunktion. TABLET
einschließlich Tablets. PERSONAL_COMPUTER
umfasst Desktop-Computer und Laptops. CONNECTED_TV
umfasst beide internetfähige Fernseher (Smart-TVs) und verbundene Geräte wie Roku oder Apple TV. GAME_CONSOLE
Dazu gehören spezielle Gaming-Geräte. brand
- Die Marke des Geräts, z. B. Nokia oder Samsung, Dieses Feld ist optional. ist standardmäßig nicht angegeben.
model
- Gibt das genaue Modell des Geräts an, z. B. N70 oder Galaxy. Dieses Feld ist optional. ist standardmäßig nicht angegeben.
screen_orientation
-
Legt die Ausrichtung des Geräts fest, wenn die Anzeigenanfrage gesendet wird.
Gültige Werte sind
LANDSCAPE
,PORTRAIT
, undUNKNOWN_ORIENTATION
. viewability
-
Er gibt eine Schätzung der Wahrscheinlichkeit an,
für den Endnutzer sichtbar sind, je nachdem,
in der Vergangenheit sichtbar war. Ausgedrückt als Prozentsatz in
den Bereich [0, 100]. Der Standardwert
-1
bedeutet, dass keine Verlaufsdaten für die Sichtbarkeit verfügbar sind. content_attributes.duration_seconds
-
Die Dauer der Videowiedergabe (z. B. 200)
Dies wird in der
ContentAttributes
-Nachricht deklariert. Wird auf den Wert festgelegt, der in den Videometadaten angegeben ist vom Video-Publisher bereitgestellt.
Die Videogebotsanfrage enthält auch Informationen zum Inventar. etwa die Branche, zulässige Anbieter und Kanalinformationen. Alle vorhandenen Felder in der Gebotsanfrage werden auch auf Videos angewendet.
Die Felder für Breite und Höhe in der AdSlot-Mitteilung einer Videoanfrage der Größe des Videoanzeigen-Players entsprechen.
allowed_vendor_type
- Der zulässige Anbieter. Weitere Informationen finden Sie in der vendors.txt finden Sie in der technischen Dokumentation eine Liste von IDs. Beispiel: 309 = DFA-Videoeinheit.
allowed_video_formats
-
Beschreibt die zulässigen Videotechnologien
für Anzeigen, die aufgrund dieser Anfrage ausgeliefert wurden.
Die Antwort sollte mindestens eine von ihnen unterstützen.
Die Werte dieses wiederholten Felds stammen aus der Aufzählung VideoFormat:
VIDEO_FLASH
Videos im Flash Video-Format (FLV) sind zulässig. VIDEO_HTML5
Videos im HTML5-Videoformat sind zulässig. VPAID_FLASH
Lässt Videos zu, für die die Anzeigenbereitstellung des Videoplayers verwendet wird VPAID-Videoformat (Interface Definition) VPAID_JS
Videos mit der VPAID-JavaScript-Videoformat. companion_slot
-
Dieses Feld steht für eine CompanionSlot-Mitteilung.
enthält die folgenden Felder:
height
Die verfügbaren Höhen für diesen Slot. width
Die verfügbaren Breiten für diese Anzeigenfläche. CreativeFormat
Das Creative-Format stellt die möglichen Formate dar. für das Creative in dieser Companion-Fläche. url
-
Die URL der Wiedergabeseite des Videos oder die URL der Seite in die das Video eingebettet wurde. Beispiel:
http://www.publisher.com/watchpagelink
Wenn Sie auf eine Videoanfrage antworten,
muss der Bieter
eine VAST-Weiterleitungs-URL
im Feld video_url
ein.
Die Gebotsantwort sollte außerdem
die korrekte Deklaration für die Videoanzeige angeben.
Hier sehen 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" }
In Videogebotsantworten sind folgende Felder wichtig:
attribute
-
Alle Attribute für die Anzeigen, die über dieses Snippet ausgeliefert werden können. Weitere Informationen finden Sie in der
<ph type="x-smartling-placeholder"></ph>
"buyer-declarable-creative-attributes.txt" für die Liste der IDs.
Wir prüfen, ob sich keines dieser Attribute im
excluded_attribute
der Gebotsanfrage. Legen Sie dieses Feld nur fest, wenn ein HTML-Snippet oder eine Videoanzeige zurückgegeben wird. Wenn Sie dieses Feld beispielsweise auf30
festlegen, Zum Rendern der Anzeige ist VPAID-Unterstützung erforderlich. protocol
-
Hier werden die vom Publisher unterstützten VAST-Versionen für Anfragen für Videoanzeigen beschrieben.
VAST-Anzeigen bis einschließlich der angegebenen Version zulässig sind.
Enthält ein Array der unterstützten Protokolle für Videoanzeigen.
Dies entspricht dem Verhalten in OpenRTB 2.4 und stimmt überein mit diesem.
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. Hier einige Beispiele:
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 einbinden
- Empfohlene OpenRTB-Signale für alle Videoformate
- Im 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 über eine Pre-Targeting-Konfiguration für RTB, die Videoinventar umfasst.
Beispiele für Gebotsanfragen und -antworten
AdX-Videoformate
So können Käufer Videos einfügen
In den folgenden Tabellen sehen Sie, wie Käufer Videos in ihre Creatives einbinden und Placements, in denen sie im Web bzw. in mobilen Apps ausgeliefert werden können.
Web
Video-Creative | In-Stream (alle) | In-Feed/Artikel | Native In-Feed-Anzeigen/Artikel | Interstitial | In-Banner |
---|---|---|---|---|---|
VPAID und VAST |
|
||||
VAST |
|
||||
MRAID und JS |
|
|
|
|
|
Benutzerdefiniertes JS |
|
||||
Nativ und VAST |
|
Mobile App
Video-Creative | In-Stream (alle) | In-Feed/Artikel | Native In-Feed-Anzeigen/Artikel | Interstitial | In-Banner |
---|---|---|---|---|---|
VPAID und VAST |
|
|
|
|
|
VAST |
|||||
MRAID und JS |
|||||
Benutzerdefiniertes JS |
|||||
Nativ und VAST |
Schlüssel: | Format/Technologie nicht verfügbar | Das Video-Creative ist in diesem Placement zulässig und unterliegt Einschränkungen durch den Publisher |
Video-Creative ist für dieses Placement nicht verfügbar |
---|
Für OpenRTB empfohlene Signale
In den folgenden Tabellen sehen Sie die von OpenRTB empfohlenen Signale für alle Videoformate Desktop- und im mobilen Web und in mobilen Apps.
Computer und mobiles Web
Videoformat | Empfohlene Signale (nur für Videos relevante Signale) | Ähnliche Signale (nur für Videos relevante Signale) |
---|---|---|
In-Stream (VPAID) |
VIDEO Objekt vorhanden & |
|
In-Stream (kein VPAID) |
VIDEO Objekt vorhanden & |
|
Out-Stream |
Objekt vom Typ VIDEO vorhanden
|
|
In-Feed |
VIDEO Objekt vorhanden & |
|
In-Article |
VIDEO Objekt vorhanden & |
|
Nativ |
NATIVES Objekt vorhanden und |
|
In-Banner |
Videoobjekt nicht vorhanden & |
Mobile App
Videoformat | Details zur Gebotsanfrage (nur die für das Video relevanten Details) | |
---|---|---|
In-Stream |
VIDEO Objekt vorhanden & |
|
Out-Stream |
Objekt vom Typ VIDEO 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 (keine MRAID) |
Videoobjekt nicht vorhanden & |
Empfohlene Signale für das AdX-Protokoll
In den folgenden Tabellen sehen Sie für das Proto-Protokoll von Authorized Buyers empfohlene Signale für alle Videoformate für Websites für Computer und im mobilen Web sowie in mobilen Apps.
Websites für Computer und das mobile Web
Videoformat | Empfohlene videorelevante Signale | Ähnliche videorelevante Signale |
---|---|---|
In-Stream (VPAID) |
VIDEO-Nachricht vorhanden & |
|
In-Stream (kein VPAID) |
VIDEO-Nachricht vorhanden & |
Allowed_video_formats = VIDEO_HTML5 & |
In-Feed |
VIDEO-Nachricht vorhanden & |
Allowed_video_formats = VIDEO_HTML5 & |
In-Article |
VIDEO-Nachricht vorhanden & |
|
Nativ |
NATIVE Nachricht vorhanden & |
|
In-Banner |
|
|
Mobile App
In den folgenden Tabellen sehen Sie, welche Signale für AdX-Proto für alle Videoformate Websites für Computer und im mobilen Web sowie in mobilen Apps.
Videoformat | Details zu Gebotsanfragen für Videos | Für Videos relevante Signale |
---|---|---|
In-Stream |
VIDEO Nachricht vorhanden |
|
In-Feed |
VIDEO-Nachricht vorhanden & |
|
In-Article |
VIDEO-Nachricht vorhanden & |
|
Nativ |
NATIVE Nachricht vorhanden & |
|
Interstitial |
VIDEO-Nachricht vorhanden & |
|
In-Banner (MRAID) |
|
|
In-Banner (keine MRAID) |
|
|
So können Publisher Videos zulassen/nicht zulassen
In den folgenden Tabellen sehen Sie, wie Publisher Videos in ihren Placements und deren Darstellung in der Gebotsanfrage für OpenRTB und AdX Proto
OpenRTB
Pub-Option | Anwendbare Formate | In der Gebotsanfrage beschrieben als |
---|---|---|
In-Stream-Video-Einheit angeben |
In-Stream (alle) |
Videoobjekt vorhanden & |
VPAID aktivieren |
In-Stream (Web) |
Videoobjekt vorhanden & |
IBV aktivieren |
In-Banner Interstitial |
|
Out-Stream aktivieren (Anleitung) |
In-Feed In-Article |
Videoobjekt vorhanden & |
Out-Stream aktivieren (Anleitung) |
Nativ |
Natives Objekt vorhanden |
Video-Interstitial blockieren |
Interstitial-App |
Objekt "VIDEO" nicht vorhanden |
AdX-Protokoll
Pub-Option | Anwendbare Formate | Wird in der Gebotsanfrage wie folgt beschrieben (HINWEIS: Das sind ALLE Indikatoren für die Option „Publisher“ im Gebotsanfrage – empfohlene Signale siehe Tabelle unten) | Standardeinstellung |
---|---|---|---|
In-Stream-Video-Einheit angeben |
In-Stream (alle) |
Videonachricht vorhanden und |
– |
VPAID aktivieren |
In-Stream (Web) |
Videonachricht vorhanden und
|
Deaktiviert |
IBV aktivieren |
In-Banner Interstitial |
|
Deaktiviert |
Out-Stream aktivieren (Anleitung) |
In-Feed In-Article |
Videonachricht vorhanden und |
Deaktiviert |
Out-Stream aktivieren (Anleitung) |
Nativ |
NATIVE Nachricht vorhanden und
|
Deaktiviert |
Video-Interstitial blockieren |
Interstitial-App |
VIDEO-Nachricht 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 eine Benachrichtigung mit MRAID, auch ohne benutzerdefiniertes Schließen. Das von AdX angewendete X wird immer über jedem benutzerdefinierten Schließen angezeigt, auch wenn der benutzerdefinierte Abschluss erscheint nach 5 Sekunden darunter. |
Glossar
Weitere Informationen finden Sie unter . Glossar für Authorized Buyers-Videos
AdX- und OpenRTB-Felder in In-Stream- und Out-Stream-Formaten
AdX-Protokoll
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement
|
|
||||
videoad_start_delay
|
|
OpenRTB-Protokoll
Weitere Informationen finden Sie unter . 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 des Werts der Gebotsanfrage
OpenRTB Objekt | Felder | AdX /Anzeigenplattform Gebote: Out-Stream |
Beispielwerte | Wer entscheidet darüber? /Wo dieser Wert aus stammt von? |
---|---|---|---|---|
Object | ||||
Video | Pantomime | Ja | ["application/javascript", "video/mp4"]", |
|
Mindestdauer | Nein | Vom Publisher konfiguriert | ||
Höchstdauer | Ja | Vom Publisher konfiguriert | ||
Wiedergabemet. Hod |
Ja | [6] | In der Regel 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 | ||
Player-Höhe | Ja | 225.300.153 | ||
Startverzögerung | Ja | 0 | Google, Standard 5 Sek. | |
Überspringen | Ja | 1 | Publisher/Google - für Interstitial => Google - für Instream => Publisher entscheidet, ob überspringbar, nicht überspringbar oder beides. Anzeigen mit Prämie, immer nicht überspringbar |
|
Minimale Bitrate | Nein | |||
Max. Bitrate | Nein | |||
pos | Ja | 1 | ||
Gerät | ||||
Px-Verhältnis | Ja | 1 | ||
Impression | ||||
Sicher | Ja | 1 | Google Standardwert ist „wahr“ da "adtag" immer ist sicher |