Integrazione Google Tag Manager

Aggiungi l'ID del tuo contenitore GTM a docs.json per caricare Google Tag Manager su ogni pagina del tuo sito di documentazione. Il tuo team marketing potrà poi configurare analisi, pixel di conversione e tracciamento degli eventi in GTM.

Quando usare GTM

Usa Google Tag Manager quando ti servono:

• Più strumenti di tracciamento: GA4, Facebook Pixel, LinkedIn, ecc.
• Controllo da parte del team marketing: i marketer aggiungono tag senza l'aiuto degli sviluppatori
• Trigger avanzati: tracciare clic sui pulsanti, invii di moduli, visualizzazioni di video
• Integrazione di test A/B: collegare strumenti come Google Optimize

Per la sola analisi di base, aggiungere direttamente GA4 è più semplice.

Ottenere l'ID del container

1. Vai su Google Tag Manager
2. Seleziona il tuo account e il contenitore (oppure creane di nuovi)
3. Copia l'ID contenitore dalla parte superiore della pagina (inizia con GTM-)

Aggiungere GTM alla documentazione

Aggiungi l'ID del contenitore al tuo docs.json:

{
  "name": "My Docs",
  "integrations": {
    "gtm": {
      "tagId": "GTM-XXXXXXX"
    }
  }
}

Sostituisci GTM-XXXXXXX con il tuo ID contenitore.

Consenso per i cookie

Configura tu stesso i banner per il consenso ai cookie se ti servono. Jamdesk carica il tuo contenitore GTM su ogni pagina. Ogni tag che configuri si attiva per ogni visitatore. Se si applicano GDPR, CCPA o normative simili ai tuoi lettori, configura la modalità di consenso in GTM oppure usa una piattaforma di gestione del consenso. Jamdesk può anche subordinare il caricamento di GTM stesso al consenso. Consulta Consenso ai cookie.

Configurare GA4 tramite GTM

Carica GA4 tramite GTM invece di aggiungerlo direttamente:

1. In GTM, vai su Tag → Nuovo
2. Scegli Google Analytics: configurazione GA4
3. Inserisci il tuo ID di misurazione GA4 (inizia con G-)
4. Imposta il trigger su Tutte le pagine
5. Pubblica il tuo contenitore

Verificare l'installazione

Usare la modalità anteprima di GTM

1. In GTM, clicca su Anteprima in alto a destra
2. Inserisci l'URL del tuo sito di documentazione
3. Una finestra di debug mostra quali tag si attivano su ogni pagina

Usare gli strumenti per sviluppatori del browser

1. Apri il tuo sito con gli Strumenti per sviluppatori (F12)
2. Vai alla scheda Rete
3. Filtra per gtm.js o googletagmanager
4. Verifica che le richieste compaiano

Tag GTM comuni per la documentazione

Tracciare i link in uscita

Traccia i clic sui link esterni con questo tag:

1. Tag: Google Analytics: evento GA4
2. Nome evento: click
3. Trigger: Clic - Solo link, dove l'URL del clic non contiene il tuo dominio

Tracciare l'utilizzo della ricerca

Traccia l'uso della ricerca:

1. Tag: Google Analytics: evento GA4
2. Nome evento: search
3. Trigger: Evento personalizzato corrispondente alla tua interazione di ricerca

Tracciare il tempo trascorso sulla pagina

Misura quanto a lungo i lettori restano su una pagina:

1. Tag: Google Analytics: evento GA4
2. Nome evento: timing
3. Trigger: Trigger timer (ad esempio ogni 30 secondi)

Risoluzione dei problemi

Articoli correlati