sGTM Preview Config

idioma: pt-BR | data: 2026-09-15 | status: atualiza a página já publicada em cms.wascer.com/docs/sgtm-preview-config/, foco nos “Novidades” (filtros + expiração garantida de 60 min)

sGTM Preview Config

Debugue seu container Server-Side em produção usando só o seu próprio tráfego, sem espelhar o site inteiro e sem risco de esquecer o preview ligado.

Visão Geral

O modo Preview do Google Tag Manager Server-Side deixa você inspecionar, em tempo real, todas as requisições que chegam no seu container: não só as que vêm do navegador, mas também webhooks, chamadas de API de backend e eventos de SDK mobile. O sGTM Preview Config da Wascer injeta o header que liga esse espelhamento, com dois cuidados que a versão anterior não tinha: um filtro de tráfego (pra não espelhar a produção inteira) e uma expiração garantida.

Benefícios

• Visualiza requisições de qualquer origem (web, app, webhook, API) no debugger do sGTM.
• Depuração em tempo real, sem esperar deploy.
• Filtro por path e/ou por IP: só o tráfego que você escolher entra no preview, o resto do site continua sem ser espelhado.
• Desliga sozinho em 60 minutos, sempre, inclusive quando é ligado pelo suporte da Wascer. Antes desta versão, já aconteceu de um preview ficar ligado por cerca de cinco meses sem ninguém perceber.

Como Funciona

1. Você gera um token de preview dentro do próprio modo Debug/Preview do seu container Server-Side no Google Tag Manager.
2. Cola esse token no painel Wascer. A partir daí, toda requisição que casar com o filtro configurado (ou toda requisição, se nenhum filtro for definido) ganha o header X-Gtm-Server-Preview antes de chegar no seu container, e passa a aparecer no debugger do GTM em tempo real, enquanto o evento de produção continua sendo processado normalmente.
3. Sem nenhum filtro preenchido, todo o tráfego é espelhado para o preview: é o comportamento padrão, indicado só para debug rápido.

Filtros, como combinam. Path e IP funcionam de forma independente: preencher os dois não restringe mais, abre mais uma porta para o preview. Por exemplo, com um filtro de path /meu-webhook e um filtro de IP 203.0.113.10 preenchidos ao mesmo tempo:

Requisição	Casa o path?	Casa o IP?	Entra no preview?
POST /meu-webhook, de qualquer IP	sim	não se aplica	sim
Qualquer rota, vinda de 203.0.113.10	não se aplica	sim	sim
Qualquer outra combinação	não	não	não

• Filtro por path: precisa começar com / e não pode ser só /. O path precisa existir como Client dentro do seu container sGTM. Se não existir, a requisição chega e retorna 404.
• Filtro por IP: um único endereço IPv4 ou IPv6. Faixas (CIDR) não são aceitas.

Como Ativar

• Acesse o painel Wascer → Containers → selecione o container → aba Boosters.
• Localize o card sGTM Preview Config.
• Ative o switch Habilitar Preview Header.
• No Google Tag Manager, abra o modo Preview do seu container Server-Side e copie o valor do header X-Gtm-Server-Preview que ele exibe.

Copie o valor do header X-Gtm-Server-Preview exibido no modal:

• Cole esse valor no campo Cabeçalho HTTP X-Gtm-Server-Preview do painel Wascer.
• (Opcional) Preencha Filtrar por path e/ou Filtrar por IP para restringir o espelhamento só ao seu tráfego de teste.
• Salve. O aviso na tela lembra: o preview se desliga sozinho depois de 60 minutos. Para continuar depois disso, repita o processo.

Card “sGTM Preview Config” na aba Boosters, desligado. Clique no switch indicado para ativar. O aviso dos 60 minutos já aparece mesmo desligado.

Card expandido: campo do token preenchido, filtros por path e por IP, e o botão “Salvar alterações” indicado.

Debugger do GTM Server-Side (modo Preview) mostrando uma requisição real capturada: Cliente “GA4 (Web) – Solicitação reivindicada”, requisição de entrada `GET /g/collect?…` com status 200 destacada.

[SCREENSHOT PENDENTE: menu de três pontinhos do Preview Mode mostrando onde copiar o header X-Gtm-Server-Preview antes de colar no painel Wascer]

Contra-prova: o preview realmente espelhando o tráfego

Na mesma requisição capturada acima, o header X-Gtm-Server-Preview chega com o token configurado no painel Wascer, prova de que o espelhamento está funcionando ponta a ponta:

`X-Gtm-Server-Preview` com o token real, destacado entre os demais headers da requisição.

Casos de Uso

• Validar que um payload de webhook de e-commerce chega com todos os campos esperados antes de ativar tags que dependem dele (ex.: Conversions API).
• Debugar eventos de compra (in_app_purchase) vindos de um SDK mobile, conferindo a estrutura exata que chega ao container.

Disponibilidade

Disponível em todos os planos.