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 bei der Darstellung durch das IMA HTML5 SDK Fehler auftreten oder Creatives nicht wie erwartet funktionieren können.

Vorbereitung

Wenn Sie dieser Anleitung folgen möchten, benötigen Sie eine App mit den folgenden Eigenschaften:

  • HTML5-Videoplayer mit integriertem IMA HTML5 SDK Wenn Sie noch keine haben, lesen Sie den Abschnitt 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 sind mit den Standardeinstellungen 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.

Hinweise zur VPAID 2-Unterstützung

iFrame-Sicherheit

Standardmäßig wird im IMA SDK ein sicheres iFrame anstelle eines nutzerfreundlichen iFrames (gleiche Domain) oder eines In-Page-Scripts verwendet, um VPAID2-JavaScript-Creatives zu rendern. Wenn ein Creative also auf das DOM der übergeordneten Seite zugreifen möchte, 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 finden Sie 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.