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 wichtig für VPAID 2 JavaScript-Creative-Autoren, da Creatives bei der Darstellung durch das IMA HTML5 SDK möglicherweise Fehler ausgeben oder nicht wie erwartet funktionieren.

Vorbereitung

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

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

Hilfreiche Einführungen

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 Video-Player-Proxy-Element.
  • DISABLED – VPAID-Anzeigen werden nicht ausgeliefert. Wenn bei einer angeforderten 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 Unterstützung von VPAID 2

iFrame-Sicherheit

Standardmäßig wird im IMA SDK ein sicheres iFrame anstelle eines Friendly iFrame (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 HTML5 SDK aktiviert?
Ja, das IMA HTML5 SDK unterstützt VPAID 2-JavaScript-Creatives.