Le SDK IMA est compatible avec le préchargement d'éléments d'annonces vidéo. Vous pouvez activer cette fonctionnalité dans l'intégration de votre SDK afin de faciliter la transition entre les annonces et le contenu. Ce guide passe en revue les détails techniques de la mise en œuvre du préchargement multimédia 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 suite à l'événement ADS_MANAGER_LOADED
:
function onAdsManagerLoaded(adsManagerLoadedEvent) {
var adsRenderingSettings = new google.ima.AdsRenderingSettings();
adsRenderingSettings.enablePreloading = true;
...
var adsManager = adsManagerLoadedEvent.getAdsManager(
videoContent, adsRenderingSettings);
}
Délai
Le tableau suivant récapitule les modifications apportées à la durée de chargement de l'annonce lorsque le préchargement est activé:
Événement | Avec préchargement | Sans préchargement |
---|---|---|
Annonce VAST demandée | AdsLoader.requestAds() |
AdsLoader.requestAds() |
Annonce vidéo pré-roll chargée (une seule annonce) | AdsManager.init() |
AdsManager.start() |
Annonce vidéo pré-roll chargée (règles VMAP et 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 le 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 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.
- VPAID est préchargé, mais aucune des dépendances de l'annonce (y compris les contenus multimédias lus par celle-ci) 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 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 la durée est définie sur
AdsRequest.contentDuration
.
Questions fréquentes
- Le préchargement multimédia charge-t-il 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 vise à améliorer l'expérience utilisateur en réduisant au maximum le temps de chargement de l'annonce. Elle n'est pas destinée à prendre en charge la diffusion d'annonces hors connexion. Le SDK IMA charge autant de mé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 contenus multimédias ?
- Non, le SDK précharge toujours le format VAST de l'annonce, quel que soit le paramètre de préchargement.