Questa guida per gli sviluppatori illustra come implementare lo User-ID utilizzando l'SDK Google Analytics per iOS 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 iOS per inviare gli 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 iOS, 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 kGAIUserId
, come in questo esempio:
/** * An example method called when a user signs in to an authentication system. * * @param user represents a generic User object returned by an authentication system on sign in. */ - void signInWithUser:(User *)user { id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker]; // 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. [tracker set:kGAIUserId value:user.id]; // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles). [tracker send:[[GAIDictionaryBuilder createEventWithCategory:@"UX" // Event category (required) action:@"User Sign In" // Event action (required) label:nil // Event label value:nil] build]]; // Event value }
Questo esempio mostra come ottenere lo User-ID:
NSString *userId = [tracker get:kGAIUserId];