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 fornecer uma transição mais perfeita 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 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);
}
Prazo
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 |
---|---|---|
Anúncio VAST solicitado | AdsLoader.requestAds()
| AdsLoader.requestAds()
|
Anúncio precedente carregado (anúncio único) | AdsManager.init()
| AdsManager.start()
|
Anúncio precedente carregado (regras de anúncio/VMAP) | AdsManager.init()
| AdsManager.init()
|
Anúncio intermediário ou final carregado | Para o primeiro anúncio em um intervalo, oito 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 nem ao usar o SDK HTML5 do IMA em smart TVs.
- O VPAID é pré-carregado, mas nenhuma das dependências do anúncio (incluindo a mídia reproduzida por esse anúncio) é carregada até que o anúncio seja executado.
- A reprodução automática precisa estar ativada para que o pré-carregamento funcione. Verifique se
settings.isAutoPlayAdBreaks()
está definido comotrue
, que é o valor padrão. - Os anúncios finais serã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 está totalmente carregado quando a reprodução do anúncio começa. O pré-carregamento visa melhorar a experiência do usuário, minimizando o tempo necessário para o carregamento do anúncio. Seu objetivo não é oferecer suporte à veiculação de anúncios off-line. O SDK do IMA carrega o máximo de mídia permitido pelo navegador, limitado pela conexão de Internet do usuário e pelo tamanho do criativo.
- O pré-carregamento de mídia precisa estar 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.