Pra-pengambilan Live Stream

IMA SDK dapat digunakan untuk memonetisasi live stream serta video on demand. Untuk live stream, Anda harus membuat permintaan iklan baru untuk setiap jeda iklan. Sesuaikan permintaan ini untuk memastikan semua penonton Anda tidak mengajukan permintaan iklan pada saat yang sama dan memperlambat server iklan.

Untuk membantu melakukan tugas ini, IMA SDK memiliki AdsRequest.liveStreamPrefetchSeconds saat ini. Properti ini menentukan jumlah detik maksimum SDK harus menunggu sebelum menghubungi server iklan setelah Anda memanggil AdsLoader.requestAds(). Waktu permintaan sebenarnya akan diacak. Sebagai misalnya, jika Anda menetapkan AdsRequest.liveStreamPrefetchSeconds ke 30, SDK menunggu 0 hingga 30 detik setelah Anda memanggil AdsLoader.requestAds() untuk membuat permintaan ke server.

Praktik pengambilan awal live stream

Sebaiknya lakukan pengambilan data jeda iklan berikutnya segera setelah jeda iklan selesai. Hal ini memastikan durasi waktu maksimum tersedia untuk periode pra-pengambilan Anda. Misalkan Anda memiliki jeda 5 menit di antara jeda iklan. Saat jeda iklan selesai, Anda dapat meminta jeda iklan berikutnya dengan periode pra-pengambilan selama 290 detik (5 menit dikurangi 10 detik, untuk memastikan permintaan dikirim pada akhir jendela pra-pengambilan memiliki cukup waktu untuk diselesaikan):

Objective-C


- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {

  ...

  switch (event.type) {

    ...

    case kIMAAdEvent_ALL_ADS_COMPLETED:

      IMAAdsRequest *request = [[IMAAdsRequest alloc]
             initWithAdTagUrl: self.adTagUrl
           adDisplayContainer: self.adDisplayContainer
         avPlayerVideoDisplay: self.avPlayerVideoDisplay
        pictureInPictureProxy: self.pictureInPictureProxy
                  userContext: nil];

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      Float64 adGap = 30;
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5;
      [self.adsLoader requestAdsWithRequest:request];
      // start new ads after adGap seconds have elapsed
      dispatch_after(dispatch_time(DISPATCH_TIME_NOW, adGap * NSEC_PER_SEC), dispatch_get_main_queue(), ^{
        [adsManager start];
      });

      break;

    ...

  }

  ...

}

Swift

func adsManager(_ adsManager: IMAAdsManager!, didReceive event: IMAAdEvent!) {
  switch event.type {

    ...

    case IMAAdEventType.ALL_ADS_COMPLETED:

      let request = IMAAdsRequest(
        adTagUrl: AdTagUrl,
        adDisplayContainer: adDisplayContainer,
        contentPlayhead: contentPlayhead,
        userContext: nil)

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      let adGap = 30
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5
      adsLoader.requestAds(with: request)
      // start new ads after adGap seconds have elapsed
      DispatchQueue.main.asyncAfter(deadline: .now() + adGap) {
        adsManager.start()
      }

      break

    ...
  }
}