O que é Pub/Sub?
O Google Cloud Pub/Sub é um sistema de mensageria assíncrona que funciona como um 'sistema de correios': o publisher (remetente) envia mensagens para um 'topic' (caixa de correio), e os subscribers (assinantes) as recebem quando estiverem prontos.
O Pub/Sub automatiza esse processo, tornando fácil gerenciar fluxos de dados assíncronos entre sistemas. Existem três tipos de subscription: pull (o assinante busca mensagens), push (o Pub/Sub envia para um endpoint) e export subscriptions.
O que são push subscriptions e por que usar com sGTM?
As push subscriptions são as mais fáceis de usar com containers GTM server — o Pub/Sub envia automaticamente as mensagens para o endpoint do seu sGTM, sem que o sGTM precise fazer polling ativo.
Isso é especialmente útil para rastreamento server-side de eventos que não passam pelo navegador — como eventos de CRM, webhooks de pagamento ou eventos de sistemas internos.
Com push subscriptions, você consegue rastrear eventos de CRM (ex: lead qualificado, venda fechada) no sGTM sem depender de scripts no site ou interações do usuário.
Como criar uma push subscription no Google Cloud
- Acesse o console do Google Cloud > página Pub/Sub > Subscriptions
- Clique em 'Create Subscription'
- Informe o Subscription ID (nome identificador)
- Escolha ou crie o topic correspondente no dropdown
- Selecione Push como tipo de delivery
- Informe o endpoint URL do seu server GTM (subdomínio + path customizado)
- Mantenha os demais valores padrão
- Clique em Create
Você precisa da role Pub/Sub Editor no IAM do projeto. Se não tiver acesso, peça ao administrador do GCP.
Como ouvir mensagens com server GTM
- Configure uma tag Custom Event no sGTM que dispara quando o request Pub/Sub chega ao endpoint
- Use a variável 'X-Gtm-Server-Preview HTTP header' para testar sem cookies de terceiros
- Envie os dados do evento para GA4, Meta CAPI ou outras plataformas diretamente do servidor
- Configure triggers customizados baseados nos dados da mensagem para controle granular
Usando webhooks no server-side tracking
O Pub/Sub push subscription é essencialmente um webhook — qualquer sistema externo (CRM, plataforma de e-commerce, sistema de pagamento) pode enviar dados diretamente ao seu sGTM via HTTP.
- Eventos de CRM: lead qualificado, oportunidade criada, venda fechada — todos podem ser rastreados no sGTM
- Eventos de pagamento: confirmação de pagamento, reembolso, chargeback
- Eventos offline: compra na loja física (via integração com ERP ou POS)
A Stape oferece a feature 'Server GTM Preview Header' que simplifica o debugging de requests HTTP no sGTM.
Perguntas frequentes
Preciso de conta Google Cloud para usar Pub/Sub com sGTM?
Para criar o Pub/Sub no Google Cloud, sim. Mas se você apenas quer receber webhooks de sistemas externos no sGTM, não precisa do Pub/Sub — qualquer sistema que faça HTTP POST para o endpoint do sGTM funciona diretamente.
Como testar se as mensagens Pub/Sub estão chegando no sGTM?
Use o Preview Mode do sGTM com o header X-Gtm-Server-Preview. A Stape também oferece um painel de logs que facilita a visualização de requests recebidos.
Pub/Sub tem custo?
Sim, o Google Cloud cobra pelo Pub/Sub baseado no volume de dados transmitidos. Para volumes baixos (ex: eventos de CRM), o custo geralmente fica dentro do free tier do GCP.
Este artigo é uma adaptação em português de conteúdo originalmente publicado em inglês pela equipe da Stape. Ver artigo original.
