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 manera eficaz de enviar datos personalizados a Google Analytics. Los desarrolladores web pueden usar dimensiones y métricas personalizadas para segmentar y medir las diferencias entre los usuarios que accedieron a sus cuentas y los que salieron de sus cuentas, los autores de las páginas, los niveles de los juegos o cualquier otro dato de la empresa que se encuentre en una página.
Para obtener una descripción general completa de su funcionamiento, consulta la Referencia de la función de métricas y dimensiones personalizadas.
Puedes enviar datos de dimensiones y métricas personalizadas utilizando uno de los siguientes valores o ambos:
| Nombre del campo | Value Type | Obligatorio | Descripción |
|---|---|---|---|
| dimensión[0-9]+ | text | No | Es el índice de dimensiones. Cada dimensión personalizada tiene un índice asociado.Hay un máximo de 20 dimensiones personalizadas (200 para las cuentas de Analytics 360). El sufijo del índice debe ser un número entero positivo mayor que 0 (p.ej., dimensión3). |
| métrica[0-9]+ | integer | No | Es el índice de la métrica. Cada métrica personalizada tiene un índice asociado. Hay un máximo de 20 métricas personalizadas (200 para las cuentas de Analytics 360). El sufijo del índice debe ser un número entero positivo mayor que 0 (p.ej., 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 una dimensión o métrica personalizada de otra. Luego, puedes usar el índice de la biblioteca de analytics.js para enviar datos para una dimensión o métrica personalizada en particular.
Enviando datos
Los datos de dimensiones o métricas personalizadas solo se pueden enviar con un hit existente. Por ejemplo, si deseas enviar una dimensión personalizada para un hit de tipo pageview con el índice 15, debes usar lo siguiente:
ga('send', 'pageview', {
'dimension15': 'My Custom Dimension'
});
Si deseas enviar una métrica personalizada para un hit de tipo event con el índice 18, deberías usar lo siguiente:
ga('send', 'event', 'category', 'action', {
'metric18': 8000
});
Si la métrica personalizada está configurada para tener un tipo de moneda, puedes enviar valores decimales:
ga('send', 'event', 'category', 'action', {
'metric19': 24.99
});
En algunos casos, es posible que desees enviar una dimensión o métrica personalizada con todos los hits de una página determinada (o durante el ciclo de vida del objeto de seguimiento). En este caso, puedes configurar la dimensión o las métricas personalizadas con el comando set:
ga('set', 'dimension5', 'custom data');
Para set valores de una dimensión y una métrica, puedes usar lo siguiente:
ga('set', {
'dimension5': 'custom dimension data',
'metric5': 'custom metric data'
});
Lee la sección Dimensiones y métricas personalizadas del documento Referencia de campos para conocer el formato específico de cómo enviar estos datos.
Ejemplo
Un fantástico ejemplo de cuándo usar dimensiones personalizadas es si tienes un sitio basado en contenido con muchos autores. Como analista, es posible que quieras entender qué autores tienen el contenido más popular. Para responder esta pregunta, puedes ver un informe que compara las vistas de página por autor. Si bien los datos del autor no están disponibles de forma predeterminada en Google Analytics, puedes enviarlos como una dimensión personalizada en cada vista de página.
El primer paso de la solución es configurar una nueva dimensión personalizada en la interfaz de administración. El nombre debe ser author, y el alcance será del tipo hit. Una vez configurada, se le asignará un índice a la nueva dimensión personalizada. Para este ejemplo, supongamos que el índice es 5.
Ahora que se configuró la dimensión personalizada author y se le asignó un índice, se puede usar con la biblioteca analytics.js para enviar datos del autor como una dimensión personalizada. Por ejemplo, si tu página está escrita en PHP, es probable que el autor real de la página se almacene en una variable PHP como $author. En tu plantilla de PHP, puedes usar esta variable de autor para pasar el valor de autor a la dimensión personalizada:
ga('send', 'pageview', {
'dimension5': '<?=$author?>'
});