Das IMA SDK kann sowohl zur Monetarisierung von Livestreams als auch von Video-on-Demand-Inhalten verwendet werden. Bei Livestreams müssen Sie für jede Werbeunterbrechung eine neue Anzeigenanfrage stellen. Staffel diese Anfragen, damit nicht alle Zuschauer gleichzeitig Anzeigen anfordern und die Ad-Server überlasten.
Das IMA SDK bietet hierfür das Attribut AdsRequest.liveStreamPrefetchSeconds. Mit dieser Property wird die maximale Anzahl von Sekunden angegeben, die das SDK warten soll, bevor es den Ad-Server kontaktiert, nachdem Sie AdsLoader.requestAds() aufgerufen haben. Die tatsächliche Anfragezeit wird zufällig festgelegt. Wenn Sie AdsRequest.liveStreamPrefetchSeconds beispielsweise auf 30 festlegen, wartet das SDK nach dem Aufrufen von AdsLoader.requestAds() zwischen 0 und 30 Sekunden, bevor die Anfrage an den Server gesendet wird.
Livestream-Prefetch in der Praxis
Wir empfehlen, die nächste Werbeunterbrechung vorab abzurufen, sobald eine Werbeunterbrechung abgeschlossen ist. So wird sichergestellt, dass für das Prefetch-Fenster die maximal mögliche Zeitspanne zur Verfügung steht. Angenommen, zwischen den Werbeunterbrechungen liegen 5 Minuten. Wenn eine Werbeunterbrechung abgeschlossen ist, können Sie die nächste Werbeunterbrechung mit einem Prefetch-Zeitfenster von 290 Sekunden anfordern (5 Minuten minus 10 Sekunden, damit die am Ende des Prefetch-Zeitfensters gesendeten Anfragen genügend Zeit für die Verarbeitung haben):
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
...
}
}