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

Panoramica

Le dimensioni personalizzate consentono di associare i metadati con hit, utenti e sessioni in Google Analytics, mentre le metriche personalizzate ti consentono di creare e incrementare le tue metriche in Google Analytics.

  1. Configura la dimensione o la metrica personalizzata utilizzando l'interfaccia web di Google Analytics. Scopri come configurare una dimensione o una metrica personalizzata (Centro assistenza).
  2. Impostare e inviare i valori delle dimensioni e delle metriche personalizzate da un'app.

Le dimensioni e le metriche personalizzate sono composte da due campi:

  • NSNumber Indice: l'indice della dimensione o della metrica personalizzata. Questo indice è basato su 1.
  • NSString Valore: il valore della dimensione o della metrica personalizzata. In questo caso, le metriche verranno analizzate come un numero intero o un valore decimale in virgola fisso, se la metrica è configurata con un tipo di valuta.

Impostazione e invio dei valori

Per impostare e inviare un valore della dimensione personalizzata:

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

I valori delle dimensioni personalizzate possono essere inviati con qualsiasi tipo di hit di Google Analytics, tra cui visualizzazioni di schermata, eventi, transazioni e-commerce, tempi utente e interazioni social. L'ambito definito della dimensione personalizzata determinerà, al momento dell'elaborazione, quali hit sono associati al valore della dimensione.

Per impostare e inviare un valore di metrica personalizzata:

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

Considerazioni sull'implementazione

Questa sezione contiene ulteriori considerazioni da tenere presenti quando implementi dimensioni o metriche personalizzate.

Considerazioni sulle dimensioni personalizzate

I valori con ambiti a livello di utente e di sessione si applicano agli hit passati

  • I valori delle dimensioni personalizzate con ambito a livello di utente o sessione vengono applicati a tutti gli hit della sessione corrente, inclusi quelli passati. 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 nuovo valore della dimensione personalizzata. In questo modo, gli hit precedenti all'upgrade verranno associati al valore dell'abbonamento 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 corrente e/o di quella futura, anche se l'hit con cui vengono inviati viene filtrato da 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.

Considerazioni sulle metriche personalizzate

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 per la metrica personalizzata pari a 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 quando opportuno, evita di impostare valori delle metriche personalizzate per gli hit che probabilmente verranno 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).

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 dello schermo, 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<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.

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.