Como configurar a tag Mixpanel no server-side GTM

18 abr 2026

Integrar o Mixpanel ao server-side GTM oferece vantagens significativas: bypass de ad blockers e restrições de browser, cookies de longa duração e customização avançada de dados enviados.

Como a tag Mixpanel para sGTM funciona

A tag oferece três tipos de ação:

  • Track: Registra eventos no Mixpanel (o tipo mais comum para configurações detalhadas).
  • Alias: Atribui um novo identificador a um contato existente.
  • Reset: Limpa a identificação do usuário — útil para gerenciar múltiplas identidades em dispositivos compartilhados.

Principais opções de configuração

  • Roteamento para servidores da UE (para conformidade GDPR).
  • Gerenciamento automático do distinct_id do cliente.
  • Inclusão de dados comuns: user agent, IP, referrer, dimensões de tela.
  • Extração de parâmetros a partir de variáveis do sGTM.
  • Adição ou remoção de parâmetros específicos.
  • Acesso aos logs Stape para troubleshooting.

Passo a passo de configuração

  1. Crie e configure um container sGTM (via Stape ou Google Cloud).
  2. Na galeria de templates do sGTM, adicione o template da tag Mixpanel.
  3. Crie uma nova tag e selecione o tipo de ação desejado (Track para setup completo).
  4. Insira o ID do projeto Mixpanel e configure as preferências de roteamento de servidor.
  5. Especifique o nome do evento, mapeie variáveis de parâmetros e gerencie parâmetros da requisição.
  6. Aplique o trigger adequado (GA4 Event, por exemplo) e salve.
  7. Teste no sGTM Debugger — verifique se a tag dispara corretamente e se os dados chegam ao Mixpanel.

Por que usar sGTM para Mixpanel?

  • Cookies de Mixpanel definidos via sGTM têm vida útil muito maior que os definidos por JavaScript.
  • Scripts Mixpanel no browser são frequentemente bloqueados por extensões de privacidade.
  • Server-side permite enriquecimento de dados antes do envio ao Mixpanel.

Configure os dados comuns (IP, User-Agent, referrer) cuidadosamente — o Mixpanel usa essas informações para análise geográfica e de dispositivo dos usuários.

Posso usar a tag Mixpanel sGTM sem o GTM web?

Sim, em uma abordagem S2S pura com webhooks. Mas o modelo híbrido (web + server) é mais comum para capturar dados de sessão do browser.

O distinct_id do Mixpanel é gerenciado automaticamente?

Quando a opção está habilitada na tag, sim. O sGTM usa o cookie do Mixpanel existente ou cria um novo identificador para o usuário.

Análise de Dados

Dashboards e relatórios que transformam números em decisões — da coleta à interpretação.

Saiba mais

Fonte original: stape.io — Como configurar a tag Mixpanel no server-side GTM