Précharger des contenus multimédias

Sélectionner une plate-forme : HTML5 Android

Le SDK IMA est compatible avec le préchargement des éléments d'annonce vidéo. Vous pouvez activer cette fonctionnalité dans votre intégration du SDK pour assurer une transition plus fluide entre les annonces et le contenu. Ce guide présente les détails techniques de l'implémentation du préchargement de contenu multimé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 à la durée de chargement des annonces lorsque le préchargement est activé :

Événement Avec préchargement Sans préchargement
Demande VAST d'annonce AdsLoader.requestAds() AdsLoader.requestAds()
Pré-roll chargé (annonce unique) AdsManager.init() AdsManager.start()
Pré-roll chargé (VMAP/règles relatives aux annonces) AdsManager.init() AdsManager.init()
Préchargement (mid-roll ou post-roll) Pour la première annonce d'une coupure publicitaire, 8 secondes avant l'heure de début de l'annonce. 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 de contenu multimédia n'est pas disponible sur le Web mobile sur les appareils iOS ni lorsque vous utilisez le SDK IMA pour HTML5 sur des télévisions connectées.
  • VPAID est préchargé, mais aucune des dépendances de l'annonce, y compris le contenu multimédia qu'elle diffuse, n'est chargée tant que l'annonce n'est pas 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 post-roll sont préchargées après la dernière annonce mid-roll ou 8 secondes avant la fin du contenu si AdsRequest.contentDuration est utilisé pour définir la durée.

Questions fréquentes

Le préchargement de contenu multimédia charge-t-il la création complète ?
Non, la création n'est généralement pas entièrement chargée lorsque la lecture de l'annonce commence. Le préchargement est destiné à améliorer l'expérience utilisateur en réduisant le temps nécessaire au chargement de l'annonce. Il n'est pas destiné à prendre en charge la diffusion d'annonces hors connexion. Le SDK IMA charge autant de contenu multimédia 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 de contenu multimédia doit-il être activé pour le VAST de l'annonce ainsi que pour le contenu multimédia ?
Non, le SDK précharge toujours le VAST de l'annonce, quel que soit ce paramètre de préchargement.