Pré-carregando mídia

O SDK do IMA oferece suporte ao carregamento antecipado de recursos de anúncios em vídeo. É possível ativar esse recurso na integração do SDK para oferecer uma transição mais suave entre anúncios e conteúdo. Este guia aborda os detalhes técnicos da implementação do carregamento prévio de mídia com o SDK do IMA.

Ativar pré-carregamento

Para ativar o pré-carregamento, defina AdsRenderingSettings.enablePreloading como "true". Isso precisa ser feito como resultado do evento ADS_MANAGER_LOADED:

function onAdsManagerLoaded(adsManagerLoadedEvent) {
  var adsRenderingSettings = new google.ima.AdsRenderingSettings();
  adsRenderingSettings.enablePreloading = true;
  ...
  var adsManager = adsManagerLoadedEvent.getAdsManager(
      videoContent, adsRenderingSettings);
}

Tempo

A tabela a seguir resume as mudanças no tempo de carregamento de anúncios quando o carregamento antecipado está ativado:

Evento	Com pré-carregamento	Sem pré-carregamento
VAST do anúncio solicitado	AdsLoader.requestAds()	AdsLoader.requestAds()
Anúncio precedente carregado (um anúncio)	AdsManager.init()	AdsManager.start()
Anúncio precedente carregado (regras de anúncio/VMAP)	AdsManager.init()	AdsManager.init()
Anúncios intermediários ou finais carregados	Para o primeiro anúncio em um intervalo comercial, 8 segundos antes do início do anúncio. Para anúncios consecutivos, quando o anúncio anterior começa a ser reproduzido.	No horário de início do anúncio.

Limitações

O pré-carregamento está sujeito às seguintes limitações:

• O pré-carregamento de mídia não está disponível na Web para dispositivos móveis em dispositivos iOS ou ao usar o SDK do IMA para HTML5 em smart TVs conectadas.
• O VPAID é pré-carregado, mas nenhuma das dependências do anúncio, incluindo a mídia reproduzida por ele, é carregada até que o anúncio seja executado.
• A reprodução automática precisa estar ativada para carregar previamente os anúncios do VMAP. Verifique se settings.isAutoPlayAdBreaks() está definido como true, que é o valor padrão.
• Os anúncios finais são carregados antes do último anúncio intermediário ou 8 segundos antes do fim do conteúdo se AdsRequest.contentDuration for usado para definir a duração.

Observação: definir contentDuration como o valor reservado -3 (com contentDuration(-3)) é um valor especial que identifica uma duração de conteúdo desconhecida e desativa o carregamento prévio para pós-rolagens do VAMP.

Perguntas frequentes

O pré-carregamento de mídia carrega o criativo completo?

Não, o criativo geralmente não é totalmente carregado quando a reprodução do anúncio começa. O pré-carregamento tem como objetivo melhorar a experiência do usuário minimizando o tempo necessário para carregar o anúncio. Não é compatível com a veiculação de anúncios off-line. O SDK do IMA carrega a quantidade de mídia permitida pelo navegador. Isso é limitado pela conexão de Internet do usuário e pelo tamanho do criativo.

O pré-carregamento de mídia precisa ser ativado para o VAST do anúncio, bem como para a mídia?

Não, o SDK sempre carrega o VAST do anúncio, independentemente dessa configuração de pré-carregamento.