Métricas y dimensiones personalizadas

En esta guía se describe 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 máximo de 20 dimensiones personalizadas (200 en el caso de las cuentas Premium). El sufijo de índice debe ser un 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 Premium). El sufijo de índice debe ser un entero positivo mayor que 0 (por ejemplo, metric5).

Implementación

Primero debes configurar una dimensión o una 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 personalizada.

Enviar datos

Los datos de la dimensión o de la métrica personalizada solo se pueden enviar para una visita existente. Por ejemplo, para enviar una dimensión personalizada de una visita del tipo pageview con el índice 15, se usa:

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

Para enviar una métrica personalizada para una visita de tipo event con el índice 18, se usa:

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 personalizada con todas las visitas de una determinada página (o mientras dure el objeto de seguimiento). En este caso, la dimensión o la métrica personalizada se configura con el comando set:

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

Para configurar con el comando set los valores de una dimensión y 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 visitas de página por autor. Aunque los datos de autor no están disponibles de forma predeterminada en Google Analytics, puedes enviar estos datos como una dimensión personalizada con cada visita de página de la que realices el seguimiento.

El primer paso de la solución es configurar una nueva dimensión personalizada en la interfaz de administración. El nombre sería author y el ámbito 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 la dimensión personalizada author se ha configurado y se le ha asignado un índice, se puede usar con la biblioteca analytics.js para enviar datos de autor como una dimensión personalizada. Por ejemplo, si tu página está escrita en PHP, el autor real de la página probablemente estará guardado en una variable PHP parecida a $author. En la plantilla PHP, puedes usar esta variable de autor para pasar el valor a la dimensión personalizada:

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