Il tag Google è uno snippet di codice che può essere aggiunto a un sito web per misurare l'attività utente su una varietà di prodotti Google, tra cui Google Analytics, 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 strumento per la creazione di siti web per fornire agli utenti finali l'accesso ai prodotti di misurazione di Google.
Pubblico
Questa guida è destinata ai proprietari di sistemi di gestione dei contenuti (CMS) o di strumenti per la creazione di siti web che vogliono fornire ai propri utenti un'integrazione con i prodotti di misurazione di Google. Questa guida non è destinata agli utenti di un CMS o di uno strumento per la creazione di siti web.
Prima di iniziare
Assicurati di avere un ID sviluppatore del tag Google. Se non hai un ID sviluppatore del tag Google, compila il modulo di richiesta dell'ID sviluppatore del tag Google. L'ID sviluppatore è diverso da 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:
- Crea un'integrazione con il tag Google
- Aggiorna la struttura dell'input dell'utente
- Implementa l'API per il consenso
- Configura i dati degli eventi
- Verifica l'integrazione aggiornata
- Aggiorna le istruzioni di deployment per gli utenti
Crea un'integrazione con il tag Google
Creando un'integrazione con il tag Google, i tuoi clienti possono eseguire il deployment dei prodotti di misurazione di Google (tramite gtag.js) su ogni pagina del loro sito. Prima di creare un'integrazione con gtag.js, assicurati di rimuovere tutte le integrazioni di tag legacy esistenti (ad esempio analytics.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('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
gtag('js', new Date());
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
allow_ad_personalization_signalsparametro (vedi Disattivare la raccolta di dati pubblicitari personalizzati. - Idealmente, lo snippet del tag Google dovrebbe essere visualizzato una sola volta per pagina. Lo snippet può ospitare 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 dell'utente
I tuoi clienti devono essere in grado di fornire più forme del loro ID tag Google tramite un'unica interfaccia, indipendentemente dal prodotto di misurazione di Google di cui stanno eseguendo il deployment.
Ad esempio, di seguito è riportato un semplice input del tag Google. L'integrazione deve essere presentata come un deployment per il tag Google. Può essere sottotitolata come metodo per eseguire il deployment di Google Ads e Google Analytics.
In alternativa, il seguente diagramma mostra come una piattaforma potrebbe avere flussi utente separati per Analytics e Ads, ma ogni flusso porta a un'interfaccia in cui gli utenti forniscono il proprio ID tag Google.
L'input dell'ID tag deve accettare più varianti di ID utilizzando il pattern dell'espressione regolare [A-Z]{1,3}\\w{5,}[\w]*.
Implementa l'API per il consenso (nota anche come modalità di consenso)
Il tag Google ha un'API per il consenso integrata per gestire il consenso dell'utente. È in grado di distinguere il consenso dell'utente per i cookie a fini pubblicitari da quelli a fini di analisi.
Il risultato previsto è che i clienti ricevano almeno la
gtag('consent', 'update' {...}) chiamata integrata senza che sia richiesta alcuna azione da parte del
cliente. In questo modo, i tag Google (Google Ads, Floodlight, Google
Analytics, Linker conversioni) saranno in grado di leggere lo stato del consenso dell'utente più recente e
includerlo nelle richieste di rete a Google (tramite il parametro &gcs).
I passaggi di implementazione aggiuntivi consistono nell'eseguire il deployment o nell'aiutare gli inserzionisti a eseguire il deployment (ad es. tramite un'interfaccia utente) dello stato gtag('consent', default' {...}) e nello sbloccare i tag Google (ovvero senza attivazione condizionale basata sul consenso) per consentire alla modalità di consenso di attivarli in modo sensibile al consenso.
Per i dettagli sull'implementazione, vedi Gestire le impostazioni del consenso (web).
Configura i dati degli eventi
Devi inviare dati degli eventi avanzati 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 un funnel di acquisto (ad es. add_to_cart, begin_checkout, add_payment_info, add_shipping_info e purchase), la generazione di lead e le registrazioni.
Di seguito sono riportate le best practice per l'aggiunta di eventi:
- Registra tutto il possibile
- Configura almeno 8 eventi principali
- Dai la priorità agli eventi di e-commerce
Registra tutto il possibile
Se possibile, devi configurare gli eventi per impostazione predefinita. È incluso quanto segue:
- Eventi chiave, come
purchaseosign_up - Eventi precedenti agli eventi chiave, come
add_to_cart - Coinvolgimenti comportamentali, come le interazioni con i contenuti multimediali, che aiutano i clienti a capire come coinvolgono gli utenti finali
Devi aggiungere snippet di eventi chiave solo alle pagine degli eventi chiave (ad es. conferma dell'acquisto, conferma dell'invio del modulo). Tieni presente che devi comunque aggiungere il tag Google a ogni pagina del sito.
Gli eventi vengono inviati utilizzando il event comando.
È incluso lo stesso ID sviluppatore del tag Google che hai incluso nel tag del sito globale 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. Collega l'ID a ogni evento. - I seguenti parametri sono facoltativi e possono essere omessi:
'value'è il valore numerico dell'evento chiave (ad es. il prezzo di un acquisto)'currency'è un codice di valuta di tre lettere, utile per gli inserzionisti che accettano più valute'transaction_id'è un ID univoco per la transazione (ad es. un ID ordine); viene utilizzato per la deduplicazione.
- Sebbene alcuni parametri siano facoltativi, ti consigliamo di includere il maggior numero possibile di informazioni 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 e consentono agli utenti di comprendere meglio i propri clienti.
Se vuoi misurare un evento chiave in base a un clic (ad es. un clic su un pulsante o una risposta dinamica per un sito che utilizza AJAX), puoi anche utilizzare 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 configurare un insieme di eventi principali che abbiano il massimo valore per i proprietari del sito. Ti consigliamo di configurare almeno 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ù utilizzati (ad es. Account Google, 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 abbona 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, ti consigliamo di acquisire quanto segue:
- Qualsiasi evento di successo direttamente associato al valore
- Eventi di successo che contribuiscono agli eventi chiave principali (add_to_cart, sign_up e così via)
- Coinvolgimenti e interazioni degli utenti che aiutano gli inserzionisti a capire come coinvolgono gli utenti finali
Di seguito sono riportate altre risorse che spiegano ulteriormente la raccolta di eventi:
- Eventi
- Eventi consigliati per caso d'uso
- Misurare l'e-commerce per le proprietà Google Analytics
Siamo interessati a discutere di potenziali estensioni di questo schema, quindi non esitare a comunicarci i tuoi 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
- Il tag Google per il remarketing e la misurazione delle conversioni
Inoltre, verifica che il tag venga attivato correttamente su tutte le pagine, incluse le pagine degli eventi chiave, utilizzando uno di questi strumenti:
- Google Tag Assistant: Tag Assistant ti consente di vedere quali tag Google sono stati attivati e in quale ordine. La modalità di debug di Tag Assistant mostra i dati trasmessi al livello dati e gli eventi che hanno attivato questi scambi di dati.
- Strumenti per sviluppatori di Chrome: utilizza la scheda Rete per filtrare le richieste che contengono "google" per verificare come 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 i hit dei tag vengono ricevuti dai server di Google.
Per segnalare un bug o fornire feedback sulle informazioni mancanti, compila il modulo di assistenza per il sistema di gestione dei contenuti.
Se possibile, condividi l'accesso di test con Google per la verifica continua.
Aggiorna le istruzioni di deployment per gli utenti
Aggiorna la documentazione per fornire istruzioni chiare su come implementare i prodotti di misurazione di Google utilizzando la tua implementazione. Condividi una bozza di queste istruzioni compilando il modulo di revisione della documentazione di configurazione dell'integrazione CMS in modo che possiamo fornire un feedback.