Como acessar o IP real do usuário ao usar CDN própria no sGTM

30 jan 2026

Ao usar uma CDN própria com rastreamento server-side, o sGTM pode receber o IP do servidor do CDN — não o IP real do visitante. Isso gera dados geográficos incorretos no GA4 e em outros destinos.

O problema

Imagine um usuário com IP 193.193.212.69 acessando seu site via subdomínio proxiado pelo Cloudflare. O sGTM recebe o IP do Cloudflare nos dados de evento comuns — não o IP original do visitante. Resultado: localização geográfica incorreta em todos os relatórios.

A solução: request headers

Os headers HTTP preservam o IP original do usuário. Para CDNs Cloudflare, o IP real está disponível no header Cf-Connecting-Ip, que pode ser acessado via uma variável nativa de Request Header no sGTM.

Passo a passo da implementação

1. No sGTM, crie uma variável do tipo Request Header.
2. Configure para capturar o valor do header Cf-Connecting-Ip.
3. Acesse a seção Transformations no container sGTM.
4. Crie uma nova transformação do tipo Augment Event.
5. Substitua o parâmetro ip_override pelo valor da variável de header criada.
6. Salve a transformação — ela será aplicada a todas as tags do sGTM.

Resultado esperado

Após a implementação, todas as tags do container sGTM passarão a usar o IP real do usuário. Os dados geográficos no GA4 e demais plataformas voltarão a ser precisos.