Guía de implementación

Video post-roll

Post-roll video ads

Anuncio en video que se reproduce en el mismo reproductor justo después de que termina el video, como los comerciales al final de un programa.

Ad Manager
Ad Exchange
AdSense (mediante Ad Manager)
dentro del reproductor de video (celular y escritorio)

Aprender el formato Revisar en mi sitio

Escritorio

Celular

Entiéndelo en 1 minuto

Qué es el video post-roll

¿Sabes cuando se acaba el programa de TV y, antes de que empiece el siguiente, pasan unos comerciales? El post-roll es eso en tu sitio: un anuncio en video que se reproduce al final del video, dentro del mismo reproductor. La persona ya vio lo que quería y el anuncio aparece justo después. Pre quiere decir antes, mid quiere decir en medio y post quiere decir después.

El secreto del post-roll es avisarle al reproductor que el video terminó. El IMA SDK, que es el paquete de código de Google para colocar anuncios en el reproductor, no adivina solo que el contenido terminó. La guía de Google lo dice así: para que se reproduzca el post-roll, tienes que avisarle al SDK cuando el contenido terminó, y entonces reproduce la pausa publicitaria del final, si hay una programada. Este aviso solo debe darse cuando termina el video, nunca cuando termina un anuncio, porque el IMA puede usar el mismo reproductor para los anuncios. Es como tocar el timbre de la escuela solo cuando termina la clase, y no en medio del recreo.

Los intervalos se pueden organizar con las reglas de anuncios de video, una función de Google Ad Manager 360. En ellas, el post-roll se puede activar (Activar), desactivar (Desactivar) o dejar que una regla de menor prioridad decida (Diferir). Con las reglas, la respuesta viene en VMAP, que es como la programación de la TV, diciendo qué intervalos existen. Sin reglas, el propio reproductor puede hacer la solicitud al final del video y decir en la etiqueta que es un post-roll.

¿Cuándo vale la pena? Cuando ya tienes videos en el sitio y quieres un momento más para anuncios que no interrumpa el comienzo ni la mitad del contenido. Las reglas de cualquier anuncio In-stream siguen valiendo: el espacio tiene que declararse de la manera correcta, los controles no pueden quedar ocultos y solo un reproductor puede reproducirse solo y estar visible a la vez. Y, cuando todas las pausas ya se reprodujeron, el IMA avisa con un evento propio, que puedes usar para ordenar la página.

Paso a paso

Cómo implementarlo

Prepara el reproductor con el IMAArma el reproductor con el IMA SDK como en el pre-roll: script del IMA, caja del anuncio encima del video, AdsLoader y AdsRequest con tu etiqueta.
Activa el post-roll en la reglaEn Ad Manager 360, ve a Video, Reglas de anuncios, Nueva regla de anuncio, elige Estándar y marca los anuncios finales de video como Activar. Después define Número máximo de anuncios y Duración máxima del anuncio.
Ajusta la etiquetaCon reglas de anuncios, la etiqueta lleva ad_rule=1. Sin reglas, el reproductor hace la solicitud al final del video y puede informar vpos=postroll, que indica que la solicitud es de fin de video.
Avisa el fin del contenidoEscucha el fin del video y llama al aviso de contenido completo del AdsLoader. Quita ese oyente cuando empiece un anuncio y vuelve a ponerlo cuando regrese el contenido.
Finaliza después de los anunciosEl IMA avisa con el evento ALL_ADS_COMPLETED cuando todas las pausas ya se reprodujeron. Usa ese aviso para limpiar el reproductor, si lo necesitas.

Ejemplo implementado

El código y cómo se ve en pantalla

Va junto con el código del reproductor con IMA: avisa el fin del video para que se reproduzca el post-roll y cuida los oyentes mientras pasan los anuncios.

<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>

En el escritorioCuando el video llega al final, el anuncio se reproduce en el mismo reproductor. Después del anuncio, el video no vuelve a empezar solo.

En el celularIgual que en la computadora: el anuncio se reproduce en el reproductor del celular justo después de que termina el video.

Lo que recomienda Google

Qué se puede y qué no

Sí se puede

Reproducir un anuncio al final del video, dentro del mismo reproductor, usando el IMA SDK.
Activar, desactivar o dejar que otra regla decida el post-roll en las reglas de anuncios de video de Ad Manager 360.
Hacer la solicitud al final del video sin reglas de anuncios e informar en la etiqueta que es un post-roll.
Usar el evento de todos los anuncios completos para ordenar la página después de la última pausa.

No se puede

No se puede avisar el fin del contenido cuando quien terminó fue un anuncio: el aviso es solo para el fin del video.
No se pueden dejar los controles del video y del anuncio cubiertos, ocultos o sin funcionar.
No puedes declarar el espacio equivocado: un reproductor con video debe ser In-stream o Contenido complementario.
No se puede tener más de un reproductor que se reproduzca solo y esté visible al mismo tiempo.
No se pueden usar los productos IMA para ganar dinero con videos de YouTube.

Consejos

Para hacerlo bien

Si olvidas avisar el fin del contenido, el post-roll simplemente no se reproduce.
El ejemplo de Google no avisa el fin del contenido si hay un anuncio reproduciéndose en ese momento.
Cuando el contenido regresa después de un anuncio, el ejemplo de Google solo manda reproducir si el video todavía no terminó.

Cuidado

Errores comunes

No avisar el fin del video

Google dice que, para que se reproduzca el post-roll, el SDK necesita saber que el contenido terminó. Sin ese aviso, la pausa del final no ocurre.

Avisar al final de un anuncio

Si el oyente de fin de video sigue activado mientras el anuncio se reproduce en el mismo reproductor, el aviso puede salir en el momento equivocado. Quita el oyente en la pausa y vuelve a ponerlo cuando regrese el contenido.

Mandar reproducir un video que ya terminó

Después del post-roll, el IMA pide reanudar el contenido. Si el video ya terminó, no mandes reproducirlo otra vez, porque puede empezar de nuevo sin que la persona lo pida.

Preguntas frecuentes

¿Por qué no aparece mi post-roll?

Un motivo posible es no avisarle a IMA que el video terminó. Google pide que el sitio avise el fin del contenido para que el SDK reproduzca el intervalo final, si hay uno programado.

¿Necesito reglas de anuncios para tener post-roll?

No necesariamente. Con reglas (Ad Manager 360), el post-roll viene programado en el VMAP. Sin reglas, el reproductor puede pedir el anuncio al final del video e informar vpos=postroll en la etiqueta.

¿El post-roll interrumpe el video?

No. Se reproduce después de que el contenido termina, en el mismo reproductor.

Biblioteca

Fuente oficial de Google

Todo en esta página sigue la documentación oficial de Google. Léela directo en la fuente:

¿Tu sitio usa este formato de la manera correcta?

La auditoría lee el sitio como un visitante, sin hacer clic en nada, y muestra qué corregir.

Hacer una auditoría