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. Atur permintaan ini secara bertahap untuk memastikan semua penonton tidak meminta iklan pada saat yang sama dan membebani server iklan.
Untuk membantu hal ini, IMA SDK memiliki properti AdsRequest.liveStreamPrefetchSeconds. Properti ini menentukan jumlah maksimum detik 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.
Pra-pengambilan live stream dalam praktik
Sebaiknya lakukan pra-pengambilan jeda iklan berikutnya segera setelah jeda iklan selesai. Hal ini memastikan jangka waktu maksimum tersedia untuk jendela pra-pengambilan Anda. Misalnya, Anda memiliki waktu 5 menit di antara jeda iklan. Saat jeda iklan selesai, Anda dapat meminta jeda iklan berikutnya dengan jendela pra-pengambilan 290 detik (5 menit dikurangi 10 detik, untuk memastikan permintaan yang 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
...
}
}