Troubleshooting de server-side tagging com logs do sGTM
13 abr 2026
Configurar server-side tagging envolve múltiplos clients, tags, variáveis e triggers. Os logs do sGTM são a ferramenta de diagnóstico essencial para identificar problemas antes que afetem seus dados de marketing.
O que são os Stape Logs?
São registros de todas as requisições processadas pelo container sGTM — tanto as recebidas quanto as enviadas às plataformas. Essenciais para verificar se eventos chegam, com quais parâmetros e se foram aceitos pelos destinos.
Acesso por plano:
- Pro/Pro+: Últimos 3 dias de histórico.
- Business e acima: Últimos 10 dias.
- Enterprise+: Exportação de logs disponível.
Dois tipos: requisições recebidas (ativo por padrão) e enviadas (requer ativação manual).
4 casos de uso práticos
1. Discrepâncias de compras
Filtre as requisições de saída e verifique se todos os eventos de compra têm código de status 200 (sucesso). Codes 4xx ou 5xx indicam rejeição pela plataforma de destino.
2. Problemas de atribuição do Meta
Verifique se a Conversions API do Meta está enviando os parâmetros fbc e fbp. Sem esses parâmetros, o Meta não consegue fazer o match do evento com o usuário correto.
3. Parâmetros de evento ausentes
Use a Logger Tag para identificar eventos com valores ausentes (ex: valor de compra zerado). O Logger registra o body completo do evento, facilitando a identificação.
4. Detalhes de requisições POST
Requisições POST não são logadas automaticamente. Habilite 'Log Request Body' na Logger Tag para inspecionar o payload completo de cada requisição.
Configurando a Logger Tag
- No container sGTM, acesse Tags → New.
- Pesquise 'Logger' de stape-io na Community Template Gallery.
- Selecione Logger como tipo de tag.
- Configure o destino do log: Console (para debug), Stape Store (para persistência) ou BigQuery (para análise em escala).
- Adicione o trigger adequado.
- Teste via sGTM Debugger.
BigQuery Logging
Para análise de logs em escala, configure logging direto no BigQuery em tags como Meta CAPI, TikTok Events API e Google Ads Offline Conversion Tag:
- Acesse as configurações da tag → BigQuery Logs Settings.
- Habilite 'Log to BigQuery'.
- Insira o Dataset ID e Table ID.
- Crie a tabela no BigQuery com o schema fornecido pela Stape (15 campos incluindo timestamp, trace_id, tag_name e códigos de status).
O logging no Stape é gratuito para planos pagos — diferente do Google Cloud que cobra separadamente pelo armazenamento de logs.
Os logs mostram o body completo das requisições?
Por padrão, não para requisições POST — apenas headers e metadata. Use a Logger Tag com 'Log Request Body' habilitado para ver o payload completo.
Como filtrar logs por evento específico?
Use os filtros disponíveis nos Stape Logs: data, nome do client, código de status. Para filtragem mais avançada, exporte para BigQuery e use SQL.
Análise de Dados
Dashboards e relatórios que transformam números em decisões — da coleta à interpretação.
Saiba mais