Questa guida per gli sviluppatori illustra come implementare lo User-ID utilizzando l'SDK Google Analytics per Android v3.x.
Panoramica
La funzionalità User-ID consente di misurare in Google Analytics le attività degli utenti su più dispositivi, ad esempio l'attribuzione di un'interazione con una campagna di marketing su un dispositivo mobile a una conversione che si verifica su un altro dispositivo mobile o nel browser.
Quando gli ID utente vengono inviati con gli hit di Google Analytics utilizzando il campo userId, i report
rispecchieranno un conteggio più accurato degli utenti unici e offriranno nuove opzioni di generazione dei report cross-device.
Scopri di più sui vantaggi dell'utilizzo dello User-ID.
Questa guida mostra come utilizzare il campo userId e l'SDK Google Analytics per Android per inviare ID utente a Google Analytics.
Prerequisiti
Prima di inviare lo User-ID a Google Analytics:
- Imposta lo User-ID.
- Consulta le norme sullo User-ID.
- Per scoprire come funziona lo User-ID, consulta la sezione Riferimento alle funzionalità dello User-ID.
Implementazione
Quando un utente è noto alla tua applicazione per Android, devi inviare un ID che rappresenti
tale utente con tutti i tuoi hit di Google Analytics, ad esempio visualizzazioni di pagina, eventi, transazioni e-commerce
e così via, utilizzando il campo userId.
Per inviare lo User-ID, imposta il campo userId utilizzando la
sintassi e commerciale di Measurement Protocol e il
nome del parametro
Fields.USER_ID, come in questo esempio:
/**
* An example method called when a user signs in to an authentication system.
*
* @param User user represents a generic User object returned by an authentication system on sign in.
*/
public void onUserSignIn(User user) {
Tracker t = GoogleAnalytics.getInstance(context).getTracker("UA-XXXX-Y");
// You only need to set User ID on a tracker once. By setting it on the tracker, the ID will be
// sent with all subsequent hits.
t.set(Fields.USER_ID, user.getId());
// This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles).
t.send(MapBuilder
.createEvent("UX", // Event category (required)
"Sign In", // Event action (required)
null, // Event label
null) // Event value
.build()
);
}