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

Descripción general

Cuando configuras un valor de dimensión o métrica personalizada con el SDK de Google Analytics para iOS, ese valor se envía como parámetro con el siguiente hit que se despacha. Esos valores se pueden aplicar a 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.

Existen dos pasos principales para implementar una dimensión o métrica personalizada:

  1. Define la dimensión o métrica personalizada con la interfaz web de Google Analytics.
    Configura el índice, el nombre y el alcance de la dimensión o métrica personalizada en la sección de configuración de la propiedad de la interfaz web.
    Descubre cómo definir una dimensión o métrica personalizada.
  2. Implementa código para establecer y recopilar valores de dimensiones y métricas personalizadas.
    Agrega código a tu app para configurar valores de dimensiones o métricas personalizadas para tus hits de Google Analytics en los índices que definiste en el paso anterior.

En el resto de este artículo, se describe cómo implementar el código para configurar y enviar valores de dimensiones o métricas personalizadas a Google Analytics.

Dimensiones personalizadas

Los valores de las dimensiones personalizadas se pueden configurar en todos los tipos de hits de Google Analytics. Configura un valor de dimensión personalizada justo antes de la llamada de envío a la que deseas aplicar el valor.

El alcance definido de la dimensión personalizada determinará en el momento del procesamiento qué hits adicionales se pueden asociar con ese valor.

Estos campos son obligatorios para establecer un valor de dimensión personalizada:

  • NSNumber Index: Es el índice de la definición de la dimensión personalizada. Este índice se basa en 1.
  • NSString Value: Es el valor de la dimensión personalizada.

Cómo configurar un valor de dimensión personalizada

Para establecer un valor de dimensión personalizada, llama a setCustom:dimension: antes de realizar la llamada de envío con la que deseas asociar el valor:

// Get the tracker object.
id tracker = [[GAI sharedInstance].defaultTracker;

// Set the dimension value for index 1.
[tracker setCustom:1
         dimension:@"myValue"];

// Dimension value is associated and sent with this hit.
[tracker sendView:screenName];

Consideraciones sobre la implementación

En esta sección, se describen consideraciones adicionales que debes tener en cuenta cuando implementas una dimensión personalizada.

Los alcances a nivel de usuario y de sesión son codiciosos

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 el 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 según un valor de dimensión personalizada, los hits se filtran según el alcance de ese valor.

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.

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 durante el método viewDidAppear: del controlador de vista. Por ejemplo, el archivo .m del controlador de vista podría tener el siguiente aspecto:

#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id tracker = [[GAI sharedInstance].defaultTracker;  // Get the tracker object.
    [tracker setCustom:1
             dimension:@"myValue"];  // Set the custom dimension value.
    [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

Las Condiciones del Servicio de Google Analytics prohíben el envío de cualquier información de identificación personal (PII) a los servidores de Google Analytics. Para obtener más información, consulta las Condiciones del Servicio.

Custom Metrics

Si bien las dimensiones personalizadas deben aplicarse con cuidado a hits específicos y administrarse con un alcance, por lo general, el hit al que se aplica una métrica personalizada no afectará los informes y, por lo tanto, se pueden configurar cada vez que se conozca el valor de la métrica.

Estos campos son obligatorios para establecer un valor de métrica personalizada:

  • NSInteger Índice: Es el índice de la definición de la métrica personalizada.
  • NSNumber Value: Es el valor de la métrica personalizada. Los valores pueden ser negativos.

Cómo establecer un valor de métrica personalizada

Para establecer un valor de métrica personalizada, llama a setCustom:metric: antes de otra llamada de envío:

// Get the tracker object.
id tracker = [GAI sharedInstance].defaultTracker;

// Increment the metric at index 1.
[tracker setCustom:1
            metric:[NSNumber numberWithLongLong:1]];

// Metric value sent with this hit.
[tracker sendView:screenName];

O bien, para establecer una métrica personalizada de moneda, haz lo siguiente:

// Get the tracker.
id tracker = [GAI sharedInstance].defaultTracker;

// Create a dictionary for hit params.
NSDictionary *params = [[NSDictionary alloc] initWithObjectsAndKeys:
    @"Product Page", @"&cd",
   // Set currency value to custom metric slot 1.
   // Currency values may be fixed decimal.
    @"24.99", @"&cm1", nil];

// Send the custom metric value with a screen view.
[tracker send:@"appview"
       params:params];

Consideraciones sobre la implementación

En la siguiente sección, se describen consideraciones adicionales que debes tener en cuenta cuando planificas la implementación de una dimensión o métrica personalizada.

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

Si bien los valores de la métrica personalizada suelen establecerse cuando es conveniente, evita establecer valores de métricas personalizadas en los hits que es probable que se filtren de tus vistas (perfiles). Si un hit se filtra por un filtro de vista (perfil), también se filtrarán los valores de la métrica personalizada asociados. Obtén más información sobre las dimensiones y métricas personalizadas, y los filtros de vistas (perfil).