Dimensiones y métricas personalizadas: SDK para iOS

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

Descripción general

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

  1. Para configurar la dimensión o la métrica personalizada, utiliza la interfaz web de Google Analytics. Más información sobre cómo configurar una dimensión o una métrica personalizada (Centro de ayuda).
  2. Configura y envía valores de dimensiones y métricas personalizadas desde una aplicación.

Las dimensiones y las métricas personalizadas tienen dos campos:

  • NSNumber Índice: índice de la dimensión o de la métrica personalizadas. Está basado en 1.
  • NSString Valor: valor de la dimensión o de la métrica personalizadas. 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:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// 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.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] 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:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

Consideraciones de implementación

En esta sección se describen otras consideraciones 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 alcance 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 alcance 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 configurar 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, deberías dar a la métrica personalizada el valor 1 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, define el valor en el método viewDidAppear: del controlador de la visita. Por ejemplo, el archivo .m del controlador de la visita puede tener este aspecto:
#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [super viewDidAppear:animated];   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

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

  • Según lo establecido en las Condiciones de servicio de Google Analytics, está prohibido enviar información de identificación personal a los servidores de Google Analytics. Para obtener más información, consulta las condiciones del servicio.