Pré-carregar intervalos comerciais para transmissões

Selecione a plataforma: HTML5 Android iOS tvOS

O SDK do IMA pode ser usado para gerar receita com transmissões ao vivo e vídeo on demand. Para transmissões ao vivo, você precisa fazer uma nova solicitação de anúncio para cada intervalo de anúncio. Faça isso para garantir que todos os espectadores não estejam solicitando anúncios ao mesmo tempo e sobrecarregando os servidores de anúncios.

Para ajudar com isso, o SDK do IMA tem a propriedade AdsRequest.liveStreamPrefetchSeconds. Essa propriedade especifica o número máximo de segundos que o SDK deve esperar antes de entrar em contato com o servidor de anúncios depois que você chamar AdsLoader.requestAds(). O horário real da solicitação será aleatório. Por exemplo, se você definir AdsRequest.liveStreamPrefetchSeconds como 30, o SDK vai esperar de 0 a 30 segundos depois que você chamar AdsLoader.requestAds() para fazer a solicitação ao servidor.

Pré-busca de transmissões ao vivo na prática

Recomendamos pré-buscar o próximo intervalo de anúncio assim que um intervalo de anúncio terminar. Isso garante que o período máximo esteja disponível para sua janela de pré-busca. Suponha que você tenha 5 minutos entre os intervalos de anúncio. Quando um intervalo de anúncio é concluído, você pode solicitar o próximo com uma janela de pré-busca de 290 segundos (5 minutos menos 10 segundos, para garantir que as solicitações enviadas no final da janela de pré-busca tenham tempo suficiente para serem resolvidas):

// 5 minutes == 300 seconds. Include a 10 second buffer
var AD_INTERVAL = 290;

function onAdEvent(adEvent) {
  var ad = adEvent.getAd();
  switch(adEvent.type) {
    case google.ima.AdEvent.Type.ALL_ADS_COMPLETED:
      // Pre-fetch our next ad break.
      requestAds();
      // Play those ads in 5 minutes. In a real-world implementation,
      // this is likely done as the result of a message from your
      // streaming server, not a timeout.
      setTimeout(playAds, AD_INTERVAL * 1000);// Convert to ms.
  }
}

function requestAds() {
  // Destroy the current AdsManager, in case the tag you requested previously
  // contains post-rolls (don't play those now).
  if (adsManager) {
    adsManager.destroy();
  }
  // Your AdsLoader will be set up on page-load. You should re-use the same
  // AdsLoader for every request. For more info on setting up the AdsLoader,
  // see the IMA HTML5 client-side "Set up the IMA SDK" guide:
  // https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/get-started
  if (adsLoader) {
    // Reset the IMA SDK.
    adsLoader.contentComplete();
  }
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = '...';
  adsRequest.linearAdSlotWidth = <linear_width>;
  adsRequest.linearAdSlotHeight = <linear_height>;
  adsRequest.nonLinearAdSlotWidth = <nonlinear_width>;
  adsRequest.nonLinearAdSlotHeight = <nonlinear_height>;
  adsRequest.liveStreamPrefechSeconds = AD_INTERVAL;
  adsLoader.requestAds(adsRequest);
}

function playAds() {
  adsManager.init(<linear_width>,  <linear_height>);
  adsManager.start();
}