Creatividades de JavaScript de VPAID 2

El SDK de IMA HTML5 admite creatividades de JavaScript VPAID 2. Habilitar la compatibilidad es sencillo, pero hay dos diferencias que debes tener en cuenta entre las especificaciones de VPAID 2 y la forma en que el SDK de IMA admite VPAID 2. Estas diferencias no afectan el código de implementación del reproductor ni del SDK, pero son importantes para los autores de creatividades de JavaScript VPAID 2, ya que las creatividades pueden generar errores o no funcionar como se espera cuando las procesa 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 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 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 IFrame y Elemento proxy del reproductor de video.
  • DISABLED: No se reproducen los anuncios de VPAID. Si un anuncio solicitado muestra una creatividad de VPAID, se generará un error.
Para obtener más información sobre los modos VPAID, consulta la documentación de la API relacionada con 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 usar ImaSdkSettings.setVpaidMode(...) de la siguiente manera: 

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

Elemento de proxy de reproductor de video

Por motivos de seguridad y una funcionalidad adecuada para dispositivos móviles, en el modo ENABLED, el SDK de IMA HTML5 no proporciona el elemento de video real al anuncio, sino 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 llaman a 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 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 de VPAID 2 son compatibles con los SDK de iOS o Android?
El SDK de IMA HTML5 es la única plataforma de SDK de IMA que actualmente admite creatividades de JavaScript VPAID 2.
¿Esta opción habilita las creatividades de VPAID en el SDK de IMA HTML5?
Sí, el SDK de IMA HTML5 admite creatividades de JavaScript VPAID 2.