Como criar data layer para o server-side Google Tag Manager
2 jun 2026
O container server-side GTM não possui um dataLayer tradicional como o GTM web. Em vez disso, ele recebe dados via objetos Client que transformam requisições HTTP em event data. Entender como estruturar essa comunicação é fundamental para implementações robustas.
Como o sGTM recebe dados
O Client é o componente que recebe requisições HTTP de entrada e as converte em event data utilizável pelas tags. Ele:
- Revisa os paths da requisição para identificar requisições relevantes.
- Transforma a requisição em event data estruturado.
- Gerencia requisições HTTP de saída após as tags dispararem.
O sGTM não tem dataLayer — mas há alternativas
Diferente do GTM web, o sGTM não tem uma estrutura de dataLayer nativa. A abordagem híbrida combina rastreamento web e server:
- Algumas tags permanecem client-side (por limitações de plataforma ou requisitos de ferramentas como HotJar).
- Outras tags rodam server-side para maior precisão e controle.
- Uma tag/client designada transfere dados do browser para o sGTM.
Método 1: Via Google Analytics 4
Recomendado quando você precisa integrar com Google Ads ou Floodlight.
- No GTM web, configure User Properties e Event Parameters na tag GA4.
- Mapeie cada parâmetro manualmente usando variáveis de dataLayer.
- Garanta que dados de e-commerce usem o formato GA4 (não Universal Analytics).
- Configure o transport URL da tag GA4 para apontar ao sGTM.
Mapeamento manual requer atenção — cada parâmetro que você quer no sGTM precisa ser explicitamente adicionado à tag GA4.
Método 2: Via Data Tag / Data Client
Mais simples e abrangente — transfere automaticamente o dataLayer e dados comuns.
- No GTM web, adicione a Data Tag da galeria de templates.
- Habilite as opções 'Send common data' e 'Send all from DataLayer'.
- No sGTM, importe e configure o Data Client do GitHub.
- Dados do dataLayer ficam acessíveis no sGTM via variáveis de event data — sem configuração manual de parâmetros.
O Data Tag/Client também transfere dados de e-commerce automaticamente, acessíveis via variáveis de event data no sGTM.
Qual método escolher?
GA4: Quando você precisa integrar especificamente com o ecossistema Google (Google Ads, Floodlight) e prefere controle granular sobre quais parâmetros são enviados.
Data Tag/Client: Quando você quer máxima facilidade, cobertura completa do dataLayer e não precisa filtrar parâmetros manualmente.
Posso usar ambos os métodos simultaneamente?
Sim, mas não é recomendado para os mesmos eventos — pode causar duplicação. Use GA4 para eventos de analytics e Data Tag para eventos que precisam de parâmetros adicionais de CRM ou e-commerce.
O sGTM consegue ler cookies e localStorage do browser?
Não diretamente. O sGTM só recebe o que é enviado via requisição HTTP. Para dados de cookies e localStorage, envie-os via parâmetros na tag GA4 ou Data Tag.
Análise de Dados
Dashboards e relatórios que transformam números em decisões — da coleta à interpretação.
Saiba mais