Dimensioni e metriche personalizzate - SDK per Android v2 (legacy)

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

Panoramica

Quando imposti il valore di una dimensione o di una metrica personalizzata utilizzando l'SDK Google Analytics per Android, 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:

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

Impostare un valore di 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

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 venga applicato un valore della dimensione personalizzata con ambito a livello di sessione o di utente 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 dello schermo di EasyTracker, imposta il valore prima della chiamata di activityStart() nei giorni onStart().

Tieni presente che nei casi in cui il valore non è noto al momento dell'esecuzione di onStart(), è consigliabile 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.

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:

  • Integer Indice: l'indice della definizione della metrica personalizzata.
  • Integer 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 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();

In alternativa, per impostare una metrica personalizzata relativa alla 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 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).