Métricas y dimensiones personalizadas

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

Descripción general

Puedes:

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

Nombre del campo Tipo Descripción
Index Entero Índice de la dimensión o la métrica personalizada. Está basado en 1.
Value Cadena Valor de la dimensión o la métrica personalizada. En este caso, las métricas se analizan como un entero o un valor decimal de punto fijo si la métrica está configurada como un tipo de moneda.

Configuración y envío de valores

Para configurar y enviar un valor de dimensión personalizada:

// 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, incluyendo visitas a una pantalla, eventos, transacciones de comercio electrónico, tiempos de usuario e interacciones sociales. El ámbito definido de la dimensión personalizada determina, en el momento de procesamiento, los hits que se asocian al valor de dimensión.

Para configurar y enviar un valor de métrica personalizada:

// 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 la sección Configuración avanzada para obtener información detallada sobre el método getTracker.

Consideraciones de implementación

En esta sección se describen las consideraciones adicionales a tener en cuenta en la implementación de las dimensiones o las métricas personalizadas.

Consideraciones para dimensiones personalizadas

Los valores con ámbitos de usuario y de sesión afectan a los hits pasados.

  • Los valores de dimensión personalizada que tengan ámbitos de usuario o de sesión afectan a todos los hits de la sesión actual, incluidos los hits pasados. Si no quieres que un valor de dimensión personalizada con ámbito de sesión o de usuario afecte a los hits pasados de la sesión actual, inicia una sesión nueva antes de aplicar el valor a un hit.
  • Por ejemplo, si utilizas el tipo de suscripción como una dimensión personalizada de usuario y un usuario actualiza su suscripción a mitad de sesión, es recomendable iniciar una sesión nueva antes de establecer el nuevo valor de dimensión personalizada. Así te aseguras de que los hits anteriores a la actualización se asocien al valor de la suscripción anterior y los hits nuevos se asocien al nuevo valor.

Dimensiones personalizadas y filtros de vista (perfil)

  • Los valores de dimensión personalizada de usuario o de sesión se aplicarán a todos los hits de las sesiones actuales o futuras aunque el hit con el que se envíen se filtre de una vista (perfil).
  • Al filtrar en función de un valor de dimensión personalizada, los hits se filtran de acuerdo con el ámbito de ese valor de dimensión personalizada. Más información sobre la interacción de filtros y de valores de dimensión personalizada durante el procesamiento de los datos.

Consideraciones para las métricas personalizadas

Los valores de métrica personalizada se suman en los informes.

  • Los valores de métrica personalizada se suman en los informes de igual modo que otras métricas predefinidas en Google Analytics. Por eso, se establecería un valor 1 de métrica personalizada para incrementar la suma total de la métrica en los informes.

Métricas personalizadas y filtros de vista (perfil)

Configuración de valores con la medición de pantalla automática

  • Para aplicar un valor de dimensión personalizada a una visita a una pantalla enviada a través de la medición de pantalla automática, configura el valor antes de que se llame a activityStart() durante onStart(). Ten en cuenta que, en los casos en los que el valor no se conoce en el momento en el que onStart() se ejecuta, se recomienda utilizar la medición de pantalla manual.

No envíes información de identificación personal como valores.

  • Según lo establecido en las Condiciones de servicio de Google Analytics, se prohíbe el envío de toda información de identificación personal a los servidores de Google Analytics. Para obtener más información, consulta las Condiciones de Servicio.