VPAID 2-JavaScript-Creatives

Das IMA HTML5 SDK unterstützt VPAID 2-JavaScript-Creatives. Die Aktivierung der Unterstützung ist einfach. Es gibt jedoch zwei Unterschiede zwischen der VPAID 2-Spezifikation und der Art und Weise, wie das IMA SDK VPAID 2 unterstützt. Diese Unterschiede wirken sich nicht auf den Code für die Player- oder SDK-Implementierung aus, sind aber für Autoren von VPAID 2-JavaScript-Creatives wichtig, da Creatives beim Rendern durch das IMA HTML5 SDK Fehler ausgeben oder nicht wie erwartet funktionieren.

Vorbereitung

  • HTML5-Videoplayer mit integriertem IMA HTML5 SDK Falls Sie noch keines haben, lesen Sie den Startleitfaden.
  • Eine VAST-Anzeigen-Tag-URL, die auf ein VPAID 2-JavaScript-Creative verweist

Hilfreiche Anleitungen

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

VPAID 2-Unterstützung aktivieren

Rufen Sie vor der Initialisierung von AdDisplayContainer die folgende Methode auf, um die JavaScript-Unterstützung für VPAID 2 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: VPAID-Anzeigen sind im unsicheren Modus zulässig. Weitere Informationen findest du unter IFrame-Sicherheit und Videoplayer-Proxy-Element.
  • DISABLED: VPAID-Anzeigen werden nicht abgespielt. Wenn eine angeforderte Anzeige ein VPAID-Creative zurückgibt, wird ein Fehler ausgegeben.
Weitere Informationen zu den VPAID-Modi finden Sie in der API-Dokumentation für ImaSdkSettings.VpaidMode.

Einschränkungen bei der VPAID 2-Unterstützung

iFrame-Sicherheit

Standardmäßig verwendet das IMA SDK zum Rendern von VPAID 2-JavaScript-Creatives einen sicheren iFrame anstelle eines nutzerfreundlichen iFrames (gleiche Domain) oder ein In-Page-Script. Wenn ein Creative also erwartet, auf das DOM der übergeordneten Seite zuzugreifen, könnte dies zu einem Fehler führen. Wenn Sie Ihre Anzeige stattdessen in einem nutzerfreundlichen iFrame rendern möchten, können Sie ImaSdkSettings.setVpaidMode(...) so verwenden: 

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

Videoplayer-Proxy-Element

Aus Sicherheitsgründen und korrekter mobiler Funktionalität stellt das IMA HTML5 SDK im ENABLED-Modus nicht das eigentliche Videoelement in der Anzeige bereit. Stattdessen bietet es ein Proxy-Element, das einen Großteil der Funktionalität des normalen Videoelements nachahmt. Bei Anzeigen-Creatives, die nur unterstützte API-Methoden aufrufen, sollte sich das Rendering der Creatives nicht ändern. Im VpaidMode.INSECURE-Modus stellt das SDK das Videoplayerelement anstelle des Proxys bereit.

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

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 derzeit VPAID 2-JavaScript-Creatives unterstützt.
Werden VPAID-Creatives im IMA HTML5 SDK dadurch aktiviert?
Ja, das IMA HTML5 SDK unterstützt VPAID 2-JavaScript-Creatives.