Integrazione Google Analytics
Aggiungi Google Analytics 4 al tuo sito di documentazione usando un ID di misurazione per monitorare i visitatori e comprendere il coinvolgimento nei contenuti.
Aggiungi Google Analytics 4 al tuo sito di documentazione per comprendere come gli utenti interagiscono con i tuoi contenuti.
L'integrazione di Google Analytics funziona con gli ID di misurazione GA4 (Google Analytics 4) che iniziano con G-.
Ottenere il tuo ID di misurazione
- Vai a Google Analytics
- Seleziona la tua proprietà (oppure creane una)
- Vai a 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 effettivo.
Visualizzare i dati
Dopo aver aggiunto l'integrazione:
- Avvia una nuova build della documentazione
- Visita il sito di documentazione pubblicato
- In Google Analytics, vai a Reports → Real-time
- Dovresti vedere la tua visita entro 30 secondi
La visualizzazione dei dati nei report standard può richiedere 24-48 ore. Usa i report Real-time per una verifica immediata.
Utilizzare Google Tag Manager
Se utilizzi già Google Tag Manager, puoi configurare GA4 tramite GTM invece di aggiungerlo direttamente. Consulta Integrazione Google Tag Manager per maggiori dettagli.
Se necessario, devi configurare i banner per il consenso ai cookie per tutti i tag caricati tramite Google Tag Manager. Jamdesk carica il tuo container GTM per tutti i visitatori senza un controllo del consenso. Consulta Consenso ai cookie per bloccare l'analytics finché i visitatori non prestano il consenso.
Non aggiungere la stessa proprietà GA4 direttamente in docs.json e tramite Google Tag Manager, perché ciò causerebbe un monitoraggio duplicato.
Considerazioni sulla privacy
Google Analytics raccoglie i dati dei visitatori. Valuta di:
- Aggiungere un banner per il consenso ai cookie se si applica il GDPR/CCPA. Per impostazione predefinita, Jamdesk carica GA4 per ogni visitatore: usa quindi Consenso ai cookie per bloccarlo finché non presta il consenso.
- Aggiornare la tua informativa sulla privacy per menzionare l'analytics
- Usare l'anonimizzazione IP se necessario
Risoluzione dei problemi
- Verifica il tuo ID di misurazione - Deve iniziare con
G- - Controlla i blocchi pubblicità - Potrebbero bloccare gli script di analytics
- Attendi la nuova build - Le modifiche richiedono una nuova build per diventare effettive
- 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 aggiuntivi)