ID utente

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:

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());