Se você já trabalha com GTM Server Side mas ainda tem dúvidas sobre como funciona o modo de visualização, o que são as requisições de entrada e saída, e como interpretar os dados que chegam no Debug, este artigo vai destrinchar tudo isso de forma clara e prática.
Pré-requisito: instalar a extensão do Stape
Antes de qualquer coisa, recomenda-se instalar a extensão do Stape no navegador. Ela transforma a experiência de Debug do GTM Server Side, exibindo as variáveis e os parâmetros de forma muito mais visual e fácil de ler. Além disso, oferece funcionalidades extras para análise de tags e requisições.
Após instalar, fixe a extensão na barra de ferramentas do navegador para ter acesso rápido sempre que precisar.
Como funciona o Debug do GTM Server Side
O Debug do GTM Server Side opera de forma diferente do Debug do GTM Web tradicional. Entender essa diferença é fundamental para interpretar corretamente o que aparece na tela.
GTM Web e GTM Server Side trabalham juntos
Na maioria das implementações, o Debug dos dois containers precisa estar aberto ao mesmo tempo. O GTM Web é responsável por capturar os eventos no navegador do usuário e enviá-los para o servidor. O GTM Server Side recebe essas informações e as distribui para as plataformas de destino.
A única exceção é quando a implementação usa exclusivamente webhooks diretos para o GTM Server Side, sem passar pelo GTM Web.
Testando webhooks: o Debug do Stape
Para quem precisa testar webhooks dentro do GTM Server Side, existe uma configuração adicional necessária. Dentro do painel do Stape, acesse Power-Ups → sGTM Preview Header Config e ative essa opção. Ela permite que os eventos de webhook cheguem corretamente no modo de visualização para validação.
Abrindo o Debug do GTM Server Side
Para iniciar o Debug, acesse o container Server Side e clique em Visualizar. No campo de URL, insira o endereço do site que será testado.
Uma recomendação importante: sempre utilize uma URL personalizada para o seu container Server Side. Isso melhora tanto a performance quanto a privacidade da implementação.
Entendendo as requisições
O conceito central do GTM Server Side é a requisição. Tudo que acontece dentro do Debug gira em torno de requisições que chegam e saem do servidor.
Requisição de entrada (Incoming)
Quando uma tag do GTM Web é disparada e configurada para enviar dados ao servidor, ela gera uma requisição de entrada no GTM Server Side. Essa requisição chega carregando todos os dados que foram enviados: parâmetros do evento, cookies, dados da Google Tag (GTG) e informações do cabeçalho HTTP.
Com a extensão do Stape ativada, esses dados aparecem organizados de forma muito mais legível, separados por categorias e com destaque visual para facilitar a análise.
Verificando se os dados estão indo para o servidor
Uma checagem importante durante o Debug é confirmar que os dados estão sendo enviados para o GTM Server Side e não diretamente para o Google Analytics. Clicando em uma tag disparada no GTM Web, é possível verificar para qual URL os dados estão sendo enviados.
Se a URL de destino for do Google Analytics, há um problema na configuração. Os dados precisam ser enviados para a URL personalizada do servidor, e não diretamente para as plataformas.
O que fazer com os dados que chegam
Quando uma requisição chega ao GTM Server Side, ela traz consigo um conjunto completo de informações. A partir desse ponto, o trabalho dentro do servidor começa.
Variáveis
Com os dados disponíveis na requisição, é possível criar variáveis para acessar informações específicas. Existem três tipos principais de variável no Server Side:
- Variável de cabeçalho de solicitação: captura informações do cabeçalho HTTP, como o sistema operacional do usuário (X-Device-Os) ou a cidade e estado via GEO Headers do Stape
- Variável de dados do evento: acessa os parâmetros enviados junto com o evento, como valor da compra, ID de transação e email
- Variável de cookie: lê cookies armazenados no navegador do usuário, como fbclid e gclid
Tags
Com as variáveis configuradas, elas são utilizadas dentro das tags que enviam os dados para os destinos finais. Cada tag representa um envio de dados para uma plataforma específica, como Meta, Google Ads, GA4 ou qualquer outro endpoint.
Transformações
As transformações permitem modificar os dados de um evento antes que ele seja enviado para as plataformas de destino. É possível:
- Aumentar parâmetros: adicionar informações que não vieram do GTM Web, como cidade e estado capturados pelo IP via GEO Headers do Stape
- Remover parâmetros: excluir dados que não devem ser enviados para determinada plataforma
- Filtrar eventos: permitir apenas eventos específicos para cada destino
Requisições de saída (Outgoing)
Enquanto a requisição de entrada representa o que chegou ao servidor, as requisições de saída representam o que o servidor enviou para as plataformas de destino.
No Debug, cada evento pode gerar múltiplas requisições de saída: uma para o GA4, uma para o Meta, uma para o Google Ads, e assim por diante. Cada requisição de saída conta como uma unidade no consumo de requisições do plano do Stape.
Fontes de dados que chegam ao GTM Server Side
O GTM Server Side é flexível quanto às origens dos dados que recebe. As principais são:
GTM Web: a forma mais comum. O GTM Web captura eventos no navegador e os envia ao servidor via tag configurada com a URL do container Server Side.
Webhooks: dados enviados diretamente do backend da loja ou sistema, como eventos de pedido pago, chargeback ou assinatura renovada. Para receber webhooks, é necessário configurar um cliente no GTM Server Side com o path correspondente.
Backend e CRM: o Server Side também consegue receber e processar dados que vêm de sistemas internos, complementando as informações que chegam do navegador.
Como testar webhooks no Debug
Para validar se um webhook está chegando corretamente no GTM Server Side, siga os passos abaixo:
- Abra o Debug do GTM Server Side e clique nos três pontinhos no canto superior direito
- Copie o cabeçalho HTTP gerado
- Acesse o painel do Stape → Power-Ups → sGTM Preview Header Config
- Cole o código copiado no campo Preview Token
- Em By Path, informe o path do webhook que deseja monitorar
- Salve as configurações
A partir desse momento, todos os webhooks enviados para aquele path vão aparecer no Debug, permitindo validar os dados e confirmar se a configuração está funcionando corretamente.
Por que o GTM Server Side é tão importante
O objetivo central do GTM Server Side vai muito além de simplesmente replicar o que o GTM Web já faz. Ele existe para oferecer governança e gerenciamento de dados em um nível que o navegador nunca conseguiria proporcionar.
Com ele, é possível receber dados de múltiplas fontes, incluindo navegador, backend e CRM, processar e enriquecer esses dados no servidor e enviá-los com mais qualidade e precisão para as plataformas de destino.
Um dos usos mais valiosos dessa estrutura é o envio de webhooks de pedidos pagos diretamente para o Meta, Google Ads e GA4. Isso garante que as conversões registradas nas plataformas reflitam vendas reais, e não apenas intenções de compra, resultando em dados muito mais precisos para otimização de campanhas.
Conclusão
Entender o Debug do GTM Server Side é o primeiro passo para trabalhar com confiança em implementações server-side. Com a extensão do Stape instalada, a lógica de requisições de entrada e saída compreendida e as ferramentas de teste configuradas corretamente, o Debug deixa de ser um ambiente confuso e passa a ser uma fonte valiosa de informações para validar e aprimorar qualquer implementação.
Também siga o Mundo do Traqueamento em outras redes sociais:
Inscreva-se no https://www.youtube.com/channel/UC6mX6bbcEmQoaznI0D7Aw5Q
Siga e curta no https://www.instagram.com/mundodotraqueamento/
Siga e comente no https://twitter.com/traqueamento
Siga também no https://www.linkedin.com/company/mundo-do-traqueamento
