E-commerce GA4 (gtag.js): inviare eventi GA4

Questa guida descrive come eseguire la migrazione di un'implementazione e-commerce di gtag.js Universal Analytics esistente per utilizzare gli eventi di e-commerce Google Analytics 4.

Visita il Centro di migrazione per gli sviluppatori per ulteriori risorse e guide alla migrazione.

Risultato

In base a questa guida, implementerai gli eventi e-commerce di Google Analytics 4 per una nuova proprietà GA4 e userai questa nuova implementazione per completare i report Universal Analytics esistenti. L'implementazione esistente di Universal Analytics verrà modificata per ricevere i dati e-commerce di GA4.

Attenzione: anche se gli eventi e-commerce di Google Analytics 4 vengono tradotti automaticamente per essere compatibili con Universal Analytics, non tutti gli eventi di Google Analytics 4 hanno un evento equivalente in Universal Analytics. Per questi eventi mancheranno dati nei report sull'e-commerce di Universal Analytics. Consulta Pro e contro e considerazioni di seguito.

Prima di iniziare

1. Utilizza lo strumento di supporto per la migrazione dell'e-commerce per verificare che quanto segue descrivi la tua implementazione attuale:

   • Stai utilizzando una proprietà Universal Analytics
   • Il tuo sito utilizza la libreria gtag.js per inviare eventi di e-commerce

2. Consulta le opzioni di migrazione per le implementazioni dell'e-commerce per conoscere i compromessi di ciascuna opzione. Conferma di voler seguire questa guida per utilizzare gli eventi e-commerce di Google Analytics 4 per l'implementazione esistente di Universal Analytics gtag.js.

3. Consulta il riferimento sulla compatibilità degli eventi per scoprire come vengono tradotti gli eventi UA quando vengono inviati a una proprietà GA4.

Vantaggi e considerazioni

Esamina e considera le informazioni riportate di seguito per comprendere appieno le implicazioni dell'utilizzo degli eventi di e-commerce di Google Analytics 4 con l'implementazione esistente dell'e-commerce gtag.js (Universal Analytics).

Vantaggi	Svantaggi
Ti consente di visualizzare i dati di e-commerce nei report di GA4 e di Universal Analytics. L'utilizzo degli eventi e dei parametri GA4 garantisce report e-commerce GA4 completi.	Richiede la modifica degli eventi di e-commerce esistenti. Non tutti gli eventi e i parametri GA4 hanno equivalenti in Universal Analytics. I parametri shipping_tier, discount, currency, location_id, promotion_name e promotion_id non hanno equivalenti Universal Analytics e non verranno visualizzati nei report di Universal Analytics.

Implementazione

1. Aggiornare l'implementazione dell'e-commerce

Aggiorna l'implementazione dell'e-commerce esistente per eseguire la migrazione dagli eventi di e-commerce di Universal Analytics agli eventi di Google Analytics 4. Una volta completato questo passaggio, la proprietà Universal Analytics riceverà gli eventi di e-commerce GA4. Esamina i vantaggi e le considerazioni per comprendere le implicazioni di questo aggiornamento.

Per aiutarti con l'aggiornamento, utilizza le seguenti risorse:

• Consulta la guida sull'e-commerce di Google Analytics 4 per scoprire come inviare gli eventi e-commerce GA4.
• Le informazioni disponibili nelle sezioni Compatibilità tra eventi UA e GA4 e Parametri paragonabili per UA e GA4. Queste informazioni ti aiuteranno a mappare i nomi e i parametri degli eventi di e-commerce di Universal Analytics a eventi e parametri equivalenti per Google Analytics 4.
• Lo strumento di supporto per la migrazione dell'e-commerce per verificare di aver aggiornato correttamente gli eventi di e-commerce.

2. Creare e configurare una nuova proprietà GA4

Dopo aver aggiornato l'implementazione dell'e-commerce per inviare gli eventi e-commerce GA4, completa una delle seguenti opzioni per iniziare a inviare dati a una nuova proprietà Google Analytics 4.

Opzione 1: utilizzare l'Assistente alla configurazione GA4 e attivare i tag del sito collegati

L'Assistente alla configurazione GA4 creerà automaticamente una nuova proprietà GA4 e copierà le seguenti impostazioni dalla proprietà Universal Analytics: nome proprietà, URL del sito web, fuso orario e impostazioni valuta. Può anche attivare la funzionalità tag del sito collegato per riutilizzare l'implementazione esistente di gtag.js di Universal Analytics al fine di caricare la nuova proprietà GA4.

Segui i passaggi descritti nell'Assistente alla configurazione GA4 per creare e configurare una nuova proprietà Google Analytics 4. Assicurati di selezionare l'opzione Attiva la raccolta dati utilizzando i tag esistenti per utilizzare la funzionalità dei tag del sito collegati.

Opzione 2: aggiorna lo snippet gtag.js

1. Crea una nuova proprietà Google Analytics 4.
   • Utilizza l'Assistente alla configurazione GA4 per aggiungere una proprietà Google Analytics 4. Tuttavia, deseleziona l'opzione Attiva la raccolta dati utilizzando i tag esistenti quando richiesto durante la configurazione. In alternativa, crea una proprietà Google Analytics 4 senza l'Assistente alla configurazione GA4. Il vantaggio di usare l'assistente è che copierà alcune impostazioni di base della tua proprietà Universal Analytics.
2. Trova l'ID tag della proprietà Google Analytics 4.
3. Aggiungi la proprietà Google Analytics 4 allo snippet gtag.js esistente utilizzando il comando config con l'ID tag.

Di seguito è riportato un esempio di snippet gtag.js in cui è configurata una proprietà Universal Analytics e Google Analytics 4:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');  // Universal Analytics property
  gtag('config', 'TAG_ID');  // Google Analytics 4 property
</script>