Integrazione Google Tag Manager
Aggiungi l'ID del container GTM a docs.json per caricare Google Tag Manager su ogni pagina. Gestisci analytics e tag di tracciamento da GTM.
Aggiungi l'ID del container GTM a docs.json per caricare Google Tag Manager su ogni pagina del tuo sito di documentazione. Da quel momento, il tuo team marketing potrà configurare analytics, pixel di conversione e tracciamento degli eventi interamente in GTM.
Gli ID dei container GTM iniziano con GTM-. Se ti serve solo Google Analytics, consulta Integrazione Google Analytics per una configurazione più semplice.
Quando usare GTM
Usa Google Tag Manager quando ti servono:
- Più strumenti di tracciamento - GA4, Facebook Pixel, LinkedIn e altri
- Controllo da parte del team marketing - Consenti ai marketer di aggiungere tag senza l'aiuto degli sviluppatori
- Trigger avanzati - Traccia i clic sui pulsanti, l'invio dei moduli e le visualizzazioni dei video
- Integrazione per i test A/B - Collega strumenti come Google Optimize
Per il solo analytics di base, aggiungere direttamente GA4 è più semplice.
Ottenere l'ID del container
- Vai a Google Tag Manager
- Seleziona il tuo account e il container, oppure creane di nuovi
- Copia l'ID del container nella parte superiore della pagina (inizia con
GTM-)
Aggiungere GTM alla documentazione
Aggiungi l'ID del container a docs.json:
{
"name": "My Docs",
"integrations": {
"gtm": {
"tagId": "GTM-XXXXXXX"
}
}
}Sostituisci GTM-XXXXXXX con l'ID effettivo del tuo container.
Consenso per i cookie
Se necessario, devi configurare autonomamente i banner per il consenso ai cookie. Jamdesk carica il tuo container GTM su ogni pagina, quindi tutti i tag configurati verranno attivati per ogni visitatore. Se i tuoi lettori sono soggetti al GDPR, al CCPA o a normative simili, configura la modalità di consenso in GTM oppure usa una piattaforma per la gestione del consenso. Jamdesk può anche bloccare GTM fino all'ottenimento del consenso. Consulta Consenso per i cookie.
Configurare GA4 tramite GTM
Se vuoi usare GA4 tramite GTM invece di aggiungerlo direttamente:
- In GTM, vai a Tags → New
- Scegli Google Analytics: GA4 Configuration
- Inserisci il tuo Measurement ID di GA4 (inizia con
G-) - Imposta il trigger su All Pages
- Publish il tuo container
Se configuri GA4 tramite GTM, non aggiungerlo anche direttamente in docs.json. Questo causa un tracciamento duplicato.
Verificare l'installazione
Usare la modalità anteprima di GTM
- In GTM, fai clic su Preview nell'angolo in alto a destra
- Inserisci l'URL del tuo sito di documentazione
- Una finestra di debug mostra quali tag vengono attivati su ogni pagina
Usare gli strumenti per sviluppatori del browser
- Apri il sito con gli strumenti per sviluppatori (F12)
- Vai alla scheda Network
- Filtra per
gtm.jsogoogletagmanager - Dovresti vedere le richieste effettuate
Tag GTM comuni per la documentazione
Tracciare i link in uscita
Crea un tag per tracciare quando gli utenti fanno clic sui link esterni:
- Tag: Google Analytics: GA4 Event
- Event Name:
click - Trigger: Click - Just Links, dove Click URL non contiene il tuo dominio
Tracciare l'utilizzo della ricerca
Traccia quando gli utenti interagiscono con la funzionalità di ricerca:
- Tag: Google Analytics: GA4 Event
- Event Name:
search - Trigger: Evento personalizzato corrispondente all'interazione con la ricerca
Tracciare il tempo trascorso sulla pagina
Comprendi quanto tempo gli utenti trascorrono nella lettura:
- Tag: Google Analytics: GA4 Event
- Event Name:
timing - Trigger: Trigger timer (ad esempio, ogni 30 secondi)
Risoluzione dei problemi
- Controlla l'ID del container - Deve iniziare con
GTM- - Pubblica il container - Le modifiche non pubblicate non appariranno sul sito
- Usa la modalità Preview - L'anteprima di GTM mostra quali tag vengono attivati su ogni pagina
Se hai configurato GA4 in entrambi i modi:
- Direttamente in
docs.json(integrations.ga4) - Tramite GTM come tag GA4
Otterrai visualizzazioni di pagina duplicate. Rimuovi una delle due configurazioni.
