Dimensiones y métricas personalizadas: SDK de Android

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

Descripción general

Las dimensiones personalizadas permiten asociar los metadatos con hits, usuarios y sesiones en Google Analytics, mientras que las métricas personalizadas te permiten crear y aumentar tus propias métricas en Google Analytics.

  1. Configura la dimensión o métrica personalizada con la interfaz web de Google Analytics. Obtén información para configurar una dimensión o métrica personalizada (Centro de ayuda).
  2. Establece y envía valores de dimensiones y métricas personalizadas desde una app.

Las dimensiones y métricas personalizadas constan de dos campos:

  • Integer Índice: Es el índice de la dimensión o métrica personalizada. Este índice se basa en 1.
  • String Value: Es el valor de la dimensión o métrica personalizada. En este caso de las métricas, se analizarán como un número entero o un valor decimal de punto fijo, si la métrica está configurada para un tipo de moneda.

Configura y envía valores

Para configurar y enviar un valor de dimensión personalizada, sigue estos pasos:

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .set(Fields.customDimension(1), "premiumUser");
    .build()
);

Los valores de dimensión personalizada se pueden enviar con 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. El alcance definido de la dimensión personalizada determinará, en el momento del procesamiento, qué hits están asociados con el valor de la dimensión.

Para establecer y enviar un valor de métrica personalizada, haz lo siguiente:

// May return null if EasyTracker has not yet been initialized with a
// property ID.
EasyTracker easyTracker = EasyTracker.getInstance();


// Set the custom metric to be incremented by 5 using its index.
easyTracker.set(Fields.customMetric(1), 5);


// Custom metric value sent is with this screen view.
easyTracker.send(MapBuilder
    .createAppView("Home screen")
    .build()
);

Consideraciones sobre la implementación

En esta sección, se describen consideraciones adicionales que debes tener en cuenta cuando implementas dimensiones o métricas personalizadas.

Consideraciones para dimensiones personalizadas

Los valores con alcances a nivel de usuario y de sesión se aplican a los hits anteriores.

  • 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 se aplique un valor de dimensión personalizada con alcance a nivel de usuario o 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 un 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 un valor de dimensión personalizada, los hits se filtran según el alcance del valor de esa 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.

Consideraciones para métricas personalizadas

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 de 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)

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 los que no se conoce el valor en el momento en que se ejecuta onStart(), se recomienda la medición manual de la pantalla.

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