Videoanzeigen

In diesem Leitfaden werden die Integrationsanforderungen, die Konfiguration und die relevanten OpenRTB-Protokollfelder beschrieben, die Sie beim Abgeben von Geboten für Videoinventar verwenden können. Das Google RTB-Protokoll wird eingestellt und wird in diesem Leitfaden nicht näher behandelt. Informationen zu Videoanzeigen im Google RTB-Protokoll finden Sie im Leitfaden zu Videoanzeigen im Google RTB-Protokoll.

Google unterstützt In-Stream-, native und Interstitial-Videoanzeigen. Weitere Informationen zu diesen Formaten finden Sie in den Leitfäden zu nativen und Interstitial-Anzeigen.

Anforderungen an Käufer

EZG-Protokoll

Dieses Handbuch bezieht sich im Allgemeinen auf das Protobuf-Format, aber Feldnamen und Pfade zwischen diesem und dem JSON-Format entsprechen, sofern nicht anders angegeben.

Das OpenRTB-Proto und die OpenRTB-Erweiterungen von Google finden Sie auf der Seite Protos und Referenzdaten. Für Weitere Informationen zum Entwickeln einer Gebotsfunktion finden Sie unter Verarbeiten Sie die Anfrage und Erstellen Sie die Antwort.

Creative-Überprüfung

Google empfiehlt, Creatives zur Freigabe einzureichen, bevor Sie mit . Sie können die Creatives-Ressource der Real-Time Bidding API verwenden, um den Überprüfungsprozess zu starten.

Pre-Targeting-Konfiguration

Damit Sie Videoinventar erhalten, muss Ihr Authorized Buyers-Konto erstelle ein Pre-Targeting-Konfiguration das Videoinventar umfasst.

Makros

Sie können Makros entweder im Video-URL-Link oder in der VAST-XML-Datei angeben, die unter BidResponse.seatbid.bid.adm Wenn Sie außerdem ein Video URL verwenden, können Sie Makros auch im verknüpften VAST-XML-Dokument platzieren. Die folgende Makros werden für Video-Creatives unterstützt:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

Klick-Makros wie CLICK_URL_ESC werden nicht unterstützt, da Authorized Buyers seine Klick-Tracker in einem VAST-Wrapper einfügt. Weitere Informationen Informationen zu unterstützten Makros finden Sie unter Makros angeben

Zusatzinformationen

Im Feld BidRequest.imp.video von OpenRTB finden Sie ob eine eingehende Gebotsanfrage für In-Stream- oder Interstitial-Videos ist und zusätzliche videospezifische Informationen zu der Anfrage finden können. Für natives Anzeigeninventar können Sie außerdem BidRequest.imp.native.{request/request_native}.assets.video für ähnliche videospezifische Informationen verwenden.

BidRequest.{app/site}.content.producer.domain

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
banner.vcm
Wenn dieser Parameter auf true gesetzt ist, kann die Companion-Anzeige für das Rendering ausgewählt werden. als Endbanner (Infokarte) auf der Videofläche nach Ende der Videoanzeige gespielt wird. Andernfalls wird die Companion-Anzeige nicht als Endbanner gerendert.
BidRequest.imp.rwdd
Wenn „true“ festgelegt ist, erhält 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 eine gesponserte Musiksitzung ohne Werbeunterbrechungen.
BidRequest.imp.video.maxduration

Die maximal zulässige Dauer der Anzeige in Sekunden, die Sie zurückgeben sollten. Wenn dieser Parameter nicht festgelegt ist, gibt es keine maximale Dauer. Wann? BidRequest.imp.video.skip ist true, das kann sich anders verhalten. Siehe Maximale Dauer des überspringbaren Videos .

BidRequest.imp.video.maxseq

Die maximale Anzahl von Anzeigen im Videopod Wenn dieser Parameter nicht festgelegt ist, ist der Anzeigenblock nicht Teil eines Video-Pods.

Die tatsächliche Anzahl der ausgelieferten Videoanzeigen kann kleiner oder gleich diesem Wert sein, darf ihn aber nicht überschreiten.

BidRequest.imp.video.minduration
Die Mindestdauer der zurückgegebenen Anzeige in Sekunden. Wann? nicht festgelegt ist, gibt es keine Mindestdauer.
BidRequest.imp.video.plcmt
Beschreibt, wo das Video abgespielt wird.
PLCMT_UNKNOWN Die Platzierung ist unbekannt oder nicht bestimmbar.
PLCMT_INSTREAM Pre-Roll-, Mid-Roll- und Post-Roll-Anzeigen, die vor, während oder nach dem Streaming von vom Nutzer angeforderten Videoinhalten wiedergegeben werden. Bei In-Stream-Videos muss der Ton beim Starten des Players standardmäßig aktiviert sein oder der Nutzer muss eindeutig seine Absicht bekunden, sich die Videoinhalte anzusehen. Auch wenn es andere Inhalte um den Player herum geben kann, muss der Videocontent der ausschlaggebende Grund für den Aufruf des Nutzers sein. Es sollte der primäre Inhalt auf der Seite bleiben und das einzige Video im sichtbaren Player, der bei der Wiedergabe mit Ton wiedergegeben werden kann. Wenn der Player in einen schwebenden/fixierten Player umgewandelt wird, sollten nachfolgende Anzeigenaufrufe die aktualisierte Playergröße korrekt übermitteln.
PLCMT_ACCOMPANYING_CONTENT Pre-Roll-, Mid-Roll- und Post-Roll-Anzeigen, die vor dem oder nach dem Streaming von Videoinhalten. Der Videoplayer wird vor, zwischen oder nach Textabsätzen oder grafischen Inhalten geladen und wiedergegeben. Die Wiedergabe beginnt erst, wenn der Videoplayer in den Darstellungsbereich gelangt. Die Wiedergabe des begleitenden Videocontent sollte erst gestartet werden, wenn der Videoplayer in den Darstellungsbereich gelangt. Während des Scrollens wird möglicherweise ein unverankerter oder fixierter Player angezeigt. die Seite verlassen.
PLCMT_INTERSTITIAL Videoanzeigen, die ohne Videocontent ausgeliefert werden. Während der Wiedergabe es muss der Schwerpunkt der Seite sein und den Großteil der des Darstellungsbereichs befinden und nicht herausgescrollt werden können. Dieser kann in wie In-App-Videos oder Diashows.
PLCMT_NO_CONTENT_STANDALONE Videoanzeigen, die ohne Streaming Videocontent wiedergegeben werden Das kann in Placements wie Bildschirmschonern, nativen Feeds, In-Content-Anzeigen oder fixierten/schwebenden Anzeigen erfolgen.
BidRequest.imp.video.playbackmethod
Beschreibt, wie die Videoanzeige wiedergegeben wird. Die Wiedergabemethode wird anhand der besten verfügbaren Messung als „Automatische Wiedergabe“ oder „Click-to-Play“ festgelegt.
AUTO_PLAY_SOUND_ON Wird beim Seitenaufbau mit eingeschaltetem Ton initiiert.
AUTO_PLAY_SOUND_OFF Wird beim Seitenaufbau mit ausgeschaltetem Ton ausgelöst.
CLICK_TO_PLAY Wird durch einen Klick gestartet, wenn der Ton aktiviert ist.
MOUSE_OVER Wird durch Mausbewegung gestartet, wenn der Ton aktiviert ist.
ENTER_SOUND_ON Initiiert beim Betreten des Darstellungsbereichs mit eingeschaltetem Ton.
ENTER_SOUND_OFF Initiiert beim Betreten des Darstellungsbereichs standardmäßig mit ausgeschaltetem Ton.
BidRequest.imp.video.skip
Wenn true festgelegt ist, lässt der Player das Video zu. übersprungen werden kann oder dass überspringbare Anzeigen zulässig sind. Andernfalls gibt es an, dass überspringbare Anzeigen nicht zulässig sind.
BidRequest.imp.video.startdelay

„0“ steht für Pre-Roll, „-1“ für Mid-Roll und „-2“ für Post-Roll.

Bei anderen positiven Werten handelt es sich um die Zeit in Sekunden vom Beginn des Videos bis zum Zeitpunkt, an dem die Anzeige eingeblendet wird.

Diese Signale gelten nicht nur für Video-Creatives, sind für Bieter jedoch besonders wertvoll:

BidRequest.device.ifa
Dieses Feld ist eine 36-stellige UUID, die nur bei Verwendung von SSL festgelegt wird und nicht gehasht wird. Es ist die unverschlüsselte Version von BidRequest.device.dpidm5. Bei iOS-Geräten enthält sie den Identifier for Advertisers (IDFA) in Großbuchstaben. Für Android Geräte, enthält er die Android-Kennung (ADID) in Kleinbuchstaben. Zeichen. Bei internetfähigen Fernsehern enthält sie ihre eindeutigen Kennzeichnungen (z. B. die RIDA von Roku).
BidRequest.device.devicetype
Gibt den Gerätetyp an.
MOBILE Ein veralteter Alias für HIGHEND_PHONE oder TABLET.
PERSONAL_COMPUTER Dazu zählen Computer und Laptops.
CONNECTED_TV umfasst sowohl internetfähige Fernseher (d. h. Smart-TVs) als auch internetfähige Geräte (z. B. Roku, Apple TV usw.).
HIGHEND_PHONE Dazu gehören auch High-End-Smartphones.
TABLET Umfasst auch Tablets.
CONNECTED_DEVICE Dazu gehören auch spezielle Gaming-Geräte.
SET_TOP_BOX Umfasst Set-Top-Box-Geräte.
OOH_DEVICE Umfasst Werbegeräte für Außenwerbung; zum Beispiel digitale Werbeflächen.
BidRequest.device.make
Die Marke des Geräts, z. B. Nokia oder Samsung,
BidRequest.device.model
Gibt das genaue Modell des Geräts an, z. B. N70 oder Galaxy, wenn verfügbar, enthält andernfalls ein generisches Modell wie "iphone" oder "ipad".
BidRequest.imp.metric
Wenn Metric.type auf completion_rate gesetzt ist, Metric.value ist ein Bruch im Bereich [0,0; 1,0]. Sie stellen die bisherige Abschlussrate für Videoanzeigen dar, die in der Anzeige ausgeliefert wurden. Slot. Der Standardwert -1.0 gibt an, dass bisherige Es sind keine Daten zur Abschlussquote verfügbar.
BidRequest.imp.video.poddur
Die Dauer der gesamten Werbeunterbrechung in Sekunden, einschließlich aller Slots, aus denen der Pod besteht. Dieser Wert wird auf den Wert festgelegt, der in den vom Videoanbieter bereitgestellten Videometadaten angegeben ist.

Die Videogebotsanfrage enthält außerdem Informationen zum Inventar, z. B. die Branche, zulässige Anbieter und Kanalinformationen. Alle anderen vorhandenen Felder in der Gebotsanfrage gelten auch für Videoanzeigen.

Die Felder für Breite und Höhe in der AdSlot-Mitteilung einer Videoanfrage mit der Größe des Videoanzeigen-Players übereinstimmt.

BidRequest.imp.ext.allowed_vendor_type
Die zulässigen Anbieter. Eine Liste der IDs findest du in der technischen Dokumentation in der Datei vendors.txt. Beispiel: 309 = DFA-Videoblock
BidRequest.imp.video.mimes
Eine Zulassungsliste mit den unterstützten Inhalts-MIME-Typen für Anzeigen, die in Antwort auf die Gebotsanfrage; Beispiel: „video/mp4“. Die Gebotsantwort muss mindestens eine der Technologien unterstützen.
BidRequest.imp.video.protocols
Beschreibt die unterstützten VAST-Versionen eines Publishers für Anfragen für Videoanzeigen. Enthält ein Array mit Protocol-Enum-Werten, darunter: VAST_2_0, VAST_3_0, VAST_2_0_WRAPPER, VAST_3_0_WRAPPER VAST_4_0, VAST_4_0_WRAPPER und mehr.
BidRequest.imp.video.companionad
Dieses Feld enthält ein Array mit Banner-Objekten, die für Companion-Anzeigen, falls verfügbar.
BidRequest.site.page

Die URL der Wiedergabeseite des Videos oder die URL der Seite, in die das Video eingebettet ist. Beispiel:

http://www.publisher.com/watchpagelink

Wenn der Bieter auf eine Videoanfrage antwortet, sollte er eine VAST-Weiterleitung zurückgeben. URL oder VAST-XML im Feld BidResponse.seatbid.bid.adm ein. Die Die Gebotsantwort muss außerdem die korrekte Deklaration für die Videoanzeige enthalten. Die Hier sehen Sie einen Auszug einer korrekten Videogebotsantwort: 

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

In Videogebotsantworten sind folgende Felder wichtig:

BidResponse.seatbid.bid.ext.attribute
Attribute für die Anzeigen, die über das Snippet ausgeliefert werden können. Die Liste der IDs finden Sie in der Datei buyer-declarable-creative-attributes.txt. Wir prüfen, ob keine dieser Attribute mit den Attributen übereinstimmt, die vom Publisher in der Gebotsanfrage abgelehnt wurden. Wenn Sie beispielsweise festlegen, dass eines der Felder 30 enthält, bedeutet das, dass für das Rendern der Anzeige VPAID-Unterstützung erforderlich ist.
BidResponse.seatbid.bid.adm

Bei Videoanzeigen ist dies 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

Alternativ kann es sich um eine VAST-XML-Datei im Rohformat handeln.

Beispiele für Gebotsanfragen und -antworten

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-/In-Article-Anzeigen Interstitial In-Banner

VPAID und VAST

 

VAST

 

MRAID und JS

 

 

 

 

 

Benutzerdefiniertes JS

 

Native Anzeigen + VAST

 

Mobile App

Video-Creative In-Stream (alle) In-Feed/Artikel Native In-Feed-/In-Article-Anzeigen 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 für dieses Placement nicht verfügbar

Empfohlene OpenRTB-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 videorelevante Signale) Ähnliche Signale (nur videorelevante Signale)

In-Stream (VPAID)

VIDEO Objekt vorhanden   &
video.placement = INSTREAM   &

In-Stream (kein VPAID)

VIDEO-Objekt vorhanden &
video.placement = INSTREAM    &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0

Videoanzeigen, die nicht In-Stream ausgeliefert werden

Objekt vom Typ VIDEO vorhanden

video.linearity: linear
placement depends on actual
placement, values as below
Video.startdelay = 0

In-Feed

VIDEO Objekt vorhanden   &
video.placement = IN-FEED

In-Article

VIDEO Objekt vorhanden   &
video.placement = IN-ARTICLE

Nativ

NATIVE object present &

In-Banner

Videoobjekt nicht vorhanden &
banner.battr ≠ 6 In-Banner-Video (automatische Wiedergabe) und
banner.battr ≠ 7 In-Banner-Video (vom Nutzer initiiert)

Mobile App

Videoformat Details zur Gebotsanfrage (nur die für das Video relevanten Details)

In-Stream

VIDEO Objekt vorhanden   &
video.placement = INSTREAM    &

video.api = 1 VPAID 1.0 oder 2: VPAID 2.0

Videoanzeigen, die nicht In-Stream ausgeliefert werden

Objekt vom Typ VIDEO vorhanden

video.linearity: linear
placement depends on actual
placement, values as below
Video.startdelay = 0

In-Feed

VIDEO Objekt vorhanden   &
video.placement = IN-FEED

In-Article

VIDEO Objekt vorhanden   &
video.placement = IN-ARTICLE

Nativ

NATIVE object present &

Interstitial (VAST)

VIDEO-Objekt vorhanden &
video.placement = INTERSTITIAL

Interstitial (kein VAST)

VIDEO Objekt vorhanden   &
video.placement = INTERSTITIAL

Gefiltert

In-Banner (MRAID)

Videoobjekt nicht vorhanden &
banner.battr ≠ 6 In-Banner-Video (automatische Wiedergabe) &
banner.battr ≠ 7 In-Banner-Video (vom Nutzer gestartet)

In-Banner

(keine MRAID)

Videoobjekt nicht vorhanden &
banner.battr ≠ 6 In-Banner-Video (automatische Wiedergabe) &
banner.battr ≠ 7 In-Banner-Video (vom Nutzer gestartet)

So erlauben oder deaktivieren Publisher Videos

In der folgenden Tabelle wird dargestellt, wie Publisher Videoanzeigen in ihren Placements zulassen oder deaktivieren können.

Pub-Option Anwendbare Formate In der Gebotsanfrage wird Folgendes angegeben:

In-Stream-Video-Einheit angeben

In-Stream (alle)

Videoobjekt vorhanden &
video.placement = INSTREAM

VPAID aktivieren

In-Stream-Videos im Web

Videoobjekt vorhanden und
video.api = 1 (VPAID 1.0) oder 2 (VPAID 2.0)

IBV aktivieren

In-Banner

Interstitial

banner.battr ≠ 6 In-Banner-Video (automatische Wiedergabe) und/oder 7 In-Banner-Video (vom Nutzer initiiert)

Aktivieren Sie (Anleitung).

In-Feed

In-Article

Videoobjekt vorhanden &
video.placement = IN-FEED oder IN-ARTICLE

Anzeigen für Videoanzeigen aktivieren, die nicht In-Stream ausgeliefert werden (Anleitung)

Nativ

Natives Objekt vorhanden

Video-Interstitial blockieren

Interstitial in Apps

Objekt "VIDEO" nicht vorhanden

Sonderfälle

# Fallbeschreibung Kommentare Gebotsanfrage

1

Verzögerte benutzerdefinierte Schließung mit MRAID

Beim Schließen von Interstitials kann über MRAID eine Benachrichtigung an den Käufer gesendet werden, auch wenn er keinen benutzerdefinierten Abschluss verwendet hat.


Das von Authorized Buyers angewendete X wird immer vor allen benutzerdefinierte Schließfunktion, auch wenn sie nach 5 Sekunden darunter angezeigt wird.

Glossar

Weitere Informationen finden Sie im Glossar für Authorized Buyers-Videos.

Relevante Felder für In-Stream- und andere Formate

Weitere Informationen finden Sie unter OpenRTB 2.5 (ab Seite 47).

BidRequest.Video enthalten ist.
Placement
In-Stream mWeb

1: In-Stream
2: In-Banner

mApp

1: In-Stream
2: In-Banner
Videoanzeigen, die nicht In-Stream ausgeliefert werden mApp Interstitial

5: Interstitial

Native

3: In-Article
4: In-Feed

Rewarded

is_rewarded_inventory: OpenRTB-Erweiterung (bool)
linearity

Gibt an, ob die Impression linear, nicht linear usw. sein muss. Ist keine Angabe vorhanden, sind alle zulässig.

In-Stream mWeb

1: LINEAR (In-Stream)

mApp

1: LINEAR (In-Stream)
Videoanzeigen, die nicht In-Stream ausgeliefert werden mApp Interstitial

2: INTERSTITIAL

Native

3: IN_FEED
5: IN_ARTICLE
videoad_start_delay
In-Stream mWeb

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL
Videoanzeigen, die nicht In-Stream ausgeliefert werden Rewarded

>0: start delay in seconds
 0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

Quelle des Werts der Gebotsanfrage

OpenRTB
Objekt		 Felder Authorized Buyers 
/Anzeigenplattform
Bidding
Nicht In-Stream		 Beispielwerte Wer bestimmt das?
/Wo dieser Wert aus
stammt von?
Object
Video Pantomime Ja ["application/javascript",
"video/mp4"]",		 Google
Mindestdauer Nein Vom Publisher konfiguriert
Höchstdauer Ja Vom Publisher konfiguriert
playbackmet
hod		 Ja [6] Normalerweise vom Publisher
Konfiguriert
API (MRAID) Ja [1,2] Google
Protokolle Ja [2,3,5,6,7,8] Google
Linearität Ja [1] Google
placement Ja [1] Google
Playerbreite Ja 400.400.300 Google
Player-Höhe Ja 225.300.153 Google
start delay Ja 0 Google, Standardeinstellung 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 Google
max bitrate Nein Google
pos Ja 1 Google
Gerät
Px-Verhältnis Ja 1 Google
Impression
Sicher Ja 1 Google
Standardwert ist „wahr“
da "adtag" immer
ist sicher