Memuat iklan pre-roll untuk live stream

Pilih platform: HTML5 Android iOS tvOS

IMA SDK dapat digunakan untuk memonetisasi live stream dan video on demand. Untuk live stream, Anda harus membuat permintaan iklan baru untuk setiap jeda iklan. Lakukan permintaan ini secara bertahap untuk memastikan semua penonton Anda tidak meminta iklan secara bersamaan dan memperlambat server iklan.

Untuk membantu hal ini, IMA SDK memiliki properti AdsRequest.liveStreamPrefetchSeconds. Properti ini menentukan jumlah detik maksimum yang harus ditunggu SDK sebelum menghubungi server iklan setelah Anda memanggil AdsLoader.requestAds(). Waktu permintaan sebenarnya akan diacak. Misalnya, jika Anda menetapkan AdsRequest.liveStreamPrefetchSeconds ke 30, SDK akan menunggu 0 hingga 30 detik setelah Anda memanggil AdsLoader.requestAds() untuk benar-benar membuat permintaan ke server.

Catatan: Untuk melihat contoh pengambilan data di muka live stream yang sudah selesai, lihat contoh GitHub kami.

Prefetch live stream dalam praktiknya

Sebaiknya lakukan pengambilan data iklan berikutnya segera setelah jeda iklan selesai. Hal ini memastikan jangka waktu maksimum tersedia untuk jendela pengambilan data sebelumnya. Misalnya, Anda memiliki 5 menit di antara jeda iklan. Setelah jeda iklan selesai, Anda dapat meminta jeda iklan berikutnya dengan jendela pengambilan data 290 detik (5 menit dikurangi 10 detik, untuk memastikan permintaan yang dikirim di akhir jendela pengambilan data memiliki cukup waktu untuk diselesaikan):

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