Eventi

Questo articolo fornisce indicazioni su come eseguire la migrazione degli eventi di Universal Analytics (UA) agli eventi di Google Analytics 4 (GA4).

Poiché i modelli di misurazione per UA e GA4 sono diversi, ti consigliamo di ripensare la raccolta dei dati in termini di modello GA4 anziché trasferire la struttura degli eventi UA esistente a GA4.

Per scoprire di più sugli eventi GA4, consulta l'articolo Informazioni sugli eventi.

Confronto tra gli eventi UA e GA4

Universal Analytics

Per Universal Analytics (UA), la misurazione viene eseguita inviando hit. La maggior parte dei tipi di hit viene utilizzata per misurare interazioni specifiche (ad es. pageview), ma il tipo di hit event è disponibile per la misurazione personalizzata/generale. I dati inviati con un hit event includono Categoria, Azione ed Etichetta.

Di seguito sono riportati eventi Universal Analytics di esempio per le librerie analytics.js e gtag.js:

analytics.js (UA)

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js (UA)

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

Google Analytics 4

Per Google Analytics 4 (GA4), la misurazione viene eseguita inviando eventi. Esistono eventi raccolti automaticamente, eventi predefiniti e consigliati per l'invio quando opportuno ed eventi personalizzati che puoi inviare nei casi in cui gli eventi automatici o consigliati non soddisfano il tuo caso d'uso.

Di seguito è riportato un esempio di evento personalizzato in GA4:

gtag.js (GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

Mappare un evento UA a GA4

Per eseguire la migrazione dell'evento UA a GA4, devi identificare se esiste un evento GA4 equivalente. Per mappare un evento UA a GA4, utilizza il seguente approccio graduale:

  1. Consulta l'elenco degli eventi raccolti automaticamente. Se un evento GA4 raccolto automaticamente corrisponde a quello UA, rimuovilo e fai affidamento su quello raccolto automaticamente.

  2. Se non hai trovato una corrispondenza nel passaggio precedente, esamina gli eventi raccolti tramite la misurazione avanzata. Se un evento di misurazione avanzata GA4 corrisponde molto allo scopo dell'evento UA, non eseguirne la migrazione e utilizza la misurazione avanzata per inviarlo. Assicurati di confermare che la misurazione avanzata sia configurata correttamente affinché la tua proprietà GA4 possa raccogliere l'evento.

  3. Se non hai trovato una corrispondenza nel passaggio precedente, consulta l'elenco di Eventi consigliati. Se un evento GA4 consigliato corrisponde molto a quello dell'evento UA, utilizzalo e imposta eventuali parametri evento applicabili quando invii l'evento.

  4. Se non hai trovato una corrispondenza nel passaggio precedente, invia un evento personalizzato.

Scenari ed esempi di migrazione

Eventi raccolti automaticamente

Gli eventi raccolti automaticamente vengono sempre inviati e in genere non possono essere disattivati, a meno che non siano configurabili tramite la misurazione avanzata. In generale, non devi eseguire la migrazione di eventi UA per i quali esiste un evento raccolto automaticamente sufficientemente equivalente.

Ad esempio, probabilmente non sarà necessario eseguire la migrazione a GA4 di un evento UA inviato per misurare un'interazione di download di un file, poiché l'evento file_download in GA4 viene raccolto automaticamente.

Misurazione avanzata

In generale, non è necessario eseguire la migrazione degli eventi UA a GA4 quando un evento GA4 sufficientemente equivalente viene raccolto tramite la misurazione avanzata. Ad esempio, probabilmente non sarà necessario eseguire la migrazione a GA4 dei seguenti eventi UA perché sono già misurati in GA4 tramite la misurazione avanzata:

Override della misurazione avanzata

Se un evento di misurazione avanzata ha lo scopo equivalente all'evento UA, ma non acquisisce tutti i dati di cui hai bisogno, puoi inviare manualmente l'evento con parametri personalizzati aggiuntivi. Devi configurare/disattivare la misurazione avanzata per l'evento corrispondente e inviare manualmente l'evento GA4.

Ad esempio, l'evento file_download raccolto tramite la misurazione avanzata corrisponde molto al tuo evento UA, ma mancano informazioni sulle dimensioni del file. Per eseguire l'override dell'evento di misurazione avanzata e includere informazioni sulle dimensioni del file:

  1. Disabilita i download di file in Misurazione avanzata.
  2. Dove appropriato, invia manualmente l'evento file_download con i parametri personalizzati.
    • Poiché l'evento raccolto automaticamente viene disattivato tramite la misurazione avanzata, dovrai impostare manualmente i parametri che normalmente verrebbero raccolti con l'evento (ad es. file_extension, file_name e così via).
  3. Crea una dimensione/metrica personalizzata per visualizzare i valori dei parametri personalizzati nei report.

Il seguente esempio di gtag.js invia un evento file_download GA4 con un parametro personalizzato file_size.

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

Se il tuo evento UA ha un evento consigliato GA4 sufficientemente equivalente , esegui la migrazione dell'evento UA all'evento consigliato.

L'esempio seguente è un evento UA analytics.js per misurare un accesso:

ga('send', 'event', 'login', 'google-sso');

L'evento login GA4 può essere utilizzato per eseguire la migrazione dell'evento UA a GA4. L'equivalente gtag.js di GA4 è il seguente:

gtag('event', 'login', {
  method: 'google-sso'
});

Evento personalizzato

Se al tuo evento UA non corrisponde un evento Raccolta automatica, Misurazione avanzata o Evento consigliato corrispondente, esegui la migrazione dell'evento UA a un evento personalizzato e crea dimensioni e metriche personalizzate in base alle tue esigenze.

L'esempio seguente mostra un evento UA analytics.js che misura le modifiche alle opzioni di orientamento dell'interfaccia utente:

ga('send', 'event', 'orientation', 'layout', 'wide');

Non esiste un evento GA4 predefinito per misurare l'evento UA indicato sopra. Invece, il seguente esempio di gtag.js mostra come viene utilizzato un evento personalizzato per misurare la stessa interazione in GA4:

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

Per includere ui_element e configuration nei report, devi creare le dimensioni corrispondenti da questi parametri evento. Per scoprire di più, consulta Dimensioni e metriche personalizzate.