O que são os SDKs da Stape?
Os SDKs da Stape são bibliotecas de rastreamento server-side que permitem enviar eventos diretamente do backend da sua aplicação para o container server GTM — sem depender de scripts no navegador do usuário.
Diferente do GTM web (que depende de JavaScript no browser), os SDKs funcionam inteiramente no servidor, tornando o rastreamento completamente imune a bloqueadores de anúncios, restrições de cookies e limitações de privacidade dos navegadores.
Quando usar SDKs em vez do GTM web?
- Conversões offline ou backend: eventos que não envolvem o navegador (pagamentos processados, leads qualificados no CRM, compras por telefone)
- Apps mobile nativos: iOS e Android que precisam de rastreamento de eventos sem depender de webviews
- Sistemas de e-commerce customizados: plataformas que processam pedidos no servidor antes de confirmar ao usuário
- Eventos de alta criticidade: quando a perda de qualquer evento seria inaceitável (ex: compras de alto valor)
SDKs e GTM web são complementares, não substitutos. Para a maioria dos negócios, a combinação de ambos oferece a maior cobertura possível de eventos.
Como implementar os SDKs da Stape
- Escolha o SDK para sua linguagem: a Stape oferece SDKs para Node.js, Python, PHP, Ruby, Go e outros
- Instale via gerenciador de pacotes: npm, pip, composer, gem ou go get conforme a linguagem
- Configure o endpoint: aponte o SDK para o URL do seu container sGTM (ex: https://ss.seusite.com.br)
- Defina os eventos: especifique nome do evento, parâmetros e identificadores de usuário
- Implemente nos pontos corretos do código: ex: após confirmação de pagamento, após qualificação de lead no CRM
- Teste com o Preview Mode do sGTM: use o header X-Gtm-Server-Preview para debug
Casos de uso práticos
- E-commerce com checkout customizado: envie o evento purchase diretamente do processador de pagamento, garantindo que cada transação confirmada seja rastreada
- SaaS com trial: rastreie ativações de trial, upgrades e cancelamentos diretamente do backend da aplicação
- Lead scoring no CRM: quando um lead é qualificado como MQL ou SQL, dispare um evento para as plataformas de anúncios via SDK
- Notificações e e-mail marketing: rastreie aberturas, cliques e conversões de e-mail diretamente do servidor de envio
Perguntas frequentes
Os SDKs da Stape funcionam com qualquer linguagem?
A Stape oferece SDKs para as principais linguagens. Para linguagens não suportadas, qualquer biblioteca de HTTP client pode ser usada para enviar requests JSON diretamente ao endpoint do sGTM — a API é padrão HTTP.
Preciso do sGTM para usar os SDKs?
Os SDKs são projetados para enviar dados ao sGTM, que então distribui para GA4, Meta, Google Ads, etc. Mas você também pode usar os SDKs para enviar diretamente às APIs das plataformas sem sGTM.
Como garantir que eventos SDK não sejam duplicados com eventos GTM web?
Configure deduplicação por Event ID — gere um ID único para cada evento no backend e use o mesmo ID tanto no SDK (server) quanto no GTM web (client). As plataformas usam esse ID para remover duplicatas.
Este artigo é uma adaptação em português de conteúdo originalmente publicado em inglês pela equipe da Stape. Ver artigo original.
