VPAID 2-JavaScript-Creatives aktivieren

Das IMA HTML5 SDK unterstützt VPAID 2-JavaScript-Creatives. Wenn Sie die Unterstützung aktivieren, gibt es zwei Hauptunterschiede zwischen der VPAID 2-Spezifikation und der Art und Weise, wie das IMA SDK VPAID 2 unterstützt. Diese Unterschiede haben keine Auswirkungen auf den Player- oder SDK-Implementierungscode, sind aber für VPAID 2-JavaScript-Creative-Autoren wichtig, da bei der Darstellung von Creatives durch das IMA SDK für HTML5 Fehler auftreten oder sie nicht wie erwartet funktionieren können.

Vorbereitung

Für diese Anleitung benötigen Sie eine App mit folgenden Eigenschaften:

  • HTML5-Videoplayer mit integriertem IMA HTML5 SDK. Wenn Sie noch keines haben, richten Sie das IMA SDK ein.
  • Eine VAST-Anzeigen-Tag-URL, die auf ein VPAID 2-JavaScript-Creative verweist.

Hilfreiche Einführungen

  • Wenn Sie mit VPAID 2 nicht vertraut sind, finden Sie weitere Informationen auf der IAB-VPAID-Seite.

VPAID 2-Unterstützung aktivieren

Rufen Sie die folgende Methode auf, bevor Sie Ihren AdDisplayContainer initialisieren, um die Unterstützung von VPAID 2-JavaScript zu aktivieren:

google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);
...
var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
var adsLoader = new google.ima.AdsLoader(adDisplayContainer);
...

Folgende VPAID-Modi sind verfügbar:

  • ENABLED – VPAID-Anzeigen mit den Standardeinstellungen sind zulässig.
  • INSECURE – Ermöglicht VPAID-Anzeigen im unsicheren Modus. Weitere Informationen finden Sie unter iFrame-Sicherheit und Proxy-Element für Videoplayer.
  • DISABLED – VPAID-Anzeigen werden nicht ausgeliefert. Wenn für eine angeforderte Anzeige ein VPAID-Creative zurückgegeben wird, wird ein Fehler ausgegeben.

Weitere Informationen zu VPAID-Modi finden Sie in der API-Dokumentation für ImaSdkSettings.VpaidMode.

Einschränkungen bei der VPAID 2-Unterstützung

iFrame-Sicherheit

Standardmäßig wird im IMA SDK ein sicheres iFrame anstelle eines Friendly iFrames (gleiche Domain) oder eines In-Page-Scripts verwendet, um VPAID 2-JavaScript-Creatives zu rendern. Wenn ein Creative also auf das DOM der übergeordneten Seite zugreifen muss, kann dies zu einem Fehler führen. Wenn Sie Ihre Anzeige stattdessen in einem Friendly iFrame rendern möchten, können Sie ImaSdkSettings.setVpaidMode(...) so verwenden:

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

Proxy-Element für Videoplayer

Aus Sicherheitsgründen und für eine ordnungsgemäße mobile Funktionalität wird im ENABLED-Modus nicht das tatsächliche Videoelement an die Anzeige übergeben, sondern ein Proxy-Element, das einen Großteil der Funktionen des normalen Videoelements nachahmt. Bei Anzeigen-Creatives, die nur unterstützte API-Methoden aufrufen, sollte es keine Verhaltensänderungen beim Rendern der Creatives geben. Im Modus VpaidMode.INSECURE stellt das SDK das Videoplayer-Element anstelle des Proxys bereit.

Hier sind die Methoden, Listener und Attribute, die für das Video-Proxy-Element verfügbar sind:

Methoden

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

Ereignistypen für addEventListener

  • abort
  • canplay
  • canplaythrough
  • click
  • durationchange
  • emptied
  • ended
  • error
  • loadeddata
  • loadedmetadata
  • loadstart
  • pause
  • play
  • playing
  • progress
  • ratechange
  • suspend
  • seeked
  • seeking
  • timeupdate
  • waiting

Attribute

  • currentTime
  • duration
  • ended
  • paused
  • playbackRate
  • src
  • type

FAQ

Werden VPAID 2-JavaScript-Creatives in den iOS- oder Android-SDKs unterstützt?
Das IMA HTML5 SDK ist die einzige IMA SDK-Plattform, die VPAID 2-JavaScript-Creatives unterstützt.
Werden dadurch VPAID-Creatives im IMA SDK für HTML5 aktiviert?
Ja, das IMA HTML5 SDK unterstützt VPAID 2-JavaScript-Creatives.