Загрузите рекламу перед прямой трансляцией

Выберите платформу: HTML5 Android iOS tvOS

SDK IMA можно использовать для монетизации прямых трансляций, а также видео по запросу. Для прямых трансляций необходимо отправлять новый запрос на показ рекламы для каждой рекламной паузы. Распределите эти запросы по времени, чтобы все зрители не запрашивали рекламу одновременно и не перегружали рекламные серверы.

Для этого в SDK IMA есть свойство AdsRequest.liveStreamPrefetchSeconds . Это свойство задает максимальное количество секунд, которое SDK должен ждать перед обращением к рекламному серверу после вызова AdsLoader.requestAds() . Фактическое время запроса будет случайным. Например, если вы установите AdsRequest.liveStreamPrefetchSeconds равным 30, SDK будет ждать от 0 до 30 секунд после вызова AdsLoader.requestAds() , прежде чем фактически отправить запрос на сервер.

Предварительная загрузка прямой трансляции на практике

Мы рекомендуем предварительно загружать следующую рекламную паузу сразу после ее завершения. Это гарантирует максимальное время, доступное для предварительной загрузки. Предположим, у вас есть 5 минут между рекламными паузами. После завершения рекламной паузы вы можете запросить следующую с окном предварительной загрузки в 290 секунд (5 минут минус 10 секунд, чтобы убедиться, что запросы, отправленные в конце окна предварительной загрузки, имеют достаточно времени для обработки):

// 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();
}