Le SDK IMA permet de monétiser des diffusions en direct ainsi que des vidéos à la demande. Pour les diffusions en direct, vous devez envoyer une nouvelle demande d'annonce pour chaque coupure publicitaire. Échelonnez ces demandes pour vous assurer que les spectateurs n'en font pas tous des annonces en même temps et qui ralentissent le ou les serveurs publicitaires.
Pour vous aider, le SDK IMA inclut l'AdsRequest.liveStreamPrefetchSeconds
. Cette propriété spécifie le nombre maximal de secondes pendant lequel le SDK
doit attendre avant de contacter l'ad server après l'appel
AdsLoader.requestAds()
L'heure réelle de la requête sera aléatoire. Pour
Par exemple, si vous définissez AdsRequest.liveStreamPrefetchSeconds
sur 30, le SDK
attend 0 à 30 secondes après l'appel de AdsLoader.requestAds()
pour
envoie la requête au serveur.
Le préchargement des diffusions en direct dans la pratique
Nous vous recommandons de précharger la prochaine coupure publicitaire dès qu'elle se termine. Cela permet de garantir que la durée maximale est disponible pour votre fenêtre de préchargement. Imaginons que vous ayez cinq minutes entre chaque coupure publicitaire. À la fin d'une coupure publicitaire, vous pouvez demander votre prochaine coupure publicitaire avec une fenêtre de préchargement de 290 secondes (5 minutes moins 10 secondes, pour s'assurer que les requêtes envoyées à la fin de la fenêtre de préchargement disposent de suffisamment de temps pour se résoudre):
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
...
}
}