Métricas &dimensiones personalizadas - SDK de Android v2 (heredado)

En esta guía para desarrolladores, se describe cómo implementar dimensiones y métricas personalizadas con el SDK de Google Analytics para Android v2.

Descripción general

Cuando configuras un valor de dimensión o métrica personalizada con el SDK de Google Analytics para Android, ese valor se envía como parámetro con el siguiente hit que se envía. Esos valores se pueden aplicar a cualquier tipo de hit de Google Analytics, incluidas las visitas a una pantalla, los eventos, las transacciones de comercio electrónico, los tiempos de usuario y las interacciones sociales.

Hay dos pasos principales para implementar una dimensión o métrica personalizada:

  1. Defina la dimensión o métrica personalizada con la interfaz web de Google Analytics.
    Configura el índice, el nombre y el alcance de la dimensión o métrica personalizada en la sección de configuración de propiedades de la interfaz web.
    Obtén información para definir una dimensión o métrica personalizada.
  2. Implemente código para establecer y recopilar valores de dimensiones y métricas personalizadas.
    Agrega código a tu app a fin de establecer valores de dimensiones o métricas personalizadas para los hits de Google Analytics en los índices que definiste en el paso anterior.

En el resto de este artículo, se describe cómo implementar el código para configurar y enviar valores de dimensiones o métricas personalizadas a Google Analytics.

Dimensiones personalizadas

Los valores de dimensión personalizada se pueden establecer en todos los tipos de hits de Google Analytics. Establece un valor de dimensión personalizada justo antes de la llamada de envío a la que deseas aplicar el valor.

El alcance definido de la dimensión personalizada determinará en el momento del procesamiento qué hits adicionales pueden asociarse con ese valor.

Estos campos son obligatorios para establecer un valor de dimensión personalizada:

  • Integer Índice: El índice de la definición de la dimensión personalizada. Este índice se basa en 1.
  • String Valor: El valor de la dimensión personalizada.

Cómo establecer un valor de dimensión personalizada

Para establecer un valor de dimensión personalizada, llama a setCustomDimension antes de la llamada de envío con la que deseas asociar el valor:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

Consideraciones para la implementación

En esta sección, se describen consideraciones adicionales que debes tener en cuenta cuando implementas una dimensión personalizada.

Los alcances a nivel de usuario y de sesión son codiciosos

Los valores de dimensión personalizada con alcance a nivel de usuario o sesión se aplicarán a todos los hits de la sesión actual, incluidos los hits anteriores. Si no quieres que se aplique un valor de dimensión personalizada con alcance a nivel de usuario o de sesión a los hits anteriores de la sesión actual, inicia una sesión nueva antes de aplicar el valor a un hit.

Por ejemplo, si usas el tipo de membresía como una dimensión personalizada a nivel de usuario y un usuario actualiza su membresía en medio de una sesión, es posible que desees iniciar una nueva sesión antes de establecer el valor de dimensión personalizada nuevo. Esto garantiza que los hits anteriores a la actualización se asocien con el valor de membresía anterior, mientras que los hits nuevos se asociarán con el valor nuevo.

Dimensiones personalizadas y filtros de vista (perfil)

Los valores de dimensión personalizada a nivel de usuario o de sesión se aplicarán a todos los hits de las sesiones actuales o futuras, incluso si el hit que reciben se filtra de una vista (perfil).

Cuando se filtra un valor de dimensión personalizada, los hits se filtran según el alcance de ese valor de dimensión personalizada.

Obtén más información sobre cómo interactúan los filtros y los valores de dimensión personalizada cuando se procesan tus datos.

Cómo configurar valores con la medición automática de pantalla

Para aplicar un valor de dimensión personalizada a una visita a una pantalla enviada mediante la medición automática de la pantalla de EasyTracker, establece el valor antes de llamar a activityStart() durante onStart().

Ten en cuenta que, en los casos en que no se conoce el valor en el momento en que se ejecuta onStart(), se recomienda usar la medición de pantalla manual.

No envíe información de identificación personal (PII) como valores

Las Condiciones del Servicio de Google Analytics prohíben el envío de información de identificación personal (PII) a los servidores de Google Analytics. Para obtener más información, consulta las Condiciones del Servicio.

Custom Metrics

Si bien las dimensiones personalizadas deben aplicarse con cuidado a hits específicos y administrarse con el alcance, por lo general, el hit al que se aplica una métrica personalizada no afectará los informes y, por lo tanto, se pueden establecer siempre que se conozca el valor de la métrica.

Estos campos son obligatorios para establecer un valor de métrica personalizado:

  • Integer Índice: El índice de la definición de la métrica personalizada.
  • Integer Valor: El valor de la métrica personalizada. Los valores pueden ser negativos.

Establece un valor de métrica personalizado

Para configurar un valor de métrica personalizado, llama a setCustomMetric antes de otra llamada de envío:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

Para configurar una métrica personalizada de moneda, siga estos pasos:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

Consideraciones para la implementación

En la siguiente sección, se describen consideraciones adicionales que debes tener en cuenta cuando planificas una implementación de dimensión o métrica personalizada.

Los valores de las métricas personalizadas se agregan en los informes

Los valores de las métricas personalizadas se agregan en los informes al igual que otras métricas predefinidas en Google Analytics. Como resultado, debes establecer un valor de métrica personalizado de 1 para aumentar el total agregado de la métrica en tus informes.

Métricas personalizadas y filtros de vistas (perfil)

Aunque, por lo general, los valores de la métrica personalizada se pueden configurar cuando sea conveniente, evita configurar valores de la métrica personalizada en los hits que probablemente se filtren desde tus vistas (perfiles). Si un filtro de vista (perfil) filtra un hit, también se filtrarán los valores de las métricas personalizadas asociadas. Obtén más información sobre las dimensiones y métricas personalizadas, y los filtros de vista (perfil).