Feito com Chinaski

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:

  1. Ele dispara somente depois que o visitante interage: clique, rolagem, keydown ou o primeiro toque.
  2. 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.
  3. 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 tag twitter:site em 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_id em 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.

Leia este site em