Dimensiones y métricas personalizadas

En esta guía se explica cómo enviar dimensiones y métricas personalizadas con analytics.js.

Descripción general

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

Para obtener una descripción general completa sobre esta función, consulta la referencia de la función de dimensiones y métricas personalizadas.

Los datos de las dimensiones y las métricas personalizadas se envían con uno de los dos valores siguientes, o con ambos:

Nombre del campo Tipo de valor Obligatorio Descripción
dimension[0-9]+ texto No Especifica el índice de dimensión. Cada dimensión personalizada tiene un índice asociado. Hay un límite máximo de 20 dimensiones personalizadas (200 en el caso de las cuentas de Analytics 360). El sufijo de índice debe ser un número entero positivo mayor que 0 (por ejemplo, dimension3).
metric[0-9]+ entero No Especifica el índice de métrica. Cada métrica personalizada tiene un índice asociado. Hay un máximo de 20 métricas personalizadas (200 en el caso de las cuentas de Analytics 360). El sufijo de índice debe ser un número entero positivo mayor que 0 (por ejemplo, metric5).

Implementación

Primero debes configurar una dimensión o métrica personalizada a través de la interfaz de administración de Google Analytics. Una vez configurada, a la dimensión o métrica personalizada se le asignará un índice único que identifica y diferencia las dimensiones o métricas personalizadas entre sí. A continuación, se usa el índice de la biblioteca analytics.js para enviar datos de una determinada dimensión o métrica personalizadas.

Enviar datos

Solo se pueden enviar datos de métricas o dimensiones personalizadas con un hit ya creado. Por ejemplo, para enviar una dimensión personalizada de un hit del tipo pageview con el índice 15, usa:

ga('send', 'pageview', {
  'dimension15':  'My Custom Dimension'
});

Para enviar una métrica personalizada de un tipo de hit event con el índice 18, utiliza lo siguiente:

ga('send', 'event', 'category', 'action', {
  'metric18': 8000
});

Si la métrica personalizada está configurada para que tenga un tipo de moneda, puedes enviar los valores decimales:

ga('send', 'event', 'category', 'action', {
  'metric19': 24.99
});

En algunos casos, puedes enviar una dimensión o una métrica personalizadas con todos los hits de una determinada página (o los correspondientes a la duración del objeto de seguimiento). En este caso, la dimensión o métrica personalizada se configura con el comando set:

ga('set', 'dimension5', 'custom data');

Para definir valores set tanto de una dimensión como de una métrica, puedes usar:

ga('set', {
  'dimension5': 'custom dimension data',
  'metric5': 'custom metric data'
});

Consulta en la sección Dimensiones y métricas personalizadas del documento Referencia de campos el formato específico para enviar estos datos.

Ejemplo

Un excelente ejemplo para saber cuándo te conviene usar dimensiones personalizadas sería si tuvieras un sitio basado en contenido con muchos autores. Como analista, te gustaría saber qué autores tienen el contenido más popular. Para responder a esta pregunta, podrías consultar un informe que comparara las páginas vistas por autor. Aunque los datos de autor no están disponibles de forma predeterminada en Google Analytics, puedes enviarlos como dimensión personalizada con cada página vista.

El primer paso de la solución es configurar una nueva dimensión personalizada en la interfaz de gestión. El nombre sería author y su alcance sería del tipo hit. Una vez configurada, a la nueva dimensión personalizada se le asigna un índice. En este ejemplo, supongamos que el índice es 5.

Ahora que se ha configurado la dimensión personalizada author y se le ha asignado un índice, se puede usar con la biblioteca analytics.js para enviar datos de autor como dimensión personalizada. Por ejemplo, si la página está escrita en PHP, el autor de la página probablemente se almacenará en una variable PHP como $author. En la plantilla PHP, puedes usar esta variable de autor para enviar el valor a la dimensión personalizada:

ga('send', 'pageview', {
  'dimension5': '<?=$author?>'
});