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, 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.

Il parametro user_id è un parametro di configurazione, non una proprietà utente personalizzata o un parametro evento standard. user_id è invece un parametro di sistema riservato utilizzato specificamente per identificare gli utenti autenticati su dispositivi e sessioni. Non impostarlo come proprietà utente personalizzata (ad esempio, nell'oggetto user_properties per gtag.js o nella sezione Proprietà utente dei tag Google Tag Manager) e non registrarlo come dimensione personalizzata nell'interfaccia utente di Analytics. Allo stesso modo, non trasmetterlo come parametro a livello di evento per i singoli eventi. Imposta invece user_id solo come parametro di configurazione utilizzando i seguenti metodi.


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".

Imposta 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 nella 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 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.

Come viene utilizzato lo User-ID in Google Analytics

Una volta inviati i valori di user_id a Google Analytics, questi vengono utilizzati per:

  • Unificare i percorsi degli utenti:collega l'attività utente in diverse sessioni, dispositivi e piattaforme per gli utenti che hanno eseguito l'accesso.
  • Migliorare i conteggi degli utenti: fornisci metriche utente più accurate e deduplicate.
  • Attiva analisi:
    • Analizza l'attività in base allo stato di accesso: utilizza dimensioni come "Accesso eseguito con lo User-ID" per creare confronti nei report standard o segmenti nelle esplorazioni.
    • Supporta la tecnica di esplorazione Esplorazione utente, che ti consente di visualizzare in dettaglio la cronologia delle attività dei singoli utenti.

Considerazioni importanti

  • NON creare dimensioni personalizzate per User-ID:non registrare user_id come dimensione personalizzata basata sugli utenti. Si tratta di una best practice fondamentale. In questo modo, viene creata una dimensione ad alta cardinalità non necessaria, che può influire notevolmente sul rendimento dei report, causare il raggruppamento dei dati nella riga "(other)" e consumare la quota di dimensioni personalizzate. La funzionalità User-ID integrata gestisce l'unione degli utenti. Scopri di più in Best practice per lo User-ID.

  • Imposta user_id come impostazione di configurazione, non come proprietà utente o parametro evento:poiché user_id è un parametro di sistema riservato, deve essere applicato solo come parametro di configurazione o impostazione (utilizzando i comandi gtag(), config o set oppure le impostazioni di configurazione del tag Google di Google Tag Manager). Non configurarlo come proprietà utente personalizzata, non passarlo all'interno dell'oggetto impostazioni user_properties e non inviarlo come parametro a livello di evento per i singoli eventi.

  • Visibilità diretta dell'ID nei report standard e nelle esplorazioni:i valori user_id non sono disponibili come dimensione standard nei report standard o nella maggior parte delle esplorazioni (ad esempio, formato libero) per mantenere la privacy e gestire la cardinalità. Tuttavia, puoi visualizzare il valore user_id non elaborato nel modello di esplorazione Esplorazione utente nella colonna etichettata ID utente effettivo per gli utenti che hanno eseguito l'accesso.

  • Accesso agli ID utente non elaborati:se devi eseguire l'analisi utilizzando i valori user_id non elaborati, l'approccio consigliato è utilizzare l'esportazione BigQuery di GA4. Il campo user_id è disponibile nei dati esportati.

Per assicurarti che i dati User-ID vengano utilizzati e siano visibili nello Spazio di esplorazione, assicurati che l'identità report della proprietà sia impostata su Mista o Osservata.

Indietro
Aggiungi parametri
Avanti
Misura eccezioni