O SDK do IMA é compatível com o pré-carregamento de recursos de anúncios em vídeo. É possível ativar esse recurso na integração do SDK para oferecer 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, definaAdsRenderingSettings.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 carga de anúncios quando o pré-carregamento está ativado:
| Evento | Com pré-carga | Sem pré-carregamento | 
|---|---|---|
| VAST de anúncio solicitado | AdsLoader.requestAds() | AdsLoader.requestAds() | 
| Anúncio precedente carregado (único anúncio) | AdsManager.init() | AdsManager.start() | 
| Pré-roll carregado (VMAP/regras de anúncio) | AdsManager.init() | AdsManager.init() | 
| Anúncio intermediário ou final carregado | Para o primeiro anúncio em um intervalo, 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 veiculado. | 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 nem 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 veiculada 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 comotrue, 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 fim do conteúdo se AdsRequest.contentDurationfor 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. A pré-carga tem como objetivo melhorar a experiência do usuário, minimizando o tempo necessário para o carregamento do 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, independente dessa configuração de pré-carga.