Complemento de Google Tag Manager para Brightcove Player

Resumen

El Administrador de etiquetas de Google (GTM) le permite realizar un seguimiento del uso de sus sitios web, contenido de video y aplicaciones móviles. Primero, agrega una etiqueta de contenedor a sus activos. Luego, utiliza una interfaz de usuario basada en la web para personalizar las etiquetas individuales asociadas con su etiqueta de contenedor según sus reglas comerciales.

Estos son algunos ejemplos de etiquetas:

• Código de seguimiento universal de Google Analytics
• Código de seguimiento de conversión y/o remarketing de Adwords
• Secuencias de comandos HTML personalizadas

Si es nuevo en GTM, revise el documento de descripción general del Administrador de etiquetas de Google.

Si ya está utilizando Google Analytics, Adwords y DoubleClick, es posible que también desee utilizar Google Tag Manager porque se integra bien con estas herramientas. GTM ofrece una gran cantidad de opciones variables y de activación.

Principales pasos de implementación

Desde un alto nivel, estos son los pasos principales que debe seguir para implementar y usar GTM:

1. Cree una cuenta de GTM y configure un contenedor: ambos son parte de la configuración inicial de GTM
2. Copie y pegue los fragmentos de contenedor que deben implementarse en sus páginas web. Google sugiere que este código se coloque en el <cabeza> etiqueta o inmediatamente después de la apertura <cuerpo> etiqueta.
3. Crear etiquetas - para Google Analytics o Brightcove Player
4. Publica tus etiquetas.

Para obtener detalles sobre la configuración, consulte el documento Configurar e instalar Tag Manager de Google.

Trabajar con Brightcove Player

El complemento GTM de Brightcove le permite realizar un seguimiento de los eventos de Brightcove Player mediante el panel de control de Google Analytics. Se pueden rastrear los siguientes eventos de jugador:

• Carga del jugador
• Impresión de video
• Vista de video
• Participación de video
• Solicitud de reproducción
• Video completo
• Eventos avanzados del reproductor, como el inicio y el final del anuncio
• Errores que interrumpen la experiencia de reproducción

Requisitos

Se necesitan los siguientes requisitos para usar el complemento GTM:

• Brightcove Player v6.46.0 o posterior

Empezar

Para configurar Google Tag Manager, siga estos pasos:

Pasos

1. En Administrador de etiquetas , cree una cuenta o use una cuenta existente. Para crear una nueva cuenta, haga clic en el botón Crear cuenta .

   De forma predeterminada, se crea un nuevo contenedor para una nueva cuenta. Puede crear contenedores adicionales dentro de cada cuenta.

   

2. Ingrese los valores para la página de su nueva cuenta, incluidos el nombre de la cuenta y el nombre del contenedor, y seleccione una plataforma de destino.

   

3. Haga clic en el Crear botón.
4. Acepte los términos del servicio.
5. Aparece el cuadro de diálogo Instalar Google Tag Manager . Desde aquí, deberá copiar los fragmentos y colocarlos en las ubicaciones especificadas.

   

6. Si alguna vez necesita volver a los fragmentos, haga clic en el ID del contenedor en el panel de control de GTM.

   

Revisión de eventos y dimensiones

Elija los eventos y las dimensiones que desea rastrear desde Brightcove Player.

Eventos

Cualquier nombre de evento utilizado por los jugadores de Brightcove analytics-beacon Se puede usar el evento, pero los siguientes tienen un manejo especial en el complemento GTM.

Dimensiones

Las siguientes dimensiones se enviarán para todos los eventos (excepto error)

Dimensiones específicas del evento

Estas dimensiones personalizadas se enviarán en eventos específicos.

Creación de variables, etiquetas y disparadores

Cada evento de Brightcove que desee rastrear debe crearse como una etiqueta de evento en Google Tag Manager (GTM). Los ID de eventos de GTM se utilizarán dentro del módulo de Jugadores. Esto permite que los datos de eventos de Brightcove se pasen a los eventos de GTM.

Para cada etiqueta de evento, debe crear un activador GTM para enviar el evento a Google Analytics. Luego, en el GTM Variables pestaña, creará los parámetros personalizados asociados con cada evento.

Agregar variables a GTM

Los parámetros de Brightcove transportan datos adicionales y se transmiten con eventos. Cada parámetro de Brightcove que se registrará debe crearse como una variable en Google Tag Manager. El nombre del parámetro se utilizará dentro del reproductor, lo que permitirá que los parámetros de Brightcove se pasen a las variables de Google Tag Manager.

Para crear variables en Google Tag Manager, siga estos pasos

1. Inicie sesión en su cuenta de Google Tag Manager

2. Haga clic en Variables en la navegación del lado izquierdo.

3. En la sección Variables definidas por el usuario , haga clic en el botón Nuevo .

   

4. Para tipo variable , seleccionar Variable de capa de datos.

   

5. Estos son los detalles de configuración:

   • Nombre de variable de capa de datos - Nombre de la variable
   • Versión de la capa de datos - Versión 2

6. Primero, cree tres variables definidas por el usuario llamadas; Acción de evento , Categoría de evento y Etiqueta de evento . La configuración debería ser similar a esto.

   • Acción de evento - eventAction
   • Categoría de evento - eventCategory
   • Etiqueta de evento - eventLabel

   

7. Luego cree las variables requeridas para reflejar los parámetros de Brightcove. En este caso, el nombre de la variable de capa de datos debe coincidir con lo que está en la configuración JSON del reproductor para paramsToTrack después de customDimensions en la variable GTM. He aquí un ejemplo:

   

8. Parámetros de Brightcove que puede crear como variables de GTM:

   • Cuenta : ID de cuenta de Brightcove
   • Jugador - ID de jugador
   • Nombre del jugador - Nombre del jugador
   • Versión de la plataforma - Número de versión de la plataforma
   • Sesión - Identificador de sesión
   • Video - ID de video
   • Nombre del video - Nombre del video
   • Distancia - El rango de segundos visualizados en el formato StartSecond..EndSecond
   • Segundos de video vistos - Cuenta de segundos vistos
   • Duración del video - La duración del video en segundos.
   • Porcentaje de video visto - Porcentaje de video visto
   • Código de error - Código de error específico de la plataforma asociado con el evento
   • Hito del video - Hito (25%, 50%, 75%, 100%) completado por el video
   • Cabezal de reproducción de video - La hora en el video en la que se activa el evento.
   • Destino - URI que originó el evento

9. Sus variables definidas por el usuario deben tener un aspecto similar a esto en GTM:

   

Agregar etiquetas a GTM

Después de determinar qué eventos desea rastrear, las etiquetas deben crearse en Google Tag Manager.

Para crear etiquetas en Google Tag Manager, siga estos pasos

1. Inicie sesión en su cuenta de Google Tag Manager

2. Haga clic en Etiquetas en la barra de navegación del lado izquierdo y haga clic en el botón Nuevo .

3. Selecciona el Tipo de etiqueta como Google analitico: Universal Analytics.

   

4. Ingrese los detalles de la etiqueta:

   • Tipo de pista - Ajustado a Evento
   • Categoría - Variable de categoría de evento
   • Acción - Variable de acción de evento
   • Etiqueta - Variable de etiqueta de evento
   • Valor - Nulo
   • Hit sin interacción - Ajustado a Cierto
   • Configuración de Google Analytics - Configuración predeterminada
   • ID de rastreo - ID de seguimiento del panel de GA. Seleccione Variable de ID de seguimiento.

5. Vaya a Configuración avanzada y establezca los índices de dimensión personalizada y los valores de dimensión relacionados. Estos índices deben coincidir con lo que está en Google Analytics.

6. Sus etiquetas deberían tener un aspecto similar a esto en GTM:

   

Agregar activadores a GTM

Para cada evento del que desee realizar un seguimiento, también necesita un activador en Google Tag Manager.

Para crear activadores en Google Tag Manager, siga estos pasos

1. Inicie sesión en su cuenta de Google Tag Manager

2. Haga clic en Desencadenadores en la barra de navegación del lado izquierdo y haga clic en el botón Nuevo .

3. Selecciona el Tipo de disparador como Evento personalizado.

   

4. Introduzca el nombre del evento; el nombre del evento debe ser similar a la imagen de abajo.

   

5. Cree un disparador para cada evento del que desee realizar un seguimiento.

6. Sus activadores deberían tener un aspecto similar a esto en GTM:

   

Integración con Brightcove

Para integrar GTM con Brightcove Player, agregue el complemento Google Tag Manager a su reproductor.

Uso de Studio

En los siguientes pasos se detalla el uso de Video Cloud Studio para cargar el complemento.

1. En Video Cloud Studio, abra el JUGADORES módulo y cree un nuevo reproductor o localice el reproductor al que desea agregar el complemento.
2. Haz clic en el enlace del reproductor para abrir las propiedades del reproductor.
3. Haz clic en Plugins en el menú de navegación izquierdo.

4. A continuación, haga clic en el botón Agregar un complemento y luego seleccione Complemento de Brightcove .

   

5. Ampliar la Complemento Brightcove desplegable y seleccione Administrador de etiquetas de Google.

   

6. Para decirle al jugador qué eventos y dimensiones personalizadas desea rastrear, cree un objeto JSON para pegarlo en el Opciones (JSON) caja de texto.

   Descripciones de campos:

   • tracker- Su ID de seguimiento de Google Tag Manager (GTM-XXXXXXX)
   • eventsToTrack- Eventos de los que desea realizar un seguimiento
   • paramsToTrack- Dimensiones personalizadas que desea rastrear
   • milestones - Una matriz de números enteros para modificar los hitos del valor predeterminado de 25, 50, 75, 100 %. Por supuesto, esto solo es aplicable cuando se realiza un seguimiento de bcvideo_video_milestone .

   He aquí un ejemplo:

    { 
     "tracker":"your Google Tag Manager id", 
     "eventsToTrack": {
       "ad_end": "Ad End",
       "ad_start": "Ad Start",
       "error": "Error",
       "play_request": "Play Request",
       "player_load": "Player Load",
       "video_complete": "Video Complete",
       "video_engagement": "Video Engagement", "video_impression": "Video Impression", "video_view": "Video View"
     },
     "paramsToTrack": {
       "bcvideo_video_duration": "duration",
       "bcvideo_error_code": "error",
       "bcvideo_account": "account",
       "bcvideo_session": "session",
       "bcvideo_video_milestone": "milestone", "bcvideo_video_name": "video_name",
       "bcvideo_range": "range",
       "bcvideo_video_seconds_viewed": "seconds_viewed", "bcvideo_player_name": "player_name",
       "bcvideo_video_percent_viewed": "percent_viewed", "bcvideo_destination": "destination",
       "bcvideo_video_playhead": "playhead"
     }
    
    }

7. Haga clic en el Ahorrar botón. Ahora verá el Administrador de etiquetas de Google complemento agregado a la lista de complementos para su reproductor.

   

8. Para publicar el reproductor, seleccione Publicar e incrustar > Publicar cambios.
9. Para cerrar el cuadro de diálogo, haga clic en Cerrar .

10. Regrese al módulo MEDIOS y publique su video o lista de reproducción usando el reproductor que acaba de actualizar para Google Tag Manager.

    Cuando el reproductor se carga y el usuario interactúa con el reproductor, se realizará un seguimiento de los eventos y parámetros especificados.

Creando dimensiones personalizadas

Las dimensiones personalizadas son métricas que crea usted mismo en Google Analytics. Hay dos formas de agregar dimensiones personalizadas, la primera es agregar las dimensiones directamente en Google Analytics y la otra es usar Google Scripts.

Agregar dimensiones personalizadas con Google Analytics

Para agregar las dimensiones personalizadas directamente en Google Analytics, siga estos pasos:

1. Inicie sesión en Google Analytics.

2. Hacer clic Administración.

   

3. Haga clic en Definiciones personalizadas para expandirlo, luego seleccione Dimensiones personalizadas.

   

4. Haga clic en el botón Nueva dimensión personalizada .

   

5. Ingrese el nombre de la dimensión personalizada y luego haga clic en Crear . Google Analytics asignará un número de índice automáticamente. Deberá crear una dimensión personalizada para cada parámetro que desee rastrear.

   

Adición de dimensiones personalizadas con Google App Script

Para utilizar Google App Script para crear dimensiones personalizadas, siga estos pasos:

1. Si es nuevo en las dimensiones personalizadas, revise las dimensiones personalizadas de Google & documento de métricas .
2. Inicie sesión en Google.

3. Navega al Centro de desarrolladores de G Suite y seleccione el nuevo proyecto en blanco de Apps Script.

   

4. Seleccione Proyecto sin título y dale un nombre a tu proyecto.

   

5. Copie el siguiente código de secuencia de comandos de la aplicación personalizada en un editor y actualice los siguientes valores:

   • accountId- Su ID de cuenta de Google Analytics
   • webPropertyId- ID de seguimiento de su cuenta de Google
   • dimensions- Las dimensiones personalizadas que se agregarán. La lista actual contiene todas las dimensiones personalizadas. Observe que las dimensiones tienen el prefijo bcvideo_. Esto es para asegurar que no haya conflictos de nombres con estas variables.

    //Set values for GA Account ID and web property ID to which you have to set custom dimensions.
    var accountId='your account id'; var webPropertyId='your tracking code'; 
    //Add required custom dimensions to be created to this list 
    var dimensions=['bcvideo_video_seconds_viewed','bcvideo_video_playhead','bcvideo_account','bcvideo_player','bcvideo_player_name','bcvideo_video','bcvideo_video_name','bcvideo_session','bcvideo_platform_version','bcvideo_range','bcvideo_video_duration', 'bcvideo_video_percent_viewed','bcvideo_error_code','bcvideo_milestone','bcvideo_destination']; 
    //Function to create custom dimensions in GA 
    function createGACustomDimensions() {
    //This loop iterates through the custom dimensions in order to set the custom dimension scope, active values into our GA property 
    for(var index=0;index<dimensions.length;index++){ 
     var customDimensions ={
       'name': dimensions[index],
       'scope':'HIT',
       'active':true,
    }
    //This create a request to the new custom dimension Analytics.Management.CustomDimensions.insert(customDimensions,accountId,webPropertyId); 
    // Pause for 1 second between adding each custom dimension, this ensure that the GA property has time 
    // to process the request fully before moving to the next custom dimension.
    Utilities.sleep(1000)
    }
    }

6. Reemplace la function myFunction(){} bloque de código, como se muestra a continuación, con la secuencia de comandos de su aplicación personalizada.

    function myFunction() { }

7. Guarde el proyecto. Debe guardar el proyecto para poder utilizar la API de Google Analytics.

8. Para habilitar la API de Google Analytics, en el editor de secuencias de comandos, seleccione Recursos > Servicios avanzados de Google.

   

9. Entonces busca Servicios avanzados de Google y darle la vuelta en. Hacer clic OK.

   

10. Para ejecutar el script de su aplicación, haga clic en Ejecutar > Ejecute la función y elija su script.

    

11. En el cuadro de diálogo de autorización, haga clic en Revisar permisos .

    

12. Haga clic en el botón Permitir .

    

Ver dimensiones personalizadas

Para ver dimensiones personalizadas en Google Analytics, siga estos pasos:

1. Inicie sesión en Google Analytics.

2. Haga clic en Administrador

   

3. Haga clic en Definiciones personalizadas para expandirlo, luego seleccione Dimensiones personalizadas.

   

4. Debería ver las dimensiones personalizadas junto con sus índices asociados.