Questa guida per gli sviluppatori dimostra come implementare lo User-ID utilizzando l'SDK Google Analytics v4 per Android.
Panoramica
La funzionalità User-ID consente di misurare le attività degli utenti su più dispositivi in Google Analytics, ad esempio attribuendo 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 User-ID vengono inviati con gli hit di Google Analytics utilizzando il campo userId
, i report riflettono un conteggio più accurato degli utenti unici e offrono nuove opzioni di generazione dei report cross-device.
Questa guida mostra come utilizzare il campo userId
e l'SDK Google Analytics per Android per inviare User-ID a Google Analytics.
Prima di iniziare
Prima di iniziare l'implementazione, gli sviluppatori devono:
- Attivare una delle tue viste (profili) per User-ID (Centro assistenza)
- Consulta le Norme sullo User-ID
- Scopri come funziona lo User-ID consultando il riferimento sulle funzionalità User-ID
Implementazione
Quando un utente è noto per la tua applicazione 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
sul tracker utilizzando la sintassi della e commerciale di Measurement Protocol e il nome del parametro &uid
, come in questo esempio:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); // 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("&uid", user.getId()); // This hit will be sent with the User ID value and be visible in // User-ID-enabled views (profiles). t.send(new HitBuilders.EventBuilder() .setCategory("UX") .setAction("User Sign In") .build());