Inviare gli ID utente

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

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

L'impostazione di dimensioni personalizzate basate sugli ID utente comporta dimensioni con troppi valori univoci. La presenza di troppi valori univoci causa problemi con l'accuratezza dei dati e dei report di Google Analytics. Scopri di più sulle best practice per l'impostazione di dimensioni personalizzate.


Prima di iniziare

Prima di poter inviare ID utente, assicurati di aver completato le seguenti operazioni:

Inviare gli ID utente

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 ID utente.
  • L'utente ha eseguito l'accesso, poi ha eseguito la disconnessione: invia null.

Per inviare un ID utente ad Analytics, aggiungi il parametro user_id al comando config in 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 ha eseguito la disconnessione.
  3. Se un utente ha eseguito l'accesso, sostituisci USER_ID con il suo ID utente.
  4. Quando un utente esce, imposta user_id su null. Non inviare una stringa vuota (""), una stringa vuota (" ") o le parole tra virgolette "null" o "NULL".

Impostare l'ID utente dopo l'inizializzazione

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

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

Impostare l'ID utente all'accesso

Quando un utente esegue l'accesso, 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');

Cancella l'ID utente 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 il user_id venga gestito correttamente durante la sessione utente, riflettendo lo stato di accesso corrente dell'utente anche se cambia dopo il caricamento della pagina.

Indietro
Aggiungi parametri
Avanti
Misura eccezioni