IMA SDK は、ライブ ストリームとビデオ オンデマンドの収益化に使用できます。 ライブ配信では、ミッドロール挿入点ごとに新しい広告リクエストを送信する必要があります。 すべての視聴者がリクエストしていないよう、リクエストを段階的に実施します。 複数の広告が同時に存在し、広告サーバーの動きが遅くなっていました。
これに対応するため、IMA SDK には AdsRequest.liveStreamPrefetchSeconds
プロパティです。このプロパティは、SDK の最大秒数を指定します
呼び出し後、広告サーバーにアクセスできるようになるまで、待機する必要があります。
AdsLoader.requestAds()
。実際のリクエスト時間はランダムです。対象
たとえば、AdsRequest.liveStreamPrefetchSeconds
を 30 に設定すると、SDK は
AdsLoader.requestAds()
を呼び出してから 0 ~ 30 秒待ってから、
サーバーにリクエストを送信する必要があります。
ライブ配信のプリフェッチの実例
ミッドロール挿入点が完了したら、すぐに次のミッドロール挿入点をプリフェッチすることをおすすめします。 これにより、プリフェッチ ウィンドウに使用可能な最大時間が確保されます。 ミッドロール挿入点の間隔が 5 分だとします。ミッドロール挿入点が完了すると 290 秒のプリフェッチウィンドウで次のミッドロール挿入点をリクエストできます。 (5 分から 10 秒を引いて、セッションの最後に送信されたリクエストが プリフェッチ ウィンドウが解決するのに十分な時間がある):
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
...
}
}