VPAID 2-JavaScript-Creatives

Das IMA HTML5 SDK unterstützt VPAID 2-JavaScript-Creatives. Das Aktivieren der Unterstützung ist einfach. Es gibt jedoch zwei Unterschiede zwischen den VPAID 2-Spezifikationen und der Art und Weise, wie das IMA SDK VPAID 2 unterstützt. Diese Unterschiede haben keine Auswirkungen auf den Code für die Player- oder SDK-Implementierung, sind aber wichtig für Autoren von JavaScript-Creatives mit VPAID 2, da Creatives Fehler ausgeben können oder nicht wie erwartet funktionieren, wenn sie vom IMA HTML5 SDK gerendert werden.

Voraussetzungen

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

Hilfreiche Primer

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

Unterstützung von VPAID 2 aktivieren

Um die JavaScript-Unterstützung für VPAID 2 zu aktivieren, rufen Sie die folgende Methode auf, bevor Sie den AdDisplayContainer initialisieren:

      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: Ermöglicht VPAID-Anzeigen mit den Standardeinstellungen.
  • INSECURE: Ermöglicht VPAID-Anzeigen im unsicheren Modus. Weitere Informationen finden Sie unter iFrame-Sicherheit und Videoplayer-Proxy-Element.
  • DISABLED: VPAID-Anzeigen werden nicht wiedergegeben. Wenn für eine angeforderte Anzeige ein VPAID-Creative zurückgegeben wird, erscheint ein Fehler.
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 verwendet das IMA SDK zum Rendern von VPAID 2-JavaScript-Creatives einen sicheren iFrame statt eines nutzerfreundlichen iFrames (in derselben Domain) oder ein In-Page-Script. Wenn für ein Creative also erwartet wird, dass es auf das DOM der übergeordneten Seite zugreift, kann es zu einem Fehler kommen. 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 Gründen der Sicherheit und ordnungsgemäßen Funktionen auf Mobilgeräten stellt das IMA HTML5 SDK im ENABLED-Modus nicht das eigentliche Videoelement der Anzeige bereit. Stattdessen stellt es ein Proxy-Element bereit, das viele Funktionen des normalen Videoelements nachahmt. Bei Anzeigen, die nur unterstützte API-Methoden aufrufen, sollte sich das Rendering der Creatives nicht verändern. Im VpaidMode.INSECURE-Modus stellt das SDK das Videoplayerelement anstelle des Proxys bereit.

Folgende Methoden, Listener und Attribute sind auf dem 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

Häufig gestellte Fragen

Werden JavaScript-Creatives mit VPAID 2 im iOS- oder Android-SDK 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.