Pré-carregar mídia

Selecionar plataforma: HTML5 Android

O SDK do IMA oferece suporte ao pré-carregamento de recursos de anúncios em vídeo. Você pode ativar esse recurso na integração do SDK para proporcionar uma transição mais fluida entre anúncios e conteúdo. Este guia aborda os detalhes técnicos da implementação do pré-carregamento de mídia com o SDK do IMA.

Ativar o 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);
}

Marcação de tempo

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

Evento Com pré-carregamento Sem pré-carregamento
VAST do anúncio solicitado AdsLoader.requestAds() AdsLoader.requestAds()
Anúncio precedente carregado (único) AdsManager.init() AdsManager.start()
Anúncio precedente carregado (VMAP/regras de anúncios) AdsManager.init() AdsManager.init()
Anúncio intermediário ou final carregado Para o primeiro anúncio em um intervalo de anúncio, 8 segundos antes do horário de 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 HTML5 do IMA 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 pré-carregar anúncios VMAP. Verifique se settings.isAutoPlayAdBreaks() está definido como true, que é o valor padrão.
  • Os anúncios finais são pré-carregados após o último anúncio intermediário ou 8 segundos antes do final do conteúdo se AdsRequest.contentDuration for usado para definir a duração.

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. Ele não foi criado para oferecer suporte à veiculação de anúncios off-line. O SDK do IMA carrega o máximo de mídia que o navegador permite, 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 e para a mídia?
Não, o SDK sempre pré-carrega o VAST do anúncio, independentemente dessa configuração de pré-carregamento.