Integração com Google Analytics
Adicione o Google Analytics 4 ao seu site de documentação usando um ID de medição para acompanhar visitantes e entender o envolvimento com o conteúdo.
Adicione o Google Analytics 4 ao seu site de documentação para entender como os usuários interagem com seu conteúdo.
A integração com o Google Analytics funciona com 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 → Data Streams
- Selecione seu fluxo da Web (ou crie um)
- Copie o Measurement ID (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 real.
Visualizando seus dados
Depois de adicionar a integração:
- Inicie um novo build da sua documentação
- Acesse seu site de documentação publicado
- No Google Analytics, acesse Reports → Real-time
- Sua visita deverá aparecer 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 uma verificação imediata.
Usando com o Google Tag Manager
Se você já usa o Google Tag Manager, pode configurar o GA4 pelo GTM em vez de adicioná-lo diretamente. Consulte Integração com o Google Tag Manager para obter mais detalhes.
Você é responsável por configurar banners de consentimento de cookies para quaisquer tags carregadas pelo Google Tag Manager, se necessário. O Jamdesk carrega seu contêiner do GTM para todos os visitantes sem uma etapa de consentimento. Consulte Consentimento de cookies para bloquear as análises até que os visitantes optem por aceitá-las.
Não adicione a mesma propriedade do GA4 diretamente no docs.json e também pelo Google Tag Manager, pois isso causará rastreamento duplicado.
Considerações sobre privacidade
O Google Analytics coleta dados dos visitantes. Considere:
- Adicionar um banner de consentimento de cookies se o GDPR/CCPA se aplicar. O Jamdesk carrega o GA4 para todos os visitantes por padrão; use Consentimento de cookies para bloqueá-lo até que eles optem por aceitá-lo.
- Atualizar sua política de privacidade para mencionar as análises
- Usar anonimização de IP, se necessário
Solução de problemas
- Verifique seu ID de medição - Ele deve começar com
G- - Verifique os bloqueadores de anúncios - Eles podem bloquear os scripts de análise
- Aguarde o build - As alterações exigem um novo build para entrar em vigor
- Use os relatórios em tempo real - Os relatórios padrão têm um 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)
