Dimensioni e metriche personalizzate

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

Panoramica

Puoi:

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

Nome campo Tipo Descrizione
Indice Integer Indice della dimensione o metrica personalizzata. Questo indice è basato su 1.
Valore String 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:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomDimension(1, "premiumUser")
    .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:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomMetric(1, 5)
    .build()
);

Per maggiori dettagli sul metodo getTracker, consulta Configurazione avanzata.

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 della dimensione personalizzata a una visualizzazione di schermata inviata tramite la misurazione automatica dello schermo, imposta il valore prima della chiamata di activityStart() nel periodo onStart(). Tieni presente che nei casi in cui il valore non è noto al momento dell'esecuzione di onStart(), è consigliata 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.