Creatividades de JavaScript de VPAID 2

El SDK de IMA HTML5 admite creatividades VPAID 2 de JavaScript. Habilitar la compatibilidad es fácil, pero hay dos diferencias que se deben tener en cuenta entre la especificación de VPAID 2 y la forma en que el SDK de IMA admite VPAID 2. Estas diferencias no afectan al código de implementación del reproductor ni del SDK, pero son importantes para los autores de creatividades de JavaScript de VPAID 2, ya que es posible que las creatividades muestren errores o no funcionen como se espera cuando las renderiza el SDK de IMA HTML5.

Requisitos previos

  • Reproductor de video HTML5 con el SDK de IMA HTML5 integrado Si no tienes una, consulta nuestra guía de introducción.
  • Una URL de etiqueta de anuncio de VAST que dirige a una creatividad de JavaScript de VPAID 2

Aspectos básicos útiles

Cómo habilitar la compatibilidad con VPAID 2

Para habilitar la compatibilidad con JavaScript de VPAID 2, llama al siguiente método antes de inicializar tu AdDisplayContainer:

      google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);
      ...
      var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
      var adsLoader = new google.ima.AdsLoader(adDisplayContainer);
      ...

Los modos de VPAID disponibles son los siguientes:

  • ENABLED: Permite anuncios de VPAID con la configuración predeterminada.
  • INSECURE: Permite anuncios de VPAID en modo no seguro. Para obtener más información, consulta Seguridad de IFrame y Elemento de proxy del reproductor de video.
  • DISABLED: No se reproducen los anuncios de VPAID. Si un anuncio solicitado muestra una creatividad de VPAID, se mostrará un error.
Si deseas obtener más información sobre los modos de VPAID, consulta la documentación de la API para ImaSdkSettings.VpaidMode.

Advertencias sobre la compatibilidad con VPAID 2

Seguridad de IFrame

De forma predeterminada, el SDK de IMA usa un iframe seguro en lugar de un iframe compatible (mismo dominio) o una secuencia de comandos in-page para renderizar creatividades de JavaScript de VPAID 2. Esto significa que si una creatividad espera acceder al DOM de la página principal, es posible que se produzca un error. Para renderizar tu anuncio en un iframe compatible, puedes utilizar ImaSdkSettings.setVpaidMode(...) de la siguiente manera: 

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

Elemento de proxy del reproductor de video

Por motivos de seguridad y para funcionar correctamente en dispositivos móviles, en el modo ENABLED, el SDK HTML5 de IMA no proporciona el elemento de video real al anuncio. sino que proporciona un elemento proxy que imita gran parte de la funcionalidad del elemento de video normal. En el caso de las creatividades de anuncios que solo solicitan métodos de API admitidos, no debería haber cambios de comportamiento en la renderización de las creatividades. Con el modo VpaidMode.INSECURE, el SDK proporciona el elemento del reproductor de video en lugar del proxy.

Estos son los métodos, objetos de escucha y atributos disponibles en el elemento del proxy de video:

Métodos

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

Tipos de eventos para addEventListener

  • abort
  • canplay
  • canplaythrough
  • click
  • durationchange
  • emptied
  • ended
  • error
  • loadeddata
  • loadedmetadata
  • loadstart
  • pause
  • play
  • playing
  • progress
  • ratechange
  • suspend
  • seeked
  • seeking
  • timeupdate
  • waiting

Atributos

  • currentTime
  • duration
  • ended
  • paused
  • playbackRate
  • src
  • type

Preguntas frecuentes

¿Las creatividades de JavaScript VPAID 2 son compatibles con los SDK de iOS o Android?
Actualmente, el SDK HTML5 de IMA es la única plataforma que admite creatividades de JavaScript de VPAID 2.
¿Habilita esta opción las creatividades de VPAID en el SDK de IMA HTML5?
Sí, el SDK de IMA HTML5 admite creatividades de JavaScript VPAID 2.