Instalação

Duas linhas na página de vendas e um webhook no WhatsApp. É tudo que o rastreamento precisa.

Instale o pixel na página de vendas

Captura UTMs, fbclid, _fbp, gclid, ttclid, IP, User Agent e referrer, e grava um lead_track_id em cookie próprio.

<!-- GridTrack · cole antes de </head> -->
<script
  async
  src="https://api.gridmark.com.br/p.js"
  data-key="gt_pk_demo_5f3a9c2e"
></script>

O _fbc é reconstruído no formato fb.1.<timestamp>.<fbclid> quando o cookie do Meta ainda não existe. É um detalhe pequeno que responde por boa parte da taxa de match: sem ele, todo visitante que chega antes do pixel do Meta assentar entra sem correspondência.

Marque os botões de WhatsApp

O script reescreve o link e embute o identificador na mensagem padrão.

<!-- Qualquer link para o WhatsApp. O script reescreve o href
     e injeta o lead_track_id no texto pré-preenchido. -->
<a href="https://wa.me/5511999990000" data-gridtrack-wa>
  Falar no WhatsApp
</a>

// Para botões criados por JavaScript depois do load,
// peça o link já rastreado em vez de montar a URL na mão.
const url = window.GridTrack.getWhatsappUrl({
  phone: "5511999990000",
  message: "Olá! Vim do anúncio",
});

O texto pré-preenchido do wa.me é editável, e uma parte dos leads apaga tudo antes de enviar. Por isso o código é curto e sem caracteres ambíguos, e por isso existem os outros dois métodos de casamento abaixo.

Aponte o webhook do WhatsApp

Cole a URL do seu provedor no painel dele. O endpoint valida a assinatura antes de processar qualquer coisa. As credenciais do número entram em Integrações.

WhatsApp Cloud API (oficial)

https://api.gridmark.com.br/webhooks/whatsapp/cloud

Evolution API

https://api.gridmark.com.br/webhooks/whatsapp/evolution

Um webhook público sem verificação de assinatura aceita conversões forjadas — na prática, qualquer pessoa poderia injetar vendas falsas na conta de anúncios do cliente e envenenar o algoritmo.

A cascata de atribuição

Três métodos, tentados nesta ordem. O primeiro que casar vence, e o método usado fica registrado em cada lead — é o que permite auditar a qualidade do rastreamento em vez de confiar no número final.

ctwa_clid

especificado

Anúncios Click-to-WhatsApp entregam o identificador no próprio payload do webhook. Determinístico e imune ao lead apagar o texto. Exige a Cloud API oficial — instâncias não oficiais não recebem este campo.

Tag [id:] na mensagem

especificado

Para o fluxo anúncio → landing page → botão, onde não existe ctwa_clid. Determinístico enquanto o lead não editar o texto.

Proximidade de tempo

especificado

Último recurso, quando a conversa chega sem ctwa_clid e sem a tag. Casa só se houver exatamente um clique sem conversa nos 5 minutos anteriores — com dois ou mais, escolher seria sortear, e atribuição errada é pior do que nenhuma. Grava confiança 0,5, que aparece no detalhe do lead em vez de ficar escondida.