Configurare i prodotti Google e inviare dati sugli eventi

Questa pagina è rivolta agli sviluppatori che devono configurare il tag Google utilizzando gtag.js. Per regolare le impostazioni nell'interfaccia utente, consulta Configura le impostazioni del tag Google.

Dopo aver installato il tag Google, puoi chiamare i comandi gtag() in qualsiasi punto del codice dopo lo snippet del tag Google.

Questa pagina mostra come:

1. Invia eventi ai tuoi prodotti Google utilizzando il comando event
2. Imposta i valori inviati con ogni evento utilizzando il comando set

Prima di iniziare

Questa guida presuppone che tu abbia fatto quanto segue:

• Aver acquisito familiarità con il funzionamento del tag Google
• Aver installato il tag Google

Per configurare il flusso di dati, devi avere:

• Accesso al codice del sito web in cui hai installato il tag Google
• L'ID tag del prodotto Google che vuoi collegare al tag Google.

Passaggio 1: collega i prodotti Google al tag

Utilizza il comando config per stabilire il flusso di dati verso i prodotti Google.

Informazioni sul comando config

Il comando config specifica i prodotti Google a cui vuoi inviare i dati sugli eventi. Il comando ha il seguente formato:

gtag('config', 'TAG_ID', {<additional_config_params>});

gtag('config', 'TAG_ID', {'send_page_view': false});

Configurare la raccolta dei dati

Per configurare la raccolta dei dati per un prodotto Google, aggiungi il comando config con un ID tag.

Esempio

Il tag Google (GT-XXXXXX) invia i dati alle destinazioni che hai definito, ad esempio Google Ads e Google Analytics.

L'esempio seguente mostra come aggiornare il codice per caricare un secondo tag Google collegato a una destinazione Floodlight.

Per inviare dati a Floodlight (ID tag DC-ZZZZZZ), aggiungi un altro comando config dopo aver inizializzato il primo tag Google (ID tag GT-XXXXXX):

<head>
 ...
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments)};
  gtag('js', new Date());
  gtag('config', 'GT-XXXXXX');
  gtag('config', 'DC-ZZZZZZ');
</script>
</head>

Comportamento di config specifico del prodotto

A seconda del prodotto specificato in TAG_ID, il comando config può anche avviare un determinato comportamento per quel prodotto. Ad esempio, in alcuni casi il comando config indica a gtag.js di avviare un evento di visualizzazione di pagina.

Per saperne di più su come si comporta il comando config in relazione ai singoli prodotti, consulta la documentazione specifica del prodotto:

• Conversioni di Google Ads e remarketing
• Campaign Manager e Display & Video 360
• Search Ads 360
• Google Analytics

Passaggio 2: invia i dati con event

Dopo aver configurato le connessioni ai prodotti Google, devi utilizzare il comando event per inviare i dati.

Informazioni sul comando event

Il comando event ti consente di inviare i dati sugli eventi ai prodotti specificati con config. Il comando ha il seguente formato:

gtag('event', 'event_name', {
  'key': 'value',
});

Configurare gli eventi

Puoi chiamare il metodo event in qualsiasi punto del codice dopo l'inizializzazione del tag Google.

1. Definisci un evento. Se utilizzi un evento consigliato, assicurati di utilizzare i nomi degli eventi standardizzati e le coppie chiave-valore predefinite.

2. Definisci quando verrà attivato l'evento, ad esempio se viene inviato con un caricamento pagina o quando un utente fa clic su un pulsante.

Esempio

L'esempio seguente illustra un possibile modo per misurare le iscrizioni alla newsletter quando un utente fa clic su un pulsante. L'esempio utilizza un evento personalizzato e lo invia a una proprietà Google Analytics.

<head>
   ...
   /* 1. Initialize the Google tag and gtag.js library */
   <!-- Google tag (gtag.js) -->
   <script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
   <script>
     window.dataLayer = window.dataLayer || [];
     function gtag(){dataLayer.push(arguments)};
     gtag('js', new Date());
     gtag('config', 'TAG_ID');
   </script>
</head>

<body>
   <script>
     let date = Date.now();
     /* 2. Define your event. */
     function newsletterSignup() {
       gtag('event', 'newsletter_signup', {
       'time': date,
       });
   }
   </script>
   ...
   /* 3. Trigger your event */
   <button type="submit" onclick="newsletterSignup()">Sign me up!</button>
   ...
</body>

(Facoltativo) Invia i dati con ogni evento utilizzando set

Il comando set ti consente di definire i parametri che verranno associati a ogni evento successivo nella pagina.

Ad esempio, puoi condividere i parametri della campagna in modo che siano accessibili da più tag nella stessa pagina.

Il comando ha il seguente formato:

gtag('set', 'parameterName');

Passaggio 3: convalida la configurazione

Per assicurarti che i dati sugli eventi vengano inviati correttamente:

1. Apri il prodotto Google in cui prevedi di visualizzare i dati.
2. Controlla se i dati vengono ricevuti. Ogni prodotto ha un luogo diverso in cui puoi controllare se i dati vengono ricevuti:
   • Google Analytics: controlla il report In tempo reale.
   • Google Ads: controlla la tabella Azioni di conversione e osserva la colonna Stato (l'aggiornamento potrebbe richiedere fino a 24 ore).
   • Floodlight: utilizza Tag Assistant per verificare che i tag Floodlight vengano attivati.

Passaggi successivi

Dopo aver configurato i prodotti e gli eventi Google, hai completato la configurazione di base del tag Google.

Se gestisci più prodotti e vuoi gestire il flusso di dati in modo più dettagliato, consulta Raggruppa e indirizza i dati.