Questa pagina è dedicata agli sviluppatori che devono configurare il tag Google utilizzando gtag.js. Il tag Google ti consente anche di modificare alcune impostazioni nell'interfaccia utente. Per maggiori dettagli, consulta Configurare 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 spiega come:
- Stabilire il flusso di dati tra il tuo sito web e i prodotti Google utilizzando il comando
config - Inviare eventi ai prodotti Google utilizzando il comando
event - Impostare i valori inviati con ogni evento utilizzando il comando
set
Prima di iniziare
Questa guida presuppone che tu abbia già:
- Acquisito familiarità con il funzionamento del tag Google
- 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 a cui vuoi collegare il tag Google
Che cos'è un ID tag e dove trovarlo?
Un ID tag identifica un tag Google. Un singolo tag Google può avere più ID tag. Ad esempio, se utilizzi Google Ads, il tuo tag ora ha due ID: un ID legacy (AW) e un ID tag Google (GT).
Gli ID tag sono intercambiabili. La tabella seguente contiene una panoramica dei tag compatibili con il tag Google.
| Prefisso | Tipo di ID | Descrizione |
|---|---|---|
| GT-XXXXXX | Tag Google | Ogni tag Google appena creato riceve un prefisso GT e un ID univoco. |
| G-XXXXXX | Tag Google (prefisso legacy) | I tag Google Analytics sono tag Google con un prefisso G e un ID univoco. |
| AW-XXXXXX | Tag Google (prefisso legacy) | I tag Google Ads sono tag Google con un prefisso AW e un ID univoco. |
| DC-XXXXXX | Tag Google (prefisso legacy) | I tag Google Floodlight sono tag Google con un prefisso DC e un ID univoco. |
Trovare l'ID tag:
Passaggio 1: collegare 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 degli eventi.
Il comando ha il seguente formato:
gtag('config', 'TAG_ID', {<additional_config_params>});
Parametri di configurazione aggiuntivi
Puoi modificare ed estendere un comando config specificando i parametri nell'oggetto
facoltativo {<additional_config_params>}. Ad esempio, se aggiungi il seguente parametro, impedisci l'invio automatico di una visualizzazione di pagina di Google Analytics:
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 per il 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ù sul comportamento del 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: inviare 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 degli eventi ai prodotti che hai specificato con config. Il comando ha il seguente formato:
gtag('event', 'event_name', {
'key': 'value',
});
Informazioni sui nomi degli eventi e sulle coppie chiave-valore
Eventi consigliati: gli eventi consigliati sono quelli che implementi, ma che hanno coppie chiave-valore predefinite. Questi eventi sbloccano le funzionalità di generazione di report esistenti e future.
Eventi personalizzati: per definire i tuoi eventi e le tue strutture di dati, puoi inserire valori personalizzati per inviare un evento personalizzato.
Configurare gli eventi
Puoi chiamare il metodo event in qualsiasi punto del codice dopo aver inizializzato il tag Google.
Definisci un evento. Se utilizzi un evento consigliato, assicurati di utilizzare i nomi degli eventi standardizzati e le coppie chiave-valore predefinite.
Definisci quando verrà attivato l'evento, ad esempio se viene inviato con il caricamento di una pagina o quando qualcuno fa clic su un pulsante.
Esempio
L'esempio seguente illustra un modo possibile per misurare le registrazioni 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) Inviare 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 a più tag nella stessa pagina.
Il comando ha il seguente formato:
gtag('set', 'parameterName');
Passaggio 3: convalidare la configurazione
Per assicurarti che i dati degli eventi vengano inviati correttamente:
- Apri il prodotto Google in cui prevedi di visualizzare i dati.
- Verifica se i dati vengono ricevuti. Ogni prodotto ha un luogo diverso in cui puoi verificare se i dati vengono ricevuti:
- Google Analytics: controlla il report in tempo reale.
- Google Ads: controlla la tabella Azioni di conversione e la colonna Stato (l'aggiornamento può richiedere fino a 24 ore ).
- Floodlight: utilizza Tag Assistant per verificare che i tag Floodlight vengano attivati.
Passaggi successivi
Dopo aver configurato i prodotti Google e gli eventi, la configurazione di base del tag Google è completata.
Se gestisci più prodotti e vuoi gestire il flusso di dati in modo più dettagliato, consulta Raggruppare e indirizzare i dati.