O SDK para HTML5 do IMA é compatível com criativos JavaScript VPAID 2. Ativar a compatibilidade é fácil, mas há duas diferenças entre a especificação VPAID 2 e a forma como o SDK do IMA oferece suporte ao VPAID 2. Essas diferenças não afetam o código de implementação do SDK nem do player, mas são importantes para autores de criativos JavaScript VPAID 2, já que os criativos podem gerar erros ou não funcionar como 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 uma, consulte nosso Guia explicativo.
- Um URL de tag de anúncio VAST que aponta para um criativo JavaScript VPAID 2.
Carimbos úteis
- Se você não conhece o VPAID 2, saiba mais na página sobre o VPAID do IAB.
Ativar a compatibilidade com VPAID 2
Para ativar o suporte a JavaScript VPAID 2, chame o seguinte método 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.
Ressalvas sobre a compatibilidade com 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 pretende acessar o DOM da página principal, é 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 proxy do player de vídeo
Por questões de segurança e de funcionalidade apropriada 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, ele fornece um elemento de proxy que imita grande parte da funcionalidade do elemento de vídeo normal. Para criativos que chamam somente métodos de API compatíveis, não 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.
Estes sã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 JavaScript VPAID 2 são compatíveis com os SDKs para iOS ou Android?
- No momento, o SDK para HTML5 do IMA é a única plataforma compatível com criativos JavaScript VPAID 2.
- Isso permite criativos VPAID no SDK HTML5 do IMA?
- Sim, o SDK para HTML5 do IMA é compatível com criativos JavaScript VPAID 2.