Dimensiones y métricas personalizadas: SDK de iOS

En esta guía para desarrolladores, se describe cómo implementar dimensiones y métricas personalizadas con el SDK de Google Analytics para iOS 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:

  • NSNumber Índice: Es el índice de la dimensión o métrica personalizada. Este índice se basa en 1.
  • NSString 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 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, 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 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 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 una medición de pantalla automática, establece el valor durante el método viewDidAppear: del controlador de vistas. Por ejemplo, el archivo .m de tu controlador de vista podría verse de la siguiente manera:
#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 (PII) como valores