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.

Avviso :non impostare dimensioni personalizzate in base agli ID utente.

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

gtag.js Tag Manager

Prima di iniziare

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

• Crea un account e una proprietà Google Analytics.
• Crea uno stream di dati web per il tuo sito web.
• Posiziona il tag Google sul tuo sito web.
• Avere accesso al codice sorgente del tuo sito web.
• Disporre del ruolo di Editor (o superiore) per l'account Google Analytics.

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