Dimensiones y métricas personalizadas

En esta guía para desarrolladores, se describe cómo usar la versión 4 del SDK de Google Analytics para Android a fin de implementar dimensiones y métricas personalizadas.

Descripción general

Puedes hacer lo siguiente:

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

Nombre del campo Tipo Descripción
Índice Integer Es el índice de la dimensión o métrica personalizada. Este índice se basa en 1.
Valor String 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:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomDimension(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:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomMetric(1, 5)
    .build()
);

Consulta Configuración avanzada para obtener detalles sobre el método getTracker.

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 sesión o de usuario 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 mediante la medición automática de la pantalla, 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