Dimensiones y métricas personalizadas con gtag.js

En esta guía se describe cómo enviar dimensiones y métricas personalizadas a Google Analytics.

Introducción

Las dimensiones y las métricas personalizadas son una forma eficaz de enviar datos personalizados a Google Analytics. Los programadores web pueden usar dimensiones y métricas personalizadas para segmentar y medir diferencias entre los usuarios que han iniciado sesión y los que han salido de ella, los autores de páginas o los niveles en juegos.

Para enviar valores de parámetros personalizados a Google Analytics, asigna los parámetros a los siguientes parámetros de dimensiones y métricas personalizadas de Google Analytics:

Parámetro personalizado Tipo de datos Descripción
dimension<Index> string Parámetro de dimensión personalizada (es decir, dimension3)
metric<Index> string Parámetro de métrica personalizada (es decir, metric8)

Configurar y enviar dimensiones personalizadas

Para enviar el valor de un parámetro personalizado a Google Analytics, debes asignar el parámetro a un parámetro de Google Analytics. El código de seguimiento gtag.js proporciona el parámetro custom_map para asignar un parámetro personalizado a una dimensión o métrica personalizadas de Google Analytics.

Para enviar una dimensión personalizada a Google Analytics, define el parámetro custom_map de la dimensión en el comando config de tu propiedad. Luego utiliza el parámetro personalizado para enviar el valor de la dimensión personalizada:

// Configures custom dimension<Index> to use the custom parameter
// 'dimension_name' for 'GA_TRACKING_ID', where <Index> is a number
// representing the index of the custom dimension.
gtag('config', 'GA_TRACKING_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'dimension_name': dimension_value});

Reemplaza 'GA_TRACKING_ID' por tu ID de seguimiento.

Por ejemplo, el siguiente fragmento enviará la dimensión personalizada dimension2 con el valor 12 a Google Analytics:

// Maps 'dimension2' to 'age'.
gtag('config', 'GA_TRACKING_ID', {
  'custom_map': {'dimension2': 'age'}
});

// Sends an event that passes 'age' as a parameter.
gtag('event', 'age_dimension', {'age': 12});

Configurar y enviar métricas personalizadas

Para enviar una métrica personalizada a Google Analytics, define el parámetro custom_map de la métrica en el comando config de tu propiedad. Luego utiliza el parámetro personalizado para enviar el valor de la métrica personalizada:

// Configures custom metric<Index> to use the custom parameter
// 'metric_name' for GA_TRACKING_ID, where <Index> is a number
// representing the index of the custom metric.
gtag('config', 'GA_TRACKING_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'metric_name': metric_value});

Reemplaza 'GA_TRACKING_ID' por tu ID de seguimiento.

Por ejemplo, el siguiente fragmento enviará la métrica personalizada metric5 con un valor de 1 a Google Analytics:

// Maps 'metric5' to 'avg_page_load_time'.
gtag('config', 'GA_TRACKING_ID', {
  'custom_map': {'metric5': 'avg_page_load_time'}
});

// Sends an event that passes 'avg_page_load_time' as a parameter.
gtag('event', 'load_time_metric', {'avg_page_load_time': 1});

Configurar y enviar dimensiones y métricas personalizadas

Puedes asignar dimensiones y métricas personalizadas en el comando config de tu propiedad:

gtag('config', 'GA_TRACKING_ID', {
   'custom_map': {
     'dimension2': 'age',
     'metric5': 'avg_page_load_time'
   }
});

gtag('event', 'foo', {'age': 12, 'avg_page_load_time': 1});