Dimensioni personalizzate e metriche - SDK Android v2 (legacy)

Importante: questo documento descrive una versione precedente dell'SDK. I nuovi utenti devono utilizzare l'SDK più recente.

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

Panoramica

Prima dell'implementazione, leggi la Guida alle funzionalità e alle dimensioni personalizzate per una spiegazione dettagliata del funzionamento di dimensioni e metriche personalizzate.

Quando imposti una dimensione o una metrica personalizzata utilizzando l'SDK Google Analytics per Android, tale 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 le visualizzazioni di schermata, gli eventi, le transazioni e-commerce, i tempi degli utenti e le interazioni social.

Sono due i passaggi principali per implementare una dimensione o una metrica personalizzata:

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 i valori delle dimensioni e delle metriche personalizzate.
   Aggiungi codice alla tua app per impostare valori di dimensioni o metriche personalizzate per gli hit di Google Analytics negli indici definiti nel passaggio precedente.

Nella parte rimanente di questo articolo viene descritto come implementare il codice per impostare e inviare i valori delle metriche o delle dimensioni 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 di dimensione personalizzata appena prima della chiamata di invio a cui vuoi applicare il valore.

L'ambito definito della dimensione personalizzata determinerà al momento dell'elaborazione gli hit aggiuntivi che possono essere associati al valore in questione.

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

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

Impostare un valore per la dimensione personalizzata

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

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

Considerazioni sull'implementazione

In questa sezione vengono illustrate alcune considerazioni aggiuntive da tenere presenti durante l'implementazione di una dimensione personalizzata.

Gli ambiti a livello di sessione e di utente sono pesanti

I valori della dimensione personalizzata con ambito a livello di utente o sessione verranno applicati a tutti gli hit della sessione corrente, inclusi quelli passati. Se non vuoi applicare un valore di dimensione personalizzata con un ambito a livello di sessione o di utente agli hit passati della sessione attuale, 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 aggiorna il proprio abbonamento 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'iscrizione precedente, mentre i nuovi hit verranno associati al nuovo valore.

Filtri personalizzati di Visualizzazione e Dimensioni (Profilo)

I valori delle dimensioni personalizzate a livello di utente o sessione continueranno a essere applicati a tutti gli hit della sessione attuale e/o di quelle future anche se l'hit con cui sono stati inviati viene filtrato in una vista (profilo).

Quando applichi un filtro in base al valore di una dimensione personalizzata, gli hit vengono filtrati in base all'ambito di quel valore.

Scopri di più su come i filtri e i valori delle dimensioni personalizzate interagiscono quando vengono elaborati i dati.

Impostare i 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 di EasyTracker, imposta il valore prima che activityStart() venga richiamato durante onStart().

Tieni presente che, nei casi in cui il valore non è noto al momento dell'esecuzione di onStart(), ti consigliamo di utilizzare la misurazione manuale dello schermo.

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.

Custom Metrics

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

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

• Integer Indice: l'indice della definizione della metrica personalizzata.
• Integer Valore: il valore della metrica personalizzata. I valori potrebbero essere negativi.

Nota: per le metriche personalizzate configurate come tipo di valuta, puoi utilizzare un valore decimale fisso invece di un numero intero.

Impostare un valore metrica personalizzato

Per impostare un valore della metrica personalizzata, chiama setCustomMetric prima di un'altra chiamata di invio:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

Oppure, per impostare una metrica personalizzata per la valuta:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

Considerazioni sull'implementazione

La seguente sezione delinea alcune considerazioni aggiuntive da tenere in considerazione quando pianifichi un'implementazione di dimensione o metrica personalizzata.

I valori delle metriche personalizzate sono aggregati nei report

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

Filtri personalizzati e visualizzazioni (Profilo)

Sebbene i valori delle metriche personalizzate possano generalmente essere impostati in qualsiasi momento, evita di impostare valori di metriche personalizzate sugli hit che potrebbero essere filtrati dalle tue viste (profili). Se un hit viene filtrato con un filtro vista (profilo), vengono filtrati anche tutti i valori delle metriche personalizzate associate. Scopri di più sulle dimensioni e sulle metriche personalizzate e sui filtri della vista (profilo).