Integração com Google Analytics
As análises web são opcionais e mínimas: forneça um ID do Google Analytics ou Tag Manager em Settings → Integrations, e cada página construída recebe o script Google correspondente, nada mais, e absolutamente nada até que o seu visitante tenha interagido com a página. Não há análises por página, não há dados fluindo para o CMS e (no modo air-gap) nenhuma chamada externa.
Quais IDs definir
Dois campos, coordenados:
- GA4 measurement ID (
G-XXXXXXXXXX): a rota direta do Google Analytics 4; o gtag.js padrão é adicionado a cada página. - GTM container ID (
GTM-XXXXXXX): em vez disso, encaminha o site pelo Google Tag Manager, onde as tags que você gerencia vivem no contêiner.
Eles funcionam na mesma página, mas os dois não carregam: o GTM vence quando ambos estão preenchidos (o loader do gtag do GA4 é intencionalmente ignorado para que o rastreamento não seja duplicado por dois caminhos). Escolha um: o ID do GA4 se você rastreia diretamente no Google Analytics, ou o GTM se o contêiner é onde vive o seu rastreamento.
Como o script chega à página
Cada build injeta o snippet loader uma vez em cada página construída, e o próprio loader é deliberadamente educado:
- Ele dispara somente depois que o visitante interage: clique, rolagem, keydown ou o primeiro toque.
- Se o cookie notice do seu site estiver ativo, as análises só rodam depois que o visitante aceitar o cookie: o cookie é usado diretamente, e recusas (
cookie_consent=0) são honradas pelo loader mesmo sem ferramentas adicionais. - GA4/GTM configurados: exatamente um dos dois carrega: só o GA4 carrega o gtag.js; o GTM carrega o loader GTM padrão (controle total do contêiner), com isso garantindo que o site não baixe o rastreamento em dobro.
As tags aparecem em tempo de build nas páginas geradas, então o efeito é instantâneo a cada reconstrução de página e nenhuma configuração dinâmica é necessária.
Modo air-gap
Ativar o modo air-gap do ambiente desliga o painel inteiro:
- Os dois campos ficam somente leitura e um aviso em linha diz isso: "External analytics scripts (GA4, GTM) are disabled and will not be emitted in builds."
- O próprio build remove os IDs, de modo que um valor desatualizado não possa fazer o site ligar para o Google; a limpeza de snippets, igualmente verificada, mantém também URLs de fora do site fora das páginas emitidas.
- Habilitar o air-gap depois desarma automaticamente esses IDs; os valores permanecem nas configurações para mais tarde.
Campo relacionado na mesma aba
- X / Twitter handle (com o
@): não é análise; constrói a meta tagtwitter:siteem cada página construída para cards de link melhores. Mesmo painel Integrations, sistema diferente, listado por completude.
Notas práticas
- Deixe os campos em branco para não ter análises de forma alguma: o CMS serve páginas limpas, sem scripts, que é o comportamento padrão do projeto.
- Como estes são campos de texto sem validação no lado do cliente, uma colagem que perca um caractere (por exemplo, esquecer o prefixo
G-) resulta em um script não usado em vez de um erro; confira o código-fonte de uma página construída para confirmar que o measurement ID aparece corretamente. - Se você usa o GTM, lembre-se de que as tags GA4 que você cria dentro do contêiner são gerenciadas no provedor; deixe
ga4_idem branco no Chinaski para evitar um segundo caminho em dobro. - Rastreadores personalizados além de GA4/GTM (Piwik, Plausible, pixel da Meta…) pertencem ao sistema Snippets, o mecanismo padrão de injeção em head/body, com o mesmo carregamento consciente de consentimento e (no modo air-gap) as mesmas regras de remoção de URLs externas.
A versão curta
Cole um identificador GA4 ou GTM em Settings → Integrations e o loader Google correspondente é embutido em cada build, consciente de consentimento se o seu banner de cookies estiver ligado, somente após uma primeira interação, duplamente protegido no modo air-gap, e nada disso passa pelo seu servidor.