Integrazione Google Analytics
Aggiungi Google Analytics 4 al tuo sito di documentazione con un ID di misurazione per monitorare i visitatori e vedere quali contenuti leggono.
Aggiungi Google Analytics 4 al tuo sito di documentazione per capire come i lettori usano i tuoi contenuti.
L'integrazione accetta ID di misurazione GA4 (Google Analytics 4) che iniziano con G-.
Ottenere il tuo ID di misurazione
- Vai su Google Analytics
- Seleziona la tua proprietà (oppure creane una)
- Vai su Admin → Data Streams
- Seleziona il tuo flusso web (oppure creane uno)
- Copia il Measurement ID (inizia con
G-)
Aggiungere GA4 alla documentazione
Aggiungi l'ID di misurazione al tuo docs.json:
{
"name": "My Docs",
"integrations": {
"ga4": {
"measurementId": "G-XXXXXXXXXX"
}
}
}Sostituisci G-XXXXXXXXXX con il tuo ID di misurazione.
Visualizzare i dati
Verifica che i dati arrivino:
- Avvia una nuova build della tua documentazione
- Visita il tuo sito di documentazione pubblicato
- In Google Analytics, vai su Reports → Real-time
- La tua visita compare entro 30 secondi
I dati possono impiegare 24-48 ore per comparire nei report standard. Usa i report Real-time per una verifica immediata.
Utilizzare Google Tag Manager
Se usi già Google Tag Manager, configura GA4 tramite GTM invece di aggiungerlo direttamente. Consulta Integrazione Google Tag Manager per i dettagli.
Configura tu stesso i banner di consenso ai cookie per tutti i tag che carichi tramite Google Tag Manager. Jamdesk carica il tuo container GTM per tutti i visitatori senza un vincolo di consenso. Consulta Consenso ai cookie per bloccare l'analisi finché i visitatori non acconsentono.
Non aggiungere la stessa proprietà GA4 sia direttamente in docs.json sia tramite Google Tag Manager. Questo causa un tracciamento duplicato.
Considerazioni sulla privacy
Google Analytics raccoglie dati dei visitatori. Valuta:
- Aggiungere un banner di consenso ai cookie se si applicano GDPR/CCPA. Jamdesk carica GA4 per ogni visitatore per impostazione predefinita. Consenso ai cookie lo blocca finché non acconsentono.
- Aggiornare la tua informativa sulla privacy per menzionare l'analisi
- Usare l'anonimizzazione dell'IP se necessario
Risoluzione dei problemi
- Verifica il tuo ID di misurazione: deve iniziare con
G- - Controlla gli ad blocker: potrebbero bloccare gli script di analisi
- Attendi la nuova build: le modifiche richiedono una nuova build per avere effetto
- Usa i report Real-time: i report standard hanno un ritardo di 24-48 ore
L'ID deve:
- Iniziare con
G- - Contenere solo lettere e numeri dopo
G- - Essere copiato esattamente da Google Analytics (senza spazi extra)