Ne pas signaler la fin de la vidéo
Google indique que, pour que le post-roll soit lu, le SDK doit savoir que le contenu est terminé. Sans cet avertissement, la pause de fin n'a pas lieu.
Guide de mise en œuvre
Post-roll video ads
Annonce vidéo diffusée dans le même lecteur juste après la fin de la vidéo, comme les publicités à la fin d'une émission.
Comprendre en 1 minute
Vous savez, quand l'émission de télé se termine et que, avant le début de la suivante, passent quelques publicités ? Le post-roll, c'est cela sur votre site : une annonce vidéo diffusée à la fin de la vidéo, dans le même lecteur. La personne a déjà regardé ce qu'elle voulait et l'annonce apparaît juste après. Pre signifie avant, mid signifie milieu et post signifie après.
Le secret du post-roll est de prévenir le lecteur que la vidéo est terminée. L'IMA SDK, le paquet de code de Google pour placer des annonces dans le lecteur, ne devine pas tout seul que le contenu est terminé. Le guide de Google dit ceci : pour que le post-roll soit lu, vous devez prévenir le SDK quand le contenu est terminé, et il diffuse alors la pause de fin, s'il y en a une de programmée. Cet avertissement ne doit être envoyé que lorsque la vidéo se termine, jamais lorsqu'une annonce se termine, car l'IMA peut utiliser le même lecteur pour les annonces. C'est comme sonner la cloche de l'école seulement à la fin du cours, et pas au milieu de la récréation.
Les coupures peuvent être organisées par les règles d'annonces vidéo, une fonctionnalité de Google Ad Manager 360. Avec elles, le post-roll peut être activé (Activer), désactivé (Désactiver) ou laissé à une règle de priorité inférieure (Différer). Avec les règles, la réponse arrive en VMAP, qui est comme le programme de la télé, indiquant quelles coupures existent. Sans règles, le lecteur lui-même peut faire la demande à la fin de la vidéo et indiquer dans le tag que c'est un post-roll.
Quand est-ce utile ? Quand vous avez déjà des vidéos sur le site et que vous voulez un moment de plus pour une annonce, qui n'interrompt ni le début ni le milieu du contenu. Les règles de toute annonce In-stream continuent de s'appliquer : l'emplacement doit être déclaré de la bonne manière, les commandes ne peuvent pas être cachées et un seul lecteur peut se lancer tout seul de façon visible à la fois. Et, quand toutes les pauses ont été diffusées, l'IMA le signale par un événement propre, que vous pouvez utiliser pour réorganiser la page.
Pas à pas
Exemple mis en place
<script>
var video = document.getElementById('conteudo');
// Avisa o IMA que o CONTEÚDO acabou (nunca no fim de um anúncio)
var contentEndedListener = function () { adsLoader.contentComplete(); };
video.addEventListener('ended', contentEndedListener);
adsLoader.addEventListener(
google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
function (e) {
adsManager = e.getAdsManager(video);
adsManager.addEventListener(
google.ima.AdEvent.Type.CONTENT_PAUSE_REQUESTED,
function () {
// anúncio vai tocar: tira o ouvinte de fim do vídeo
video.removeEventListener('ended', contentEndedListener);
video.pause();
});
adsManager.addEventListener(
google.ima.AdEvent.Type.CONTENT_RESUME_REQUESTED,
function () {
// conteúdo volta: coloca o ouvinte de novo
video.addEventListener('ended', contentEndedListener);
if (!video.ended) { video.play(); }
});
adsManager.addEventListener(
google.ima.AdEvent.Type.ALL_ADS_COMPLETED,
function () { console.log('Todos os intervalos tocaram'); });
});
</script>Ce que Google recommande
Conseils
Attention
Google indique que, pour que le post-roll soit lu, le SDK doit savoir que le contenu est terminé. Sans cet avertissement, la pause de fin n'a pas lieu.
Si l'écouteur de fin de vidéo reste actif pendant qu'une annonce est lue dans le même lecteur, l'avertissement peut partir au mauvais moment. Retirez l'écouteur pendant la pause et remettez-le quand le contenu reprend.
Après le post-roll, l'IMA demande de reprendre le contenu. Si la vidéo est déjà terminée, ne relancez pas la lecture, sinon elle peut redémarrer sans que la personne le demande.
Une raison possible est de ne pas avoir signalé à l'IMA que la vidéo est terminée. Google demande que le site signale la fin du contenu pour que le SDK joue la coupure de fin, s'il y en a une de programmée.
Pas obligatoirement. Avec des règles (Ad Manager 360), le post-roll arrive programmé dans le VMAP. Sans règles, le lecteur peut demander l'annonce à la fin de la vidéo et indiquer vpos=postroll dans la balise.
Non. Il est lu une fois le contenu terminé, dans le même lecteur.
Bibliothèque
Tout ce qui figure sur cette page suit la documentation officielle de Google. Lisez-la directement à la source :
L'audit lit le site comme un visiteur, sans rien cliquer, et montre ce qu'il faut corriger.