Dimensioni e metriche personalizzate - SDK per iOS

Questa guida per gli sviluppatori descrive come implementare le dimensioni e le metriche personalizzate utilizzando l'SDK Google Analytics per iOS v2.

Panoramica

Quando imposti il valore di una dimensione o di una metrica personalizzata utilizzando l'SDK di Google Analytics per iOS, questo valore viene inviato come parametro con l'hit successivo inviato. Questi valori possono essere applicati a qualsiasi tipo di hit di Google Analytics, tra cui visualizzazioni di schermata, eventi, transazioni e-commerce, tempi utente e interazioni social.

Per implementare una dimensione o una metrica personalizzata sono due i passaggi principali:

  1. Definisci la dimensione o la metrica personalizzata utilizzando l'interfaccia web di Google Analytics.
    Imposta l'indice, il nome e l'ambito della dimensione o della metrica personalizzata nella sezione Impostazioni proprietà dell'interfaccia web.
    Scopri come definire una dimensione o una metrica personalizzata.
  2. Implementa il codice per impostare e raccogliere valori di dimensioni e metriche personalizzate.
    Aggiungi codice all'app per impostare i valori delle dimensioni o delle metriche personalizzate per gli hit di Google Analytics in base agli indici definiti nel passaggio precedente.

La parte restante di questo articolo descrive come implementare il codice per impostare e inviare valori di dimensioni o metriche personalizzate a Google Analytics.

Dimensioni personalizzate

I valori delle dimensioni personalizzate possono essere impostati per tutti i tipi di hit di Google Analytics. Imposta un valore della dimensione personalizzata subito prima della chiamata di invio a cui vuoi applicare il valore.

L'ambito definito della dimensione personalizzata determinerà, al momento dell'elaborazione, quali hit aggiuntivi possono essere associati al valore.

Questi campi sono obbligatori per impostare un valore della dimensione personalizzata:

  • NSNumber Indice: l'indice della definizione della dimensione personalizzata. Questo indice è basato su 1.
  • NSString Valore: il valore della dimensione personalizzata.

Impostare un valore di dimensione personalizzata

Per impostare un valore della dimensione personalizzata, chiama setCustom:dimension: prima della chiamata di invio a cui vuoi associare il valore:

// 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];

Considerazioni sull'implementazione

Questa sezione contiene ulteriori considerazioni da tenere presenti quando implementi una dimensione personalizzata.

Gli ambiti a livello di utente e di sessione sono greedy

I valori delle dimensioni personalizzate con ambito a livello di utente o sessione verranno applicati a tutti gli hit della sessione corrente, inclusi quelli precedenti. Se non vuoi che un valore della dimensione personalizzata con ambito a livello di sessione o di utente venga applicato agli hit precedenti nella sessione corrente, avvia una nuova sessione prima di applicare il valore a un hit.

Ad esempio, se utilizzi il tipo di abbonamento come dimensione personalizzata a livello di utente e un utente esegue l'upgrade della propria appartenenza nel corso di una sessione, ti consigliamo di avviare una nuova sessione prima di impostare il valore della nuova dimensione personalizzata. In questo modo, gli hit precedenti all'upgrade verranno associati al valore di appartenenza precedente, mentre i nuovi hit verranno associati al nuovo valore.

Dimensioni personalizzate e filtri delle viste (profilo)

I valori della dimensione personalizzata a livello di utente o di sessione continueranno a essere applicati a tutti gli hit della sessione attuale e/o di quella futura, anche se l'hit con cui vengono inviati viene filtrato in una vista (profilo).

Quando applichi un filtro in base a un valore della dimensione personalizzata, gli hit vengono filtrati in base all'ambito del valore della dimensione personalizzata.

Scopri di più su come i filtri e i valori delle dimensioni personalizzate interagiscono durante l'elaborazione dei dati.

Impostazione dei valori con la misurazione automatica dello schermo

Per applicare un valore di dimensione personalizzata a una visualizzazione di schermata inviata tramite la misurazione automatica delle schermate, imposta il valore durante il metodo viewDidAppear: del controller di visualizzazione. Ad esempio, il file .m del controller di visualizzazione potrebbe avere il seguente aspetto:

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

Non inviare informazioni che consentono l'identificazione personale (PII) come valori

I Termini di servizio di Google Analytics vietano l'invio di informazioni che consentono l'identificazione personale (PII) ai server di Google Analytics. Per ulteriori informazioni, consulta i Termini di servizio.

Metriche personalizzate

Sebbene le dimensioni personalizzate debbano essere applicate con attenzione a hit specifici e gestite con l'ambito, l'hit a cui viene applicata una metrica personalizzata in genere non influisce sui report, pertanto può essere impostato ogni volta che il valore della metrica diventa noto.

Questi campi sono obbligatori per impostare un valore di metrica personalizzata:

  • NSInteger Indice: l'indice della definizione della metrica personalizzata.
  • NSNumber Valore: il valore della metrica personalizzata. I valori possono essere negativi.

Impostazione di un valore di metrica personalizzata

Per impostare un valore di metrica personalizzata, chiama setCustom:metric: prima di un'altra chiamata di invio:

// 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];

In alternativa, per impostare una metrica personalizzata relativa alla valuta:

// 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];

Considerazioni sull'implementazione

La seguente sezione illustra ulteriori considerazioni da tenere presenti quando pianifichi l'implementazione di una dimensione o una metrica personalizzata.

I valori delle metriche personalizzate vengono aggregati nei report

I valori delle metriche personalizzate vengono aggregati nei report, proprio come le altre metriche predefinite in Google Analytics. Di conseguenza, devi impostare un valore della metrica personalizzata 1 per incrementare il totale aggregato della metrica nei report.

Metriche personalizzate e filtri di vista (profilo)

Sebbene i valori delle metriche personalizzate possano essere impostati generalmente in qualsiasi momento, evita di impostare valori delle metriche personalizzate per gli hit che potrebbero essere filtrati dalle tue viste (profili). Se un hit viene filtrato in base a un filtro vista (profilo), verranno filtrati anche tutti i valori delle metriche personalizzate associati. Scopri di più su dimensioni e metriche personalizzate e sui filtri delle viste (profilo).