ID utente - SDK per iOS

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.

Importante: spetta a te fornire e inviare i tuoi ID a Google Analytics, il che in genere richiede che tu abbia già implementato un sistema di autenticazione nell'applicazione e offra agli utenti un'esperienza di accesso.

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];