Préchargement de contenus multimédias

Le SDK IMA est compatible avec le préchargement des éléments d'annonces vidéo. Vous pouvez activer cette fonctionnalité dans votre intégration du SDK pour faciliter la transition entre les annonces et le contenu. Ce guide aborde les détails techniques de l'implémentation du préchargement média avec le SDK IMA.

Activer le préchargement

Pour activer le préchargement, définissez AdsRenderingSettings.enablePreloading sur "true". Cette opération doit être effectuée à la suite de l'événement ADS_MANAGER_LOADED:

function onAdsManagerLoaded(adsManagerLoadedEvent) {
  var adsRenderingSettings = new google.ima.AdsRenderingSettings();
  adsRenderingSettings.enablePreloading = true;
  ...
  var adsManager = adsManagerLoadedEvent.getAdsManager(
      videoContent, adsRenderingSettings);
}

Durée

Le tableau suivant récapitule les modifications apportées au temps de chargement des annonces lorsque le préchargement est activé:

Événement	Avec préchargement	Sans précharge
Annonce VAST demandée	AdsLoader.requestAds()	AdsLoader.requestAds()
Annonce vidéo pré-roll chargée (une annonce)	AdsManager.init()	AdsManager.start()
Annonce vidéo pré-roll chargée (VMAP/règles relatives aux annonces)	AdsManager.init()	AdsManager.init()
Annonce vidéo mid-roll ou post-roll chargée	Pour la première annonce d'une coupure publicitaire, huit secondes avant son heure de début. Pour les annonces consécutives, lorsque la lecture de l'annonce précédente commence.	À l'heure de début de l'annonce.

Limites

Le préchargement est soumis aux limites suivantes:

• Le préchargement multimédia n'est pas disponible sur le Web mobile sur les appareils iOS, ni lorsque vous utilisez le SDK IMA HTML5 sur les smart TV connectées.
• La norme VPAID est préchargée, mais aucune des dépendances de l'annonce (y compris le contenu multimédia lu par cette annonce) n'est chargée tant que l'annonce n'a pas été exécutée.
• La lecture automatique doit être activée pour précharger les annonces VMAP. Assurez-vous que settings.isAutoPlayAdBreaks() est défini sur true, qui est la valeur par défaut.
• Les annonces vidéo post-roll sont préchargées après la dernière annonce vidéo mid-roll ou huit secondes avant la fin du contenu si AdsRequest.contentDuration est utilisé pour définir la durée.

Remarque :Définir contentDuration sur la valeur réservée -3 (avec contentDuration(-3)) est une valeur spéciale qui identifie une durée de contenu inconnue et désactive le préchargement pour les annonces vidéo post-roll VAMP.

Questions fréquentes

Le préchargement du support entraîne-t-il le chargement de l'intégralité de la création ?

Non. La création n'est généralement pas entièrement chargée au début de la lecture de l'annonce. Le préchargement est destiné à améliorer l'expérience utilisateur en réduisant le temps de chargement de l'annonce. Il n'est pas destiné à la diffusion d'annonces hors connexion. Le SDK IMA charge autant de contenus multimédias que le navigateur le permet, en fonction de la connexion Internet de l'utilisateur et de la taille de la création.

Le préchargement multimédia doit-il être activé pour le format VAST de l'annonce, ainsi que pour les médias ?

Non. Le SDK précharge toujours le format VAST de l'annonce, quel que soit le paramètre de préchargement.