Il tag Google (gtag.js) è uno snippet di codice che può essere aggiunto a un sito web per misurare l'attività utente su diversi prodotti Google, tra cui Google Analytics 4, Google Ads e Google Marketing Platform. Scopri di più sul tag Google
Questa guida descrive come integrare il tag Google nel tuo sistema di gestione dei contenuti (CMS) o nello strumento per la creazione di siti web per fornire agli utenti finali l'accesso ai prodotti di misurazione di Google.
Pubblico
Questa guida è rivolta ai proprietari di sistemi di gestione dei contenuti (CMS) o agli strumenti per la creazione di siti web che vogliono offrire ai propri utenti un'integrazione con i prodotti di misurazione di Google. Questa guida non è destinata agli utenti che utilizzano un CMS o uno strumento per la creazione di siti web.
Prima di iniziare
Assicurati di disporre di un ID sviluppatore del tag Google. Se non disponi di un ID sviluppatore di tag Google, compila il modulo di richiesta ID sviluppatore di tag Google. L'ID sviluppatore è diverso dagli altri ID, come l'ID misurazione o l'ID conversione, che gli utenti finali aggiungono al codice di misurazione del loro sito web.
Panoramica
Per integrare la tua piattaforma con i prodotti Google:
- Creare un'integrazione con il tag Google
- Aggiornare la struttura dell'input utente
- Implementare l'API Consent
- Configurare i dati sugli eventi
- Verificare l'integrazione aggiornata
- Aggiornare le istruzioni per l'implementazione degli utenti
Creare un'integrazione con il tag Google
Creando un'integrazione con il tag Google, i clienti possono implementare i prodotti di misurazione Google (tramite gtag.js) su ogni pagina del loro sito. Assicurati di rimuovere tutte le integrazioni dei tag precedenti esistenti (ad es. analytics.js) prima di creare un'integrazione con gtag.js.
Per creare un'integrazione con il tag Google, sostituisci lo snippet di codice esistente con il seguente snippet. Assicurati che gli utenti possano sostituire TAG_ID
con
il proprio ID tag.
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GOOGLE_TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
gtag('config', 'GOOGLE_TAG_ID');
</script>
Tieni presente quanto segue:
- Gli inserzionisti possono disattivare le funzionalità di personalizzazione degli annunci come il remarketing con il parametro
allow_ad_personalization_signals
. Consulta la sezione Disattivare la raccolta di dati per la pubblicità personalizzata. - Idealmente, lo snippet del tag Google dovrebbe apparire solo una volta per pagina. Lo snippet può contenere più ID tag. Se esiste già un'istanza di gtag.js, devi aggiungere nuovi ID tag al tag esistente. Scopri di più
Aggiorna la struttura dell'input utente
I tuoi clienti devono essere in grado di fornire più forme per il proprio ID tag Google tramite un'unica interfaccia, indipendentemente dal prodotto di misurazione Google di cui stanno eseguendo il deployment.
Ad esempio, quanto riportato di seguito mostra un semplice input del tag Google. L'integrazione deve essere inquadrata come un deployment del tag Google. Può essere sottotitolato come metodo per implementare Google Ads e Google Analytics.
In alternativa, il seguente diagramma mostra in che modo una piattaforma potrebbe avere flussi utente distinti per Analytics e Google Ads, ma ciascun flusso indirizza a un'unica interfaccia in cui gli utenti forniscono il proprio ID tag Google.
L'ID tag inserito deve accettare più varianti ID utilizzando il pattern di espressione regolare [A-Z]{1,3}\w{5,}[\w]*
Implementare l'API Consent (modalità di consenso)
Il tag Google ha un'API Consent integrata per gestire il consenso degli utenti. È in grado di distinguere il consenso degli utenti per i cookie per gli annunci da quello per scopi di analisi.
Il risultato previsto è che i clienti ricevano almeno la chiamata gtag('consent', 'update' {...})
integrata senza che sia richiesta alcuna azione da parte del cliente. Ciò dovrebbe garantire che i tag Google (Google Ads, Floodlight, Google
Analytics, Linker conversioni) siano in grado di leggere lo stato più recente del consenso dell'utente e includere lo stato nelle richieste di rete a Google (tramite il parametro &gcs
).
Ulteriori passaggi di implementazione sono il deployment o l'assistenza agli inserzionisti nell'implementazione (ad es. tramite un'interfaccia utente) dello stato gtag('consent', default' {...})
e nello sblocco dei tag Google (ovvero nessuna attivazione condizionale basata sul consenso) per attivare la modalità di consenso in modo da attivarli in modo sensibile al consenso.
Per i dettagli dell'implementazione, consulta Gestire le impostazioni relative al consenso (web).
Configura i dati sugli eventi
Devi inviare dati avanzati sugli eventi dal sito web del cliente al suo Account Google senza che sia richiesta alcuna azione da parte del cliente. Ad esempio, puoi aggiungere gli eventi
lungo una canalizzazione di acquisto (come add_to_cart
, begin_checkout
,
add_payment_info
, add_shipping_info
e purchase
), generazione di lead e
registrazioni.
Di seguito sono riportate le best practice per l'aggiunta di eventi:
- Registra tutto il possibile
- Configura almeno 8 eventi principali
- Priorità agli eventi di e-commerce
Registra tutto il possibile
Se possibile, devi configurare gli eventi per impostazione predefinita. È incluso quanto segue:
- Eventi di conversione come
purchase
osign_up
- Eventi precedenti a eventi di conversione come
add_to_cart
- I coinvolgimenti comportamentali, come le interazioni con i media, aiutano i clienti a capire come interagiscono
Devi aggiungere snippet evento di conversione solo alle pagine di conversione (ad es. conferma di acquisto, conferma di invio modulo). Tieni presente che devi comunque aggiungere il tag Google a ogni pagina del sito.
Gli eventi vengono inviati utilizzando il comando event
.
È incluso lo stesso ID sviluppatore del tag Google che hai incluso nel tag
globale del sito descritto sopra:
gtag('event', 'my_event', {
'developer_id.<developer ID>': true,
// Additional event parameters
});
Ad esempio, puoi utilizzare il comando event
per inviare un evento login
con un
valore method
di "Google":
gtag('event', 'login', {
'developer_id.<developer ID>': true,
'method': 'Google'
});
<!-- Event snippet for sales conversion page -->
<script>
gtag('event', 'conversion', {
'developer_id.<developer ID>': true,
'value': <value>,
'currency': '<currency>',
'transaction_id': '<transaction_id>'
});
</script>
Tieni presente quanto segue:
- Il tuo ID sviluppatore
<developer ID>
è univoco e specifico per la tua piattaforma. Allega il documento di identità a ogni evento. - I seguenti parametri sono facoltativi e possono essere omessi:
'value'
è il valore numerico della conversione (ad es. il prezzo di un acquisto)'currency'
è un codice valuta di tre lettere, utile per gli inserzionisti che accettano più valute'transaction_id'
è un ID univoco della transazione (ad es. un ID ordine); viene utilizzato per la deduplicazione.
- Sebbene alcuni parametri siano facoltativi, consigliamo di includere tutte le informazioni disponibili per ogni evento.
- I parametri forniscono informazioni aggiuntive sulle modalità con cui gli utenti interagiscono con il tuo sito web o la tua app. Ad esempio, quando un utente visualizza un prodotto che vendi, puoi includere parametri che descrivono il prodotto che ha visualizzato, come nome, categoria e prezzo.
- Alcuni parametri completano automaticamente le dimensioni e le metriche predefinite in Google Analytics per offrire agli utenti una migliore comprensione dei loro clienti.
Se vuoi misurare un evento di conversione in base a un clic (ad es. un clic su un pulsante o una risposta dinamica per un sito che utilizza AJAX), puoi utilizzare anche il seguente snippet:
<!-- Event snippet for sales conversion page
In your HTML page, add the snippet and call gtag_report_conversion
when someone clicks on the chosen link or button. -->
<script>
function gtag_report_conversion(url) {
var callback = function () {
if (typeof(url) != 'undefined') {
window.location = url;
}
};
gtag('event', 'conversion', {
'developer_id.<developer ID>': true,
'value': <value>,
'currency': '<currency>',
'transaction_id': '<transaction_id>',
'event_callback': callback
});
return false;
}
</script>
Configura almeno 8 eventi principali
Ti consigliamo di impostare un insieme principale di eventi più importanti per i proprietari dei siti. Come minimo, ti consigliamo di configurare i seguenti eventi:
view_item_list
: quando un utente visualizza un elenco di articoli (ad es. un elenco di prodotti). Scopri di piùgtag('event', 'view_item_list', { item_list_id: "related_products", item_list_name: "Related products", items: [{ item_id: "SKU_123", item_name: "Test Item", currency: "USD", discount: 2.22, price: 99.9, quantity: 1 }] });
add_to_cart
: quando un utente aggiunge uno o più prodotti a un carrello degli acquisti. Scopri di piùgtag('event', 'add_to_cart', { value: 99.0, currency: "USD", items: [{ item_id: "SKU_123", item_name: "Test Product", price: 99.0, currency: ‘USD’, quantity: 1, item_category: "All Products" }] });
begin_checkout
: quando un utente avvia la procedura di pagamento per uno o più prodotti. Scopri di piùgtag('event', 'begin_checkout') { value: 99.0, currency: "USD", items: [{ item_id: "SKU_123", item_name: "Test Product", price: 99.0, currency: ‘USD’, quantity: 1, item_category: "All Products" }] });
purchase
: quando un utente acquista uno o più prodotti o servizi. Scopri di piùgtag('event', 'purchase', {value: XX, currency: 'USD', items: [{xx},{xx}]});
sign_up
: quando un utente si registra, in modo che l'utente finale possa vedere i metodi di registrazione più popolari (ad es. l'Account Google, l'indirizzo email). Scopri di piùgtag('event', 'sign_up', {method: 'web'});
generate_lead
: quando un utente invia un modulo. Scopri di piùgtag('event', 'generate_lead', {value: XX, currency: 'USD'});
subscribe
: quando un utente si iscrive a un servizio o a una newsletter.gtag('event', 'subscribe', {value: XX, currency: 'USD', coupon: 'XX'});
book_appointment
: quando un utente prenota un appuntamento.gtag('event', 'book_appointment', {value: XX, currency: 'USD', coupon: 'XX'});
Altri consigli
Google supporta molti altri eventi e parametri, in particolare per l'e-commerce. In generale, consigliamo di acquisire quanto segue:
- Qualsiasi evento riuscito direttamente associato al valore
- Eventi di successo che contribuiscono alle conversioni principali (add_to_cart, sign_up e così via)
- Interazioni e interazioni degli utenti, che aiutano gli inserzionisti a capire in che modo coinvolge gli utenti finali
Di seguito sono riportate ulteriori risorse che illustrano ulteriormente la raccolta di eventi:
- Eventi
- Eventi consigliati in base al caso d'uso
- Misurare l'e-commerce per le proprietà Google Analytics 4
Siamo interessati a discutere le potenziali estensioni di questo schema, quindi facci sapere se hai suggerimenti.
Verifica l'integrazione aggiornata
Prima di eseguire il push delle modifiche in produzione, verifica la compatibilità con quanto segue:
- Il tag Google con una destinazione Google Analytics 4
- Tag Google per il remarketing e la misurazione delle conversioni
Inoltre, verifica che il tag si attivi correttamente in tutte le pagine, incluse quelle di conversione, utilizzando uno dei seguenti strumenti:
- Google Tag Assistant: Tag Assistant ti consente di sapere quali tag Google sono stati attivati e in quale ordine. La modalità di debug di Tag Assistant mostra quali dati vengono trasmessi al livello dati e quali eventi hanno attivato questi scambi di dati.
- Strumenti per sviluppatori di Chrome: utilizza la scheda Rete per filtrare le richieste che contengono "google" e verificare in che modo vengono inviati i dati.
- (Lato server) Report in tempo reale di Google Analytics: crea un account Google Analytics senza costi e utilizza il report In tempo reale per verificare se gli hit del tag vengono ricevuti dai server di Google.
Per segnalare un bug o fornire feedback su informazioni mancanti, compila il modulo di assistenza per i sistemi di gestione dei contenuti.
Se possibile, condividi l'accesso di prova con Google per consentire la verifica continua.
Aggiorna le istruzioni per il deployment utente
Aggiorna la documentazione per fornire istruzioni chiare su come implementare i prodotti di misurazione di Google tramite la tua implementazione. Condividi una bozza di queste istruzioni compilando il modulo Revisione della documentazione sulla configurazione dell'integrazione di CMS per consentirci di fornire un feedback.