O SDK do IMA para HTML5 oferece suporte a criativos VPAID 2 em JavaScript. Ativar o suporte é fácil, mas há duas diferenças entre a especificação do 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 player ou do SDK, mas são importantes para os autores de criativos em JavaScript do VPAID 2. Isso porque os criativos podem gerar erros ou não funcionar como esperado quando renderizados pelo SDK do IMA para HTML5.
Pré-requisitos
- Player de vídeo HTML5 com o SDK HTML5 do IMA integrado. Se você não tiver um, consulte Configurar o SDK do IMA.
- Um URL de tag de anúncio VAST que aponta para um criativo em JavaScript VPAID 2.
Noções básicas úteis
- Se você não conhece o VPAID 2, leia mais na página do VPAID do IAB.
Ativar o suporte ao VPAID 2
Para ativar o suporte a JavaScript do VPAID 2, chame o seguinte método antes de inicializar o 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 de 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 de iFrames e Elemento de proxy do player de vídeo.DISABLED
: os anúncios VPAID não são veiculados. Se um anúncio solicitado retornar um criativo VPAID, um erro será gerado.
Observações de suporte do VPAID 2
Segurança do IFrame
Por padrão, o SDK do IMA usa um iframe seguro em vez de um iframe amigável (mesmo domínio) ou um script na página para renderizar criativos VPAID 2 JavaScript. Isso significa que, se um criativo espera acessar o DOM da página pai, ele pode causar um erro. Para renderizar o 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
Para garantir a segurança e a 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, ele fornece um elemento proxy que imita grande parte da funcionalidade do elemento de vídeo normal. Para criativos de anúncios que chamam apenas 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.
Confira os métodos, listeners e atributos disponíveis no elemento proxy de vídeo:
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
Perguntas frequentes
- Os criativos VPAID 2 JavaScript são compatíveis com os SDKs do iOS ou Android?
- O SDK do IMA HTML5 é a única plataforma de SDK do IMA que oferece suporte a criativos JavaScript VPAID 2.
- Isso ativa os criativos VPAID no SDK do IMA para HTML5?
- Sim, o SDK do IMA para HTML5 oferece suporte a criativos VPAID 2 em JavaScript.