Charger des annonces pré-roll pour une diffusion en direct

le SDK Google Interactive Media Ads (IMA) pour iOS.

Le SDK IMA peut être utilisé pour monétiser les flux en direct et les 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 tous vos spectateurs ne demandent pas d'annonces en même temps, ce qui pourrait ralentir le ou les serveurs publicitaires.

Pour vous aider, le SDK IMA dispose de la propriété AdsRequest.liveStreamPrefetchSeconds. Cette propriété spécifie le nombre maximal de secondes pendant lesquelles le SDK doit patienter avant de contacter le serveur publicitaire après l'appel de AdsLoader.requestAds(). L'heure de la demande réelle sera aléatoire. Par exemple, si vous définissez AdsRequest.liveStreamPrefetchSeconds sur 30, le SDK attend entre 0 et 30 secondes après l'appel de AdsLoader.requestAds() pour envoyer la requête au serveur.

Préchargement des diffusions en direct en pratique

Nous vous recommandons de précharger votre prochaine série d'annonces dès qu'une série d'annonces se termine. Cela garantit la durée maximale disponible pour votre fenêtre de préchargement. Imaginons que vous ayez cinq minutes entre les coupures publicitaires. Une fois la coupure publicitaire terminée, vous pouvez demander la suivante avec une fenêtre de préchargement de 290 secondes (5 minutes moins 10 secondes, pour vous assurer que les demandes envoyées à la fin de la fenêtre de préchargement ont suffisamment de temps pour être traitées) :

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

    ...
  }
}