Inviare gli ID utente

Gli ID utente sono i tuoi identificatori univoci che assegni ai singoli utenti. Questa guida spiega come inviare gli ID utente a Google Analytics per collegare il comportamento degli utenti in sessioni, dispositivi e piattaforme diversi.

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

Avviso: non impostare dimensioni personalizzate in base agli ID utente. L'impostazione di dimensioni personalizzate basate sugli ID utente genera dimensioni con troppi valori univoci. La presenza di troppi 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.

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 più 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 trasmetterlo come parametro a livello di evento per i singoli eventi. Imposta invece user_id solo come parametro di configurazione utilizzando i seguenti metodi.

Tag Manager gtag.js

Prima di iniziare

Prima di poter inviare gli ID utente, assicurati di aver completato quanto segue:

• Crea un account e una proprietà Google Analytics.
• Crea uno stream di dati web per il sito web.
• Inserito gli snippet di Tag Manager sul tuo sito web.
• Installa il tag Google in Tag Manager. In precedenza, questo era il tag di configurazione di Google Analytics.
• Avere accesso al contenitore di Tag Manager per il sito web.
• Disporre del ruolo 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 e poi è uscito: invia null.

Passaggio 1: aggiorna il livello dati

Prima di inviare gli ID utente ad Analytics, rendi disponibile user_id nel livello dati del tuo sito web.

Puoi aggiornare il livello dati durante il caricamento iniziale della pagina o dopo il caricamento della pagina (ad esempio, quando un utente accede). Ogni volta che chiami dataLayer.push, tutti i tag Tag Manager associati riceveranno il valore user_id aggiornato.

Punto chiave: per assicurarti che user_id sia associato all'evento di visualizzazione di pagina iniziale e a tutti gli eventi successivi, devi dichiarare il livello dati ed eseguire il push di user_id sopra (prima) dello snippet contenitore di Google Tag Manager nella pagina. Se l'oggetto user_id viene inviato dopo lo snippet GTM, non sarà disponibile quando i tag vengono attivati in base all'evento di caricamento del contenitore.

if (/* your logic for determining if the user is signed in */) {
  dataLayer.push({
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  dataLayer.push({
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}

1. Sostituisci i commenti con i controlli per verificare se l'utente ha eseguito l'accesso e se l'utente ha eseguito l'accesso, ma poi è uscito.
2. Se un utente ha eseguito l'accesso, sostituisci USER_ID con il suo ID utente.
3. Quando un utente si disconnette, imposta user_id su null. Non inviare una stringa vuota (""), una stringa vuota (" ") o le parole tra virgolette "null" o "NULL".

Passaggio 2: crea una variabile del livello dati

1. In Google Tag Manager, fai clic su Variabili.
2. Nella sezione Variabili definite dall'utente, fai clic su Nuova.
3. Fai clic su Configurazione variabile > Variabile di livello dati.
4. Inserisci un nome per la variabile in alto.
5. Nel campo Nome variabile livello dati, inserisci un nome per la variabile ID utente (ad esempio "user_id").
6. Fai clic su Salva.

Passaggio 3: modifica il tag Google

Infine, modifica il tag di configurazione in modo che tutti gli eventi associati al tag utilizzino la variabile del livello dati:

1. In Tag Manager, fai clic su Tag.
2. Seleziona il tag Google.
3. Nella sezione Impostazioni di configurazione, aggiungi una nuova riga con i seguenti parametri:
   • Parametro: user_id
   • Valore: seleziona la variabile di livello dati che hai creato.
4. Fai clic su Salva.
5. Fai clic su Invia per pubblicare le modifiche.

Come viene utilizzato lo User-ID in Google Analytics

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

• Unifica 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.
• Abilita l'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.
  • Potenziare 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 lo User-ID: non devi registrare user_id come dimensione personalizzata basata sugli utenti. Questa è una best practice fondamentale. In questo modo, viene creata una dimensione ad alta cardinalità non necessaria, che può influire negativamente 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ù nelle 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 trasmetterlo all'interno dell'oggetto delle impostazioni user_properties e non inviarlo come parametro a livello di evento per i singoli eventi.

• Visibilità diretta degli ID nei report standard rispetto alle esplorazioni: i valori user_id grezzi 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 ID utente effettivo per gli utenti che hanno eseguito l'accesso.

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

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