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

Sélectionner une plate-forme : HTML5 Android iOS tvOS

Le SDK IMA peut être utilisé pour monétiser les diffusions en direct et les vidéos à la demande. Pour les diffusions en direct, vous devez effectuer 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 et ne ralentissent pas 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 attendre avant de contacter le serveur publicitaire après avoir appelé AdsLoader.requestAds(). Le délai de requête réel sera aléatoire. Par exemple, si vous définissez AdsRequest.liveStreamPrefetchSeconds sur 30, le SDK attend entre 0 et 30 secondes après avoir appelé AdsLoader.requestAds() pour envoyer la requête au serveur.

**Remarque** : Pour voir un exemple complet de préchargement de diffusion en direct, consultez notre exemple GitHub.

Préchargement de diffusion en direct en pratique

Nous vous recommandons de précharger votre prochaine coupure publicitaire dès qu'une coupure publicitaire est terminée. Cela garantit que la durée maximale est disponible pour votre fenêtre de préchargement. Supposons que vous ayez cinq minutes entre les coupures publicitaires. Lorsqu'une coupure publicitaire est terminée, vous pouvez demander votre prochaine coupure publicitaire avec une fenêtre de préchargement de 290 secondes (cinq minutes moins 10 secondes, pour vous assurer que les requêtes envoyées à la fin de la fenêtre de préchargement ont suffisamment de temps pour être résolues) :

// 5 minutes == 300 seconds. Include a 10 second buffer
var AD_INTERVAL = 290;

function onAdEvent(adEvent) {
  var ad = adEvent.getAd();
  switch(adEvent.type) {
    case google.ima.AdEvent.Type.ALL_ADS_COMPLETED:
      // Pre-fetch our next ad break.
      requestAds();
      // Play those ads in 5 minutes. In a real-world implementation,
      // this is likely done as the result of a message from your
      // streaming server, not a timeout.
      setTimeout(playAds, AD_INTERVAL * 1000);// Convert to ms.
  }
}

function requestAds() {
  // Destroy the current AdsManager, in case the tag you requested previously
  // contains post-rolls (don't play those now).
  if (adsManager) {
    adsManager.destroy();
  }
  // Your AdsLoader will be set up on page-load. You should re-use the same
  // AdsLoader for every request. For more info on setting up the AdsLoader,
  // see the IMA HTML5 client-side "Set up the IMA SDK" guide:
  // https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/get-started
  if (adsLoader) {
    // Reset the IMA SDK.
    adsLoader.contentComplete();
  }
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = '...';
  adsRequest.linearAdSlotWidth = <linear_width>;
  adsRequest.linearAdSlotHeight = <linear_height>;
  adsRequest.nonLinearAdSlotWidth = <nonlinear_width>;
  adsRequest.nonLinearAdSlotHeight = <nonlinear_height>;
  adsRequest.liveStreamPrefechSeconds = AD_INTERVAL;
  adsLoader.requestAds(adsRequest);
}

function playAds() {
  adsManager.init(<linear_width>,  <linear_height>);
  adsManager.start();
}