VPAID 2-JavaScript-Creatives aktivieren

Das IMA HTML5 SDK unterstützt VPAID 2-JavaScript-Creatives. Die Aktivierung der Unterstützung ist ganz 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 Player- oder SDK-Implementierungscode aus, sind aber für VPAID 2-JavaScript-Creative-Autoren wichtig, da Creatives beim Rendern durch das IMA HTML5 SDK möglicherweise Fehler ausgeben oder nicht wie erwartet funktionieren.

Vorbereitung

  • HTML5-Videoplayer mit integriertem IMA HTML5 SDK Wenn du noch keins hast, lies den Hilfeartikel IMA SDK einrichten.
  • 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 VPAID-Seite des IAB.

VPAID 2-Unterstützung aktivieren

Wenn du die JavaScript-Unterstützung für VPAID 2 aktivieren möchtest, musst du die folgende Methode aufrufen, bevor du deinen AdDisplayContainer initialisierst:

      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 wiedergegeben. Wenn für eine angeforderte Anzeige ein VPAID-Creative zurückgegeben wird, wird ein Fehler ausgegeben.
Weitere Informationen zu VPAID-Modi findest du in der API-Dokumentation für ImaSdkSettings.VpaidMode.

Einschränkungen bei der VPAID 2-Unterstützung

iFrame-Sicherheit

Standardmäßig verwendet das IMA SDK einen sicheren iFrame anstelle eines nutzerfreundlichen iFrames (gleiche Domain) oder eines In-Page-Scripts, um VPAID 2-JavaScript-Creatives zu rendern. Wenn also ein Creative auf das DOM der übergeordneten Seite zugreifen soll, 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 die ordnungsgemäße Funktion auf Mobilgeräten stellt das IMA HTML5 SDK im Modus ENABLED nicht das eigentliche Videoelement für die Anzeige bereit, sondern ein Proxy-Element, das viele Funktionen des normalen Videoelements nachahmt. Bei Creatives, bei denen nur unterstützte API-Methoden aufgerufen werden, sollte es beim Rendern der Creatives zu keinen Verhaltensänderungen kommen. Im VpaidMode.INSECURE-Modus stellt das SDK das Videoplayer-Element anstelle des Proxys bereit.

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