Inviare gli ID utente

Gli User-ID sono identificatori univoci che assegni ai singoli utenti. Questa guida spiega come inviare gli User-ID a Google Analytics, in modo da poter collegare il comportamento degli utenti in diverse sessioni, su dispositivi e piattaforme differenti.

Per scoprire di più sulla funzionalità User-ID, consulta Misurare l'attività sulle varie piattaforme. Per scoprire come impostare uno User-ID per un'app, consulta Impostare uno User-ID.

L'impostazione di dimensioni personalizzate basate sugli User-ID comporta la creazione di dimensioni con troppi valori univoci. Un numero eccessivo di valori univoci causa problemi con i dati di Google Analytics e l'accuratezza dei report. Scopri di più sulle best practice per l' impostazione delle dimensioni personalizzate.


Prima di iniziare

Prima di poter inviare gli User-ID, assicurati di aver completato le seguenti operazioni:

Inviare gli User-ID

Il valore che invii per user_id dipende dallo stato dell'utente:

  • L'utente non ha mai eseguito l'accesso: non inviare il parametro user_id.
  • L'utente ha eseguito l'accesso: invia il suo User-ID.
  • L'utente aveva eseguito l'accesso, ma poi si è disconnesso: invia null.

Per inviare uno User-ID ad Analytics, aggiungi il parametro user_id al comando config su ogni pagina del tuo sito web:

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}
  1. Sostituisci TAG_ID con il tuo ID tag.
  2. Sostituisci i commenti con i controlli per verificare se l'utente ha eseguito l'accesso e se l'utente aveva eseguito l'accesso, ma poi si è disconnesso.
  3. Se un utente ha eseguito l'accesso, sostituisci USER_ID con il suo User-ID.
  4. Quando un utente si disconnette, imposta user_id su null. Non inviare una stringa vuota (""), una stringa con uno spazio (" ") o le parole tra virgolette "null" o "NULL".

Impostare lo User-ID dopo l'inizializzazione

In molti casi, user_id non è noto quando il tag Google viene inizializzato per la prima volta. Ad esempio, un utente potrebbe visitare il tuo sito ed eseguire l'accesso solo in un secondo momento.

Per impostare o aggiornare il user_id dopo il caricamento iniziale della pagina, utilizza il gtag('set') comando. Questo comando imposta user_id per tutti gli eventi successivi sulla pagina ed è l'approccio consigliato anziché gtag('config') in questo scenario.

Impostare lo User-ID al momento dell'accesso

Quando un utente esegue l'accesso correttamente, chiama gtag('set') per associare il suo ID agli eventi futuri:

// Example function called after successful login
function handleUserLogin(userId) {
  if (userId) {
    gtag('set', {'user_id': userId});
    console.log('User ID set for GA:', userId);

    // You can also send a login event
    gtag('event', 'login', { method: 'your_login_method' });
  }
}

// Example usage:
// handleUserLogin('12345_user');

Cancellare lo User-ID al momento della disconnessione

Quando un utente si disconnette, devi cancellare user_id impostando il relativo valore su null:

// Example function called after logout
function handleUserLogout() {
  gtag('set', {'user_id': null});
  console.log('User ID cleared for GA.');

  // You can also send a logout event
  gtag('event', 'logout');
}

// Example usage:
// handleUserLogout();

Utilizzando gtag('set'), ti assicuri che user_id venga gestito correttamente durante la sessione utente, riflettendo lo stato di accesso attuale dell'utente anche se cambia dopo il caricamento della pagina.

Indietro
Aggiungi parametri
Avanti
Misura eccezioni