Criativos JavaScript VPAID 2

O SDK para HTML5 do IMA é compatível com criativos VPAID 2 JavaScript. É fácil ativar a compatibilidade, mas há duas diferenças entre a especificação VPAID 2 e a forma como o SDK do IMA é compatível com o VPAID 2. Essas diferenças não afetam o código de implementação do player ou do SDK, mas são importantes para os autores de criativos JavaScript VPAID 2, já que os criativos podem gerar erros ou não funcionar conforme o esperado quando renderizados pelo SDK HTML5 do IMA.

Pré-requisitos

  • Player de vídeo HTML5 com o SDK HTML5 do IMA integrado. Se você não tiver um, confira nosso Guia explicativo.
  • Um URL de tag de anúncio VAST que aponta para um criativo JavaScript VPAID 2.

Guias úteis

Como ativar a compatibilidade com VPAID 2

Para ativar a compatibilidade com JavaScript VPAID 2, chame o método a seguir antes de inicializar seu AdDisplayContainer:

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

Os modos VPAID disponíveis são os seguintes:

  • ENABLED: permite anúncios VPAID com as configurações padrão.
  • INSECURE: permite anúncios VPAID no modo não seguro. Para mais informações, consulte Segurança do IFrame e Elemento de proxy do player de vídeo.
  • DISABLED: os anúncios VPAID não são reproduzidos. Se um anúncio solicitado retornar um criativo VPAID, será gerado um erro.
. Para mais informações sobre os modos VPAID, consulte a documentação da API para ImaSdkSettings.VpaidMode.

Advertências sobre a compatibilidade do VPAID 2

Segurança do IFrame

Por padrão, o SDK do IMA usa um iframe seguro em vez de um iframe compatível (mesmo domínio) ou um script in-page para renderizar criativos JavaScript VPAID 2. Isso significa que, se um criativo espera acessar o DOM da página pai, é possível que ocorra um erro. Para renderizar seu anúncio em um iframe compatível, use ImaSdkSettings.setVpaidMode(...) da seguinte maneira: 

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

Elemento de proxy do player de vídeo

Por motivos de segurança e funcionalidade adequada para dispositivos móveis, no modo ENABLED, o SDK HTML5 do IMA não fornece o elemento de vídeo real ao anúncio. em vez disso, fornece um elemento de proxy que imita grande parte da funcionalidade do elemento de vídeo normal. Para criativos de anúncios que chamam somente métodos de API compatíveis, não deve haver mudanças de comportamento na renderização dos criativos. Com o modo VpaidMode.INSECURE, o SDK fornece o elemento do player de vídeo em vez do proxy.

Aqui estão os métodos, listeners e atributos disponíveis no elemento de proxy de vídeo:

Métodos

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

Tipos de evento 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

Perguntas frequentes

Os criativos VPAID 2 JavaScript são compatíveis com os SDKs do iOS ou do Android?
O SDK HTML5 do IMA é a única plataforma desse SDK compatível com criativos JavaScript VPAID 2 no momento.
Isso ativa criativos VPAID no SDK HTML5 do IMA?
Sim, o SDK HTML5 do IMA é compatível com criativos JavaScript VPAID 2.