Dimensiones y métricas personalizadas: SDK de Android versión 2 (heredado)

Importante: En este documento, se describe una versión heredada del SDK. Los usuarios nuevos deben usar el SDK más reciente.

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

Antes de realizar la implementación, lee la Guía de funciones de dimensiones y métricas personalizadas para obtener una explicación detallada de cómo funcionan las dimensiones y métricas personalizadas.

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íe. 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 los usuarios y las interacciones en redes sociales.

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

1. Define 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 la propiedad de la interfaz web.
   Descubre cómo definir una dimensión o métrica personalizada.
2. Implementa código para establecer y recopilar valores de dimensiones y métricas personalizadas.
   Agrega código a tu app para configurar valores de dimensiones o métricas personalizadas para tus 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 las dimensiones personalizadas se pueden configurar en todos los tipos de hits de Google Analytics. Configura 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 se pueden asociar con ese valor.

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

• Integer Index: Es el índice de la definición de la dimensión personalizada. Este índice se basa en 1.
• String Value: Es el valor de la dimensión personalizada.

Cómo configurar 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 sobre 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 de sesión se aplicarán a todos los hits de la sesión actual, incluidos los hits anteriores. Si no quieres que un valor de dimensión personalizada con alcance a nivel de usuario o de sesión se aplique 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, te recomendamos que inicies una sesión nueva antes de establecer el nuevo valor de dimensión personalizada. 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 seguirán aplicando a todos los hits de la sesión actual o futura, incluso si el hit con el que se envían se filtra de una vista (perfil).

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

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.

Configura valores con mediciones automáticas de pantalla

Para aplicar un valor de dimensión personalizada a una vista de pantalla enviada a través de la medición automática de pantalla de EasyTracker, establece el valor antes de que se llame a activityStart() durante onStart().

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

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

Las Condiciones del Servicio de Google Analytics prohíben el envío de cualquier 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 un alcance, por lo general, el hit al que se aplica una métrica personalizada no afectará los informes y, por lo tanto, se pueden configurar cada vez que se conozca el valor de la métrica.

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

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

Nota: Puedes usar un valor decimal fijo en lugar de un número entero para las métricas personalizadas configuradas como un tipo de moneda.

Cómo establecer un valor de métrica personalizada

Para establecer un valor de métrica personalizada, 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();

O bien, para establecer una métrica personalizada de moneda, haz lo siguiente:

// 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 sobre la implementación

En la siguiente sección, se describen consideraciones adicionales que debes tener en cuenta cuando planificas la implementación de una 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, deberías establecer un valor de métrica personalizada de 1 para aumentar el total agregado de la métrica en tus informes.

Métricas personalizadas y filtros de vistas (perfil)

Si bien los valores de la métrica personalizada suelen establecerse cuando es conveniente, evita establecer valores de métricas personalizadas en los hits que es probable que se filtren de tus vistas (perfiles). Si un hit se filtra por un filtro de vista (perfil), también se filtrarán los valores de la métrica personalizada asociados. Obtén más información sobre las dimensiones y métricas personalizadas, y los filtros de vistas (perfil).