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 Autoren von VPAID 2 JavaScript-Creatives, da bei der Wiedergabe von Creatives durch das IMA HTML5 SDK Fehler auftreten oder sie nicht wie erwartet funktionieren können.

Vorbereitung

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

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

Hilfreiche Informationen

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

VPAID 2-Unterstützung aktivieren

Rufen Sie die folgende Methode auf, bevor Sie Ihr AdDisplayContainerinitialisieren, um die VPAID 2 JavaScript-Unterstützung 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);
...

Die verfügbaren VPAID-Modi sind:

  • ENABLED – Ermöglicht VPAID-Anzeigen mit den Standardeinstellungen.
  • INSECURE: Ermöglicht VPAID-Anzeigen im unsicheren Modus. Weitere Informationen finden Sie unter IFrame-Sicherheit und Videoplayer-Proxyelement.
  • DISABLED – VPAID-Anzeigen werden nicht wiedergegeben. Wenn eine angeforderte Anzeige ein VPAID-Creative zurückgibt, 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 verwendet das IMA SDK einen sicheren iFrame anstelle eines Friendly iFrame (gleiche Domain) oder eines In-Page-Skripts, 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);

Videoplayer-Proxyelement

Aus Sicherheitsgründen und für eine ordnungsgemäße mobile Funktion stellt das IMA HTML5 SDK im Modus ENABLED das tatsächliche Videoelement nicht für die Anzeige bereit, sondern ein Proxyelement, das einen Großteil der Funktionen des normalen Videoelements nachahmt. Bei Anzeigen-Creatives, die nur unterstützte API-Methoden aufrufen, sollten sich keine Verhaltensänderungen beim Rendern der Creatives ergeben. Im Modus VpaidMode.INSECURE stellt das SDK das Videoplayer-Element anstelle des Proxys bereit.

Die folgenden Methoden, Listener und Attribute sind für das Video-Proxyelement 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 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.