El disparador de vídeo de YouTube en Google Tag Supervisor

Última actualización: 20 de abril de 2020:Aclarado cómo Vídeos de carga lenta Se puede rastrear con este disparador.

Vayamos directo al grano. Administrador de etiquetas de Google acaba de lanzar el Vídeo de YouTube Set off, que te brinda soporte nativo para el seguimiento de movies de YouTube. ¡Y es genial! Aunque hemos estado más que satisfechos con los excelentes scripts de seguimiento proporcionados por eg Camino cardinal y Generoso (con un pequeña modificación De su servidor), este es un No es ninguna tontería para soporte nativo en Google Tag Supervisor.

El disparador de video de YouTube cumple con prácticamente todos los requisitos que esperaría de un disparador de seguimiento de video. Tiene eventos integrados para cosas como Inicio, Progreso (por ejemplo, 25 %, 50 %, 75 %) y Finalizado. También puedes usarlo para decorar las URL de YouTube incrustadas con los elementos necesarios. enablejsapi=1 parámetro de consulta, si aún no lo tienen.

El disparador de video de YouTube admite el seguimiento Cargado con pereza o también vídeos insertados dinámicamente, lo que será un alivio para los sitios que posponen la carga de los vídeos hasta que el usuario realmente interactúa con ellos.

incógnita

El boletín informativo de Simmer

Suscríbete a la Boletín informativo de Simmer ¡Para recibir las últimas noticias y contenidos de Simo Ahava en tu bandeja de entrada de correo electrónico!

Crear y configurar el disparador

Para crear el activador, desplácese hasta Activadores en la interfaz de usuario de Google Tag Supervisor y cree un nuevo activador. Encontrará la opción Vídeo de YouTube en la barra lateral que aparece cuando hace clic para elegir un tipo de activador.

Una vez que hayas seleccionado el tipo de activador de vídeo de YouTube, es momento de configurarlo. Estas son las opciones.

1. Captura – Iniciar – recoge una begin Cuando el usuario comienza a ver el vídeo.

2. Captura – Completa – recoge una full cuando el usuario llega al remaining del vídeo.

3. Captura: pausa, búsqueda y almacenamiento en búfer – recoge una pause cuando el usuario pausa el video o salta hacia adelante o hacia atrás, y buffering cuando el video comienza a almacenarse en búfer debido a la falta de ancho de banda.

4. Captura – Progreso – recoge una progress el momento en que el usuario pasa un umbral de porcentaje o de tiempo (por ejemplo, 25 %, 50 %, 75 % o marca de 10 segundos, marca de 30 segundos, marca de un minuto).

5. Avanzado: agregar compatibilidad con API de JavaScript a todos los movies – si tus incrustaciones de YouTube carecen de lo necesario enablejsapi=1 parámetro, puedes marcarlo para agregarlo automáticamente a todos tus movies. ¡NOTA! Esto vuelve a cargar el iframe, por lo que los usuarios pueden ver el video parpadear cuando cargan la página por primera vez. Esta opción, cuando está marcada, también agrega el archivo requerido https://www.youtube.com/iframe_api biblioteca a la pagina.

Esto es lo que cube dataLayer La carga útil se ve como siempre que se activa un evento de YouTube.

• occasion: 'gtm.video' – el nombre del evento introducido dataLayer para todos los eventos de video de YouTube. Esto es lo que activa el disparador de YouTube.

• gtm.videoProvider: 'youtube' – especifica la plataforma cuyos movies estás siguiendo. ¡Esto puede ser una pista de que está previsto que se admitan otras plataformas!

• gtm.videoStatus: 'begin' – especifica el estado del video que provocó que se activara el evento. Estos diferentes valores de estado solo se activan si los ha habilitado en la configuración del activador. Los valores posibles son 'begin', 'full', 'pause', 'buffering'y 'progress'.

• gtm.videoUrl: 'https://www.youtube.com/watch?v=...' – la URL unique del vídeo incrustado.

• gtm.videoTitle: 'Better of Simo Ahava' – el título del vídeo incrustado.

• gtm.videoDuration: 197 – la duración complete del vídeo en segundos.

• gtm.videoCurrentTime: 30 – la marca de tiempo en la que se encontraba el usuario cuando ocurrió el evento de vídeo.

• gtm.videoElapsedTime: 10 – el tiempo transcurrido desde la última vez que el vídeo se pausó o almacenó en búfer.

• gtm.videoPercent: 15 – la marca de porcentaje en la que se encontraba el usuario cuando ocurrió el evento de video.

• gtm.videoVisible: true – cualquiera true o falsedependiendo de si el video estaba seen o no en la ventana gráfica del navegador cuando ocurrió el evento de video.

Una cosa que podría hacerte respirar mejor es que hay nuevas Variables incorporadas para todos estos artículos en el dataLayerPuedes encontrarlos haciendo clic en el botón rojo. CONFIGURAR Botón al navegar a Variables / Variables integradas en la interfaz de usuario de Google Tag Supervisor.

Unas breves palabras sobre el seguimiento del progreso

Tenga en cuenta que el seguimiento progreso es relativo a la duración complete del video y no al tiempo actual o al porcentaje que has estado viendo el video.

Entonces, si configura el disparador para que se energetic al 25 %, 50 % y 75 %, activará esos eventos cuando el usuario alcance las marcas respectivas en la línea de tiempo del video. Incluso si no lo han visto continuamente desde el principio.. Por lo tanto, si comienzas a reproducir un video y saltas directamente a la marca del 25 %, el evento se activará aunque recién hayas comenzado a mirarlo.

Lo mismo se aplica a los umbrales de tiempo.

Puedes aprovechar la Tiempo transcurrido del vídeo Variable para ver cuánto tiempo ha estado el usuario viendo el video de forma continua desde la última pausa. El uso de los umbrales de tiempo y porcentaje solo le indica si el usuario alcanzó un hito específico en el video, no necesariamente si realmente lo vio hasta ese punto. Es una diferencia pequeña pero potencialmente significativa.

Poniéndolo todo junto

Dado que hay tantas combinaciones de eventos que puedes recopilar con el disparador de video de YouTube, te mostraré una forma bastante genérica de medir comenzar, pausa, porcentaje de progreso y completo eventos con una sola etiqueta de evento de Common Analytics. La etiqueta se ve así:

El disparador que activa esta etiqueta se ve así:

Y el Variable de JavaScript personalizada nombrado {{JS – Obtener acción de video}} Se ve así:

perform() {
  var standing = {{Video Standing}};
  change (standing) {
    case 'begin':
      return 'Begin taking part in';
    case 'pause':
      return 'Pause';
    case 'buffering':
      return 'Buffering';
    case 'progress':
      return 'Reached ' + {{Video P.c}} + '%';
    case 'full':
      return 'Reached the tip';
  }
}

Esto traduce los valores de los parámetros predeterminados del objeto de video en dataLayer a un formato más legible. De esta manera, podemos usar la misma etiqueta de evento para todos los eventos de video.

Seguimiento de vídeos cargados de forma diferida o insertados dinámicamente

Si sus movies se cargan durante la carga inicial de la página, entonces todo irá sobre ruedas. Al verificar la Añadir compatibilidad con API de JavaScript a todos los vídeos Opción: GTM se encargará de inicializar los movies para que el disparador pueda rastrearlos. Esta opción también descarga la biblioteca API necesaria (ver a continuación).

Sin embargo, cada vez más sitios se preocupan por el rendimiento y posponen la carga de cualquier contenido integrado hasta que el usuario haya indicado que desea ver el video. Puede leer sobre las implicaciones técnicas aquí.

Afortunadamente, el activador de video de YouTube admite el seguimiento de movies que se cargan e incrustan después de la carga inicial de la página. Lo único que debe hacer es asegurarse de que, cuando se cargue la página por primera vez, también se cargue la API de iframe de YouTube:

Por lo tanto, si su sitio carga movies de forma diferida o dinámica (por ejemplo, si se trata de una aplicación de una sola página), asegúrese de que la biblioteca anterior se cargue antes de que se inicialice el disparador de video de GTM. Un disparador de “Vista de página” suele ser suficiente.

Nuevamente, si hay un video incrustado de YouTube presente durante la carga inicial de la página, no tiene que preocuparse por esto. Añadir compatibilidad con API de JavaScript a todos los vídeos se encarga de cargar esta biblioteca para usted.

El disparador de YouTube no funciona

Si por alguna razón el disparador no rastrea tus incrustaciones de YouTube, puedes usar el siguiente método para investigar el problema.

1. Comprueba que el sitio haya cargado el https://www.youtube.com/iframe_api biblioteca.

2. Comprueba que los iframes de YouTube tengan el enablejsapi=1 parámetro en el src atributo.

3. Comprueba que los iframes de YouTube tengan un parámetro que se parezca a data-gtm-yt-inspected-XXXXXX.

Si los tres son correctos, generalmente significa que hay algo en el sitio recargas el iframe después de que GTM lo haya inspeccionado. Cuando Google Tag Supervisor inicializa el activador de video, inicializa el detector en la incrustación. Cualquier recarga de la incrustación elimina este detector y, dado que el iframe tiene el data-gtm-yt-inspected-XXXXXX atributo, GTM no reevalúa al oyente.

Hable con los desarrolladores y asegúrese de que los iframes no se “reciclen” (el mismo elemento iframe utilizado para varios movies) y que, una vez que se haya agregado el iframe al sitio, no se vuelva a cargar por ningún motivo.

Resumen

Estoy muy contento con el activador de video de YouTube. Hace prácticamente todo lo que esperaba de la primera versión de la función. Espero que en el futuro veamos compatibilidad con otros servicios y reproductores de video.

No echo mucho de menos. Principalmente, me gustaría que hubiera un gtm.videoTotalElapsedTimeque mediría cuánto en complete He estado viendo un vídeo determinado. gtm.videoElapsedTime Solo me cube el tiempo transcurrido desde la última pausa/buffer/búsqueda, pero no cuál fue el tiempo complete visto.

¿Qué opinas del activador de vídeo de YouTube? ¿Es perfecto para tus necesidades de seguimiento o tienes en mente funciones que te gustaría ver en una versión futura?