Snowplow Analytics: plantilla de etiqueta personalizada

El Análisis de quitanieves plantilla de etiqueta personalizada es un oficial plantilla de etiqueta para Administrador de etiquetas de Google galería de plantillas comunitarias.

Descripción

Esta plantilla implementa el Rastreador de JavaScript de Snowplow Analytics. La plantilla admite todas las funciones del rastreador, con algunas excepciones debido a las limitaciones del JavaScript en el espacio aislado de las plantillas personalizadas.

Instalar la plantilla

A instalar la plantillanavegar a Plantillas en la interfaz de usuario de Google Tag Supervisor.

Bajo Plantillas de etiquetashaga clic Buscar en la galeríay escriba snowplow en la barra de búsqueda superpuesta de la galería.

Haga clic en el Análisis de quitanieves nombre de la plantilla y luego haga clic en Agregar al espacio de trabajo en la siguiente pantalla. Revise los permisos y haga clic Agregar para finalizar la importación.

Después de importar la plantilla, puede seguir el proceso regular de creación de una nueva etiqueta en Google Tag Supervisor y el Análisis de quitanieves La plantilla aparecerá entre las Costumbre tipos de etiquetas entre los que puede elegir.

Advertencias

Para empezar, algunas de las advertencias sobre el uso de la plantilla personalizada.

• Cualquier método que requiera el análisis de elementos HTML (por ejemplo, funciones de filtro de seguimiento de enlaces) no funcionarán y, por lo tanto, estarán deshabilitados.
• El seguimiento automático de errores no funciona debido a la falta de soporte para el ErrorEvent Asignación de funciones.
• No existe implementación para el comercio electrónico estándar eventos. Se anima a los usuarios a implementar la comercio electrónico mejorado configuración en su lugar.

Instrucciones

A continuación se ofrecen instrucciones básicas sobre cómo instrumentar el rastreador de JavaScript. Se le anima a consultar el documentación técnica para obtener más información sobre cada característica particular person.

En basic, cuando se activa la etiqueta, primero verifica si la biblioteca JavaScript de Snowplow se ha cargado desde la URL alojada automáticamente proporcionada en la configuración de la plantilla (más información sobre esto a continuación). Luego, la etiqueta verifica si un rastreador con la URL dada Nombre del rastreador ya ha sido inicializado. En caso contrario se procede a inicializar el nuevo rastreador.

Finalmente, la etiqueta agrupa una dominio desde la configuración de la etiqueta y lo envía al destino indicado Punto closing del recopilador.

Nombre del rastreador

El primer campo requiere que agregue el nombre del rastreador. La razón por la que podría generar más de un nombre de rastreador en el sitio es si tiene diferentes objetos de configuración o puntos finales de seguimiento a los que desea enviar comandos.

Cuando se ejecuta la etiqueta, primero verifica si ya se ha inicializado una etiqueta con este nombre. Si es así, procede a enviar el comando a este nombre de rastreador. Si un rastreador con este nombre tiene no inicializado, se inicializa un nuevo rastreador con la configuración del rastreador derivada de la etiqueta (o del enlace Variable de configuración de análisis de quitanieves).

Esto significa que se aplica una configuración de rastreador. sólo una vez al rastreador. Por lo tanto, si tiene más de una etiqueta ejecutándose en el sitio, cada una con el mismo nombre de rastreador pero con diferentes configuraciones de rastreador, solo se mostrará la configuración de la etiqueta que se activa. primero Se aplicará al rastreador.

Nombre de host del punto closing del recopilador

Esto debe configurarse con el nombre de host (por ejemplo, www.area.com) en el que has configurado el Recolector de análisis de quitanieves.

Configuración avanzada

Saltando al closing de la plantilla, el Configuración avanzada El grupo tiene dos configuraciones importantes:

1. Nombre del método international: Si desea cambiar el espacio de nombres international de snowplow a otra cosa (debido a un conflicto, por ejemplo), cambie el valor en este campo.
2. URL de biblioteca autohospedada:Debes alojar tú mismo la biblioteca JavaScript de Snowplow. Establece este campo con la URL desde la que el navegador descargará la biblioteca JavaScript.

Actualizar permisos

Si cambias el Nombre del método international de snowplow a cualquier otra cosa, necesitas hacer un cambiar a la plantillaAbra la plantilla para editarla (desde la sección “Plantillas” del contenedor) y navegue hasta la Permisos pestaña. Bajo Accede a variables globalesedite los cuatro permisos que comienzan con el nombre snowplow.

Cambiar el texto snowplow a cualquiera que sea el nombre de su método preferido (debe coincidir con el nombre establecido en la etiqueta una vez que lo cree). Recuerda dejar todo lo demás como está: permisos y sufijos. Así es como se vería la lista modificada si el nombre del método se cambiara a some_other_snowplow:

ACTUALIZACIÓN 18 de mayo de 2020:La plantilla se ha actualizado para tener AWS Cloudfront y Almacenamiento en la nube de Google destinos admitidos de forma predeterminada (https://*.cloudfront.web/* y https://storage.cloud.google.com/*). Si carga la biblioteca desde cualquier ubicación, no no Es necesario actualizar los permisos para injectScript!

A continuación, una vez que tengas la biblioteca Snowplow autohospedadonecesitas actualizar el Inyecta scripts permiso para reflejar la nueva ubicación. Eliminar el contenido del Patrones de coincidencia de URL permitidos campo y escriba la URL completa de la biblioteca allí. Nuevamente, debe coincidir con lo que ingresa en la etiqueta al crearla.

Desafortunadamente, modificar permisos rompe el enlace de la galería y ya no recibirás notificaciones sobre actualizaciones de la plantilla. Poder modificar los permisos sin que se rompa el enlace es una solicitud de función que espero que se resuelva muy pronto.

Tipo de etiqueta

Bajo Tipo de etiqueta, puede elegir qué tipo de comando se compila y se envía al punto closing. Los tipos de etiquetas se dividen aquí en tres grupos: comandos que utilizan un código común parámetros objeto, comandos que tienen condiciones especialesy comandos personalizados.

Etiquetas con un objeto de parámetro

Las etiquetas que pueden derivar sus parámetros de una variable de Google Tag Supervisor son:

• Seguimiento de anuncios
• Seguimiento del carrito de compra
• Seguimiento de errores
• Consentir
• Evento autodescriptivo
• Búsqueda de sitio
• Interacción social
• Evento estructurado
• Momento

Puedes configurar el Recuperar parámetros de una variable Ajuste de una variable de Google Tag Supervisor. Este parámetro debe Devuelve un objeto. En el objeto, los pares clave-valor deben reflejar los parámetros nombrados en el documentación del evento. Por ejemplo, para que la variable full un Evento de errorpodrías usar una variable JavaScript personalizada como esta:

operate() {
  return {
    message: 'Some Error Occurred',
    filename: 'somefile.js',
    lineno: 5,
    colno: 236,
    error: null
  }
}

Alternativamente, puede configurar el menú desplegable con el valor Noy agregue los parámetros manualmente en su lugar:

Algunos tipos de etiquetas agregarán selecciones adicionales a esta sección. Consulta la documentación oficial del rastreador para obtener más información sobre lo que hace cada opción.

Etiquetas especiales

Algunos tipos de etiquetas tienen condiciones especiales y se han separado en sus propias configuraciones.

Comercio electrónico mejorado

Cuando selecciona Comercio electrónico mejorado, le quedan dos opciones: Utilizar la capa de datos o Elija variable. La forma en que funciona es muy comparable al comercio electrónico mejorado en Google Analytics.

Si elige el primero, la plantilla buscará en el dataLayer estructura para el más reciente empujado Objeto de comercio electrónico mejoradoy asigne este objeto a la solicitud de Snowplow Analytics.

Si seleccionaste Elija variabledebe proporcionar una variable GTM que devuelva un objeto en el formato correcto esperado.

Seguimiento de formularios

El seguimiento de formularios tiene solo dos opciones, porque filtros y transformaciones No funcionará con la plantilla personalizada (debido a la falta de compatibilidad para procesar elementos HTML). Las opciones son para configurar el formulario y/o el campo. listas negras y listas blancas.

Las listas negras y listas blancas para formularios son una lista de nombres de clases HTML separados por comas. Si se incluye en la lista negra, ningún elemento de formulario con una clase incluida en la lista activará el evento de formulario. Si se incluye en la lista blanca, solo Se realizará un seguimiento de los elementos del formulario con un nombre de clase listado.

Para los campos, las listas negras y blancas funcionan de manera comparable, excepto que usan el title atributo en lugar de la clase.

Seguimiento de clics en enlaces

El Haga clic en el enlace de seguimiento El evento es comparable a los eventos regulares basados ​​en parámetros, ya que le permite agregar parámetros y rastrear un clic en un enlace como un impacto codificado manualmente.

El Habilitar el seguimiento automático de clics en enlaces agrega oyentes a la página, que rastrearán los clics en los enlaces permitiéndoles adherirse a los nombres de clase incluidos en la lista negra/lista blanca que puede proporcionar opcionalmente.

El Arreglar el seguimiento del clic central agrega una solución para algunos navegadores donde los clics centrales no se rastreaban correctamente.

Si lo marcas Seguimiento del contenido HTML del enlace en el que se hizo clicentonces el contenido de texto completo del elemento de enlace también se enviará a Snowplow.

Vista de pagina

Puedes proporcionar un Título de página personalizado si lo deseas, y puedes agregar un función de contexto personalizada a la solicitud.

Si lo habilita Seguimiento de actividad de la páginala etiqueta configurará una latido del corazón rastreador y envía pings de página a Snowplow en intervalos que puedes especificar.

El Función de devolución de llamada es algo que puedes configurar como una función de JavaScript. Si configuras la devolución de llamada, en lugar de enviar el ping de la página a Snowplow, se invoca la función.

Comandos personalizados

Aquí está la lista de comandos personalizados que puedes ejecutar, con detalles sobre los argumentos (si hay alguno).

Parámetros de seguimiento adicionales

Puede elegir una variable de Google Tag Supervisor en el menú desplegable titulado Agregar contextos personalizados. Esto le permite agregar contextos personalizados al hit precise. La variable debe devuelve una matriz de objetos de contexto válidos.

También puede optar por anular la marca de tiempo del dispositivo con el Establecer marca de tiempo personalizada campo. El formato debe ser hora UNIX en milisegundos.

Parámetros de configuración del rastreador

En este grupo, puede establecer la configuración del rastreador que se aplica cuando se crea el rastreador por primera vez.

¡NOTA! Si está agregando configuraciones a un rastreador que ya ha sido creado, los campos de configuración no harán nada.

Tienes tres Formas de aplicar la configuración:

1. Usando solo un Variable de configuración de análisis de quitanieves.
2. Utilizando únicamente parámetros agregados manualmente.
3. Usando una combinación de los dos.

Si elige utilizar una variable de configuración de Snowplow Analytics, debe seleccionar la variable en el menú desplegable. Si eliges una variable que es no una variable de “Configuración de análisis de quitanieves”, la etiqueta fallarasí que ten cuidado.

También puedes consultar el Habilitar configuración de anulación para esta etiqueta Opción. Esto expande un campo de parámetro donde puede agregar pares clave-valor de campos de configuración de rastreador individuales. Ver la documentación Para saber qué campos están disponibles.

Si elige utilizar una variable de configuración de Snowplow Analytics y los parámetros ingresados ​​manualmente, entonces cualquier conflicto entre los dos se resolverá a favor del parámetros ingresados ​​manualmentePor ejemplo, aquí usamos una variable de configuración de Snowplow Analytics, pero decidimos anular algunos campos en la configuración.

Configuración avanzada

Véase más arriba.

Notas de lanzamiento