Inviare gli ID utente

Gli ID utente sono identificatori univoci 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.

Il parametro user_id è un parametro di configurazione, non una proprietà utente personalizzata o un parametro evento standard. Invece, user_id è 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 di Google Tag Manager) e non registrarlo come dimensione personalizzata nell'interfaccia utente di Analytics. Allo stesso modo, non passarlo 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 gli 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 aveva eseguito l'accesso, ma poi si è disconnesso: 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 si è disconnesso.
  3. Se un utente ha eseguito l'accesso, sostituisci USER_ID con il suo ID utente.
  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 l'ID utente 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 l'ID utente 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 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 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 User-ID in Google Analytics

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

  • Unificare i percorsi utente: 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.
  • Consentire l'analisi:
    • Analizza l'attività in base allo stato di accesso: utilizza dimensioni come "Accesso eseguito con l'ID utente" per creare confronti nei report standard o segmenti in Esplorazioni.
    • Potenzia la tecnica di esplorazione Esplorazione utente, che ti consente di approfondire la sequenza temporale delle attività dei singoli utenti.

Considerazioni importanti

  • NON creare dimensioni personalizzate per l'ID utente: non devi registrare user_id come dimensione personalizzata basata sugli utenti. Questa è una best practice fondamentale. In questo modo, crei una dimensione ad alta cardinalità non necessaria, che può influire notevolmente sulle prestazioni 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 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 di 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 delle impostazioni user_properties e non inviarlo come parametro a livello di evento per i singoli eventi.

  • Visibilità diretta dell'ID nei report standard rispetto alle esplorazioni: i valori user_id non elaborati non sono disponibili come dimensione standard nei report standard o nella maggior parte delle esplorazioni (ad esempio, Forma libera) per mantenere la privacy e gestire la cardinalità. Tuttavia, puoi visualizzare 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 di Google Analytics 4 su BigQuery. Il campo user_id è disponibile nei dati esportati.

Per assicurarti che i dati User-ID vengano utilizzati e siano visibili in Esplorazione utente, verifica che l'identità report della tua proprietà sia impostata su Combinata o Osservata.

Indietro
Aggiungi parametri
Avanti
Misura eccezioni