Integração do Google Analytics
Adicione o Google Analytics 4 ao seu site de documentação com um ID de medição para acompanhar visitantes e ver quais conteúdos eles leem.
Adicione o Google Analytics 4 ao seu site de documentação para ver como os leitores usam seu conteúdo.
A integração aceita IDs de medição do GA4 (Google Analytics 4) que começam com G-.
Obtendo seu ID de medição
- Acesse o Google Analytics
- Selecione sua propriedade (ou crie uma)
- Acesse Admin → Fluxos de dados
- Selecione seu fluxo da Web (ou crie um)
- Copie o ID de medição (começa com
G-)
Adicionando o GA4 à documentação
Adicione o ID de medição ao seu docs.json:
{
"name": "My Docs",
"integrations": {
"ga4": {
"measurementId": "G-XXXXXXXXXX"
}
}
}Substitua G-XXXXXXXXXX pelo seu ID de medição.
Visualizando seus dados
Verifique se os dados estão chegando:
- Dispare um novo build da sua documentação
- Acesse seu site de documentação publicado
- No Google Analytics, acesse Relatórios → Tempo real
- Sua visita aparece em até 30 segundos
Pode levar de 24 a 48 horas para os dados aparecerem nos relatórios padrão. Use os relatórios em tempo real para verificação imediata.
Usando com o Google Tag Manager
Se você já usa o Google Tag Manager, configure o GA4 pelo GTM em vez de adicioná-lo diretamente. Consulte Integração com o Google Tag Manager para mais detalhes.
Configure você mesmo os banners de consentimento de cookies para quaisquer tags que você carregue pelo Google Tag Manager. A Jamdesk carrega seu contêiner do GTM para todos os visitantes sem uma barreira de consentimento. Consulte Consentimento de cookies para bloquear a análise até que os visitantes optem por ela.
Não adicione a mesma propriedade do GA4 diretamente no docs.json e também pelo Google Tag Manager. Isso causa rastreamento duplicado.
Considerações sobre privacidade
O Google Analytics coleta dados dos visitantes. Considere:
- Adicionar um banner de consentimento de cookies se a GDPR/CCPA for aplicável. Por padrão, a Jamdesk carrega o GA4 para todos os visitantes. O Consentimento de cookies o bloqueia até que eles optem por ele.
- Atualizar sua política de privacidade para mencionar a análise de dados
- Usar a anonimização de IP, se necessário
Solução de problemas
- Verifique seu ID de medição: ele deve começar com
G- - Verifique bloqueadores de anúncios: eles podem bloquear os scripts de análise
- Aguarde o novo build: as alterações exigem um novo build para ter efeito
- Use os relatórios em tempo real: os relatórios padrão têm atraso de 24 a 48 horas
O ID deve:
- Começar com
G- - Conter apenas letras e números depois de
G- - Ser copiado exatamente do Google Analytics (sem espaços extras)
