Le SDK IMA est compatible avec le préchargement des composants d'annonce vidéo. Vous pouvez activer cette fonctionnalité dans l'intégration de votre SDK pour offrir 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 contenus multimédias avec le SDK IMA.
Activer le préchargement
Pour activer le préchargement, définissezAdsRenderingSettings.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 délai de chargement des annonces lorsque le préchargement est activé :
| Événement | Avec préchargement | Sans préchargement |
|---|---|---|
| Annonce VAST demandée | AdsLoader.requestAds() |
AdsLoader.requestAds() |
| Annonce pré-roll chargée (annonce unique) | AdsManager.init() |
AdsManager.start() |
| Annonce pré-roll chargée (VMAP/règles relatives aux annonces) | AdsManager.init() |
AdsManager.init() |
| Annonce mid-roll ou post-roll chargée | Pour la première annonce d'une coupure publicitaire, huit 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 des contenus multimédias 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.
- VPAID est préchargé, mais aucune des dépendances de l'annonce (y compris les contenus multimédias 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 surtrue, qui est la valeur par défaut. - Les annonces post-roll sont préchargées après la dernière annonce mid-roll ou huit secondes avant la fin du contenu si
AdsRequest.contentDurationest utilisé pour définir la durée.
Questions fréquentes
- Le préchargement des médias charge-t-il l'intégralité de la création ?
- Non, la création n'est généralement pas entièrement chargée lorsque la lecture de l'annonce commence. Le préchargement vise à améliorer l'expérience utilisateur en réduisant le temps de chargement de l'annonce. Il n'est pas conçu pour 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 des médias doit-il être activé pour le VAST de l'annonce ainsi que pour les médias ?
- Non, le SDK précharge toujours le VAST de l'annonce, quel que soit ce paramètre de préchargement.