Guía de implementación

Video mid-roll

Mid-roll video ads

Anuncio en video que entra en medio del contenido, como una pausa comercial, y luego el video continúa donde se había detenido.

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

Piensa en un partido de fútbol en la TV: en el entretiempo entran los comerciales y, después, el partido vuelve. El mid-roll es el corte comercial del video de tu sitio. El video se detiene en un punto acordado, reproduce uno o más anuncios dentro del mismo reproductor y después continúa exactamente donde se detuvo. Cuando entran varios anuncios seguidos, Google llama a ese grupo conjunto de anuncios (en inglés, ad pod), que es como un bloque de comerciales.

¿Quién decide la hora de las pausas? En Ad Manager, eso lo hacen las reglas de anuncios de video, llamadas ad rules. Indican cuándo y cómo aparecen los anuncios dentro de un video. Puedes elegir horarios fijos, como los segundos 60, 120 y 180, o un intervalo cada cierta cantidad de segundos. También puedes usar cue points, que son marcas dentro del video que muestran los mejores lugares para detenerse, como el final de una escena. El reproductor recibe ese plan en una respuesta VMAP, que funciona como la programación de horarios de las pausas, y el IMA SDK reproduce cada pausa a la hora correcta.

Hay detalles importantes. Las reglas de anuncios de video solo existen en Google Ad Manager 360 con contrato de video avanzado. Para que el mid-roll funcione, Ad Manager necesita saber cuánto dura el video y dónde están los puntos de detención. Puedes registrar los videos en Ad Manager (eso se llama ingesta de contenido) y enviar los códigos cmsid y vid en la etiqueta. O, sin ese registro, puedes enviar la duración del video en segundos (vid_d) y la lista de puntos de detención en milisegundos (allcues). Google dice que la duración debe enviarse para tener mid-rolls.

IMA también necesita saber en qué segundo está el video. Por eso entregas el propio elemento de video a IMA y activas el administrador de anuncios antes de que empiece el contenido, porque ahí es donde empieza a contar el tiempo. El mid-roll tiene sentido en videos en los que la persona se queda mucho tiempo viendo. Piensa siempre en quien está viendo: Ad Manager deja limitar cuántos anuncios entran en cada intervalo, cuánto puede durar cada uno y usar límites de frecuencia por intervalo, por video o por ambos.

Paso a paso

Cómo implementarlo

Activa las reglas de anunciosEn Ad Manager 360, ve a Administrador, Video y audio, Configuración de audio y video. Activa la opción Reglas de anuncios y guarda.
Crea una regla estándarVe a Video, Reglas de anuncios, Nueva regla de anuncio. Ponle un nombre, elige Estándar como tipo, elige la prioridad y marca Anuncios intermedios de video como Activar.
Elige cuándo entran las pausasEn la frecuencia de los mid-rolls, elige En horarios fijos, Cada n segundos, En puntos de inserción fijos o Cada n puntos de inserción. Después define el conjunto: Número máximo de anuncios y Duración máxima del anuncio. Los tiempos deben ser números enteros.
Envía la duración y los puntos en la etiquetaEn la etiqueta, pide reglas de anuncios con ad_rule=1. Si los videos no están registrados en Ad Manager, indica la duración en segundos (vid_d) y los puntos de detención en milisegundos (allcues). Si los videos están registrados, envía cmsid y vid.
Conecta IMA al videoEntrega a IMA el elemento de video, que informa el tiempo actual del video. Activa el administrador de anuncios antes de reproducir el contenido, porque ahí IMA empieza a seguir el tiempo.
Pausa y reanuda en las pausasPausa el video cuando IMA pida pausa y vuelve a reproducirlo cuando pida continuar. Así cada pausa entra y sale en el momento correcto.

Ejemplo implementado

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

Va en el mismo código del reproductor con IMA: cambia solo la etiqueta (con ad_rule=1, vid_d y allcues) y el elemento de video se entrega a IMA para que sepa el tiempo.

<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<script>
  // Vídeo de 10 minutos (vid_d=600)
  // com intervalos em 2 e 5 minutos (allcues em ms)
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = 'https://pubads.g.doubleclick.net/gampad/ads?' +
      'iu=/1234567/exemplo&sz=640x480&env=vp&gdfp_req=1' +
      '&ad_rule=1&output=vmap&vid_d=600&allcues=120000,300000' +
      '&unviewed_position_start=1&vpa=click&vpmute=0&plcmt=1' +
      '&description_url=https%3A%2F%2Fwww.exemplo.com%2Fvideo&correlator=';
  adsRequest.linearAdSlotWidth = 640;
  adsRequest.linearAdSlotHeight = 400;
  adsLoader.requestAds(adsRequest);

  adsLoader.addEventListener(
      google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
      function (e) {
        // O próprio <video> informa o tempo atual (currentTime) ao IMA
        adsManager = e.getAdsManager(video);
        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_PAUSE_REQUESTED,
            function () { video.pause(); });
        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_RESUME_REQUESTED,
            function () { video.play(); });
      });

  // No clique de play: init() antes de tocar o conteúdo
  // adDisplayContainer.initialize();
  // adsManager.init(640, 360, google.ima.ViewMode.NORMAL);
  // adsManager.start();
</script>

En el escritorioEl video se pausa en el punto marcado, el anuncio se reproduce en el mismo reproductor y, cuando termina, el contenido continúa donde se había detenido.

En el celularFunciona igual dentro del reproductor del celular. Si la persona arrastra la barra del video hacia adelante y el reproductor no lo maneja, varias pausas pueden reproducirse una tras otra.

Lo que recomienda Google

Qué se puede y qué no

Sí se puede

Elegir las pausas por horarios fijos, cada N segundos, en cue points fijos o cada N cue points.
Servir mid-roll sin registrar los videos en Ad Manager, enviando vid_d y allcues en la etiqueta.
Definir cuántos anuncios entran en cada pausa y cuánto puede durar cada uno.
Usar un límite de frecuencia por pausa, por video o por ambos.
Desactivar el inicio automático de las pausas en IMA y decidir en el momento si cada pausa lista se reproduce.

No se puede

No se puede tener mid-roll sin informar la duración del contenido: Google dice que vid_d debe enviarse para los mid-rolls.
Las reglas de sesión no sirven para mid-roll: solo se pueden aplicar al pre-roll.
No se pueden dejar los controles del video y del anuncio cubiertos, ocultos o sin funcionar.
No se puede avisar el fin del contenido cuando quien terminó fue un anuncio: ese aviso es solo para el fin del video.

Consejos

Para hacerlo bien

Cuando la persona arrastre la barra, guarda el tiempo desde donde empezó e informa ese tiempo a IMA hasta que el video vuelva a la normalidad. Así no se reproducen varias pausas seguidas.
En Safari del celular, la detección de arrastre del video no funciona bien. La guía de IMA muestra una forma manual de detectar el arrastre.
Si registras los videos en Ad Manager, revisa en Video, Contenido si Duración y Puntos de inserción de anuncios intermedios se importaron bien.
Existe una opción beta, Especificar la configuración del último anuncio intermedio, para que el último intervalo tenga configuración propia. No entra en la previsión de inventario.

Cuidado

Errores comunes

Avisar el fin de contenido al final del anuncio

El aviso de fin de contenido es solo para cuando el video termina. Como IMA puede usar el mismo reproductor para los anuncios, avisar al final de un anuncio confunde al SDK.

Reproducir el video antes de conectar IMA

IMA solo empieza a seguir el tiempo cuando se activa el administrador de anuncios. Por eso Google pide activarlo siempre antes de reproducir el contenido.

Reproductor que cambia el tiempo mientras se arrastra

Si tu reproductor actualiza el tiempo durante el arrastre de la barra, Google recomienda entregar a IMA un objeto propio que informe el tiempo correcto.

Buscar reglas de anuncios en una cuenta sin 360

Las reglas de anuncios de video son solo de Google Ad Manager 360 con contrato de video avanzado. En una cuenta común, esa opción no aparece.

Preguntas frecuentes

¿Necesito registrar mis videos en Ad Manager?

No. Google dice que la ingesta de contenido no es obligatoria para mid-rolls con reglas de anuncios. Sin ella, envía la duración (vid_d) y los puntos de detención (allcues) en la etiqueta.

¿Qué es un cue point?

Es una marca en un punto del video que indica que ahí puede entrar una pausa. En la etiqueta, los cue points van en milisegundos, separados por coma, como 10000,20000.

¿Se puede tener mid-roll sin las reglas de anuncios?

Google dice que las reglas de anuncios son necesarias para que Ad Manager devuelva mid-rolls, y son una función de Ad Manager 360. La duración del video (vid_d) también debe enviarse.

¿Cuántos anuncios entran en cada pausa?

Decides en el conjunto con Número máximo de anuncios. La opción Sin valor máximo solo existe en los Conjuntos optimizados, que también permiten limitar la duración total del intervalo.

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