True Conversions — Guia de Instalação (Captura do código do clique)

Visão geral

A plataforma já funciona sem este passo — as conversões são atribuídas por email e telefone. Este passo é fortemente recomendado: ele captura o código do clique de cada anúncio (Google e Meta) quando o visitante chega ao site e o leva junto do lead até o CRM, melhorando a precisão da atribuição.

💡 Atalho: cada conta no painel tem sua própria página Configuração e rastreamento (/dashboard/clients/[id]/setup) com a linha pronta para copiar e colar. Este guia explica o mesmo processo em mais detalhe.

O fluxo tem dois passos:

Colar uma linha no site (script hospedado pelo True Conversions). Na maioria dos casos, só isso já basta.
Verificar.

Para precisão máxima existe um passo extra opcional: campos ocultos no formulário (veja abaixo).

Passo 1: Colar uma linha no site

Cole esta única linha em todas as páginas — dentro da tag <head>, ou como uma tag de HTML personalizado no Google Tag Manager com o acionador All Pages:

<script src="https://SEU_DOMINIO/tc.js?t=SEU_TOKEN" async></script>

Não monte a linha manualmente: copie a versão pronta (com o domínio e o token da conta) na página Configuração e rastreamento da conta. O token ?t= identifica a conta — sem ele, o script funciona apenas no modo passivo (não envia nada) e o Passo 1 deixa de ser suficiente sozinho.

O que o script faz

Captura da URL: gclid, wbraid, gbraid (Google), fbclid (Meta) e os UTMs, guardando cada valor em um cookie primário (_tc_*) com validade de 90 dias.
Copia os cookies do pixel do Meta (_fbc/_fbp) quando existem. Quando não há _fbc, constrói o fbc a partir do fbclid da URL no formato permitido pelo Meta. Nunca inventa valores quando não houve clique/pixel do Meta.
Quando o visitante envia um formulário de lead, envia ao True Conversions o código do clique junto com o email com hash SHA-256 (feito no próprio navegador — o email em texto puro nunca sai da página). Quando o webhook do CRM chega para esse mesmo lead sem código do clique, o True Conversions reúne os dois pelo hash do email e anexa o código antes do envio ao Google/Meta. É por isso que os campos ocultos se tornaram opcionais.
Preenche automaticamente os campos ocultos do formulário, se existirem — inclusive em formulários que carregam depois da página (RD Station, Elementor), usando um observador de DOM.
Nós mantemos o script centralmente — você nunca precisa atualizá-lo.

Opcional (máxima precisão): campos ocultos no formulário

Este passo não é mais necessário para a maioria dos casos — o script sozinho já entrega o código do clique. Ele continua disponível como camada extra de precisão: com os campos ocultos, o código do clique viaja dentro do próprio lead no CRM, sem depender do envio do navegador (que pode ser bloqueado por ad-blockers, por exemplo).

No seu construtor de formulários, adicione campos ocultos com exatamente estes nomes:

Essenciais: gclid, fbc
Recomendados: wbraid, gbraid, fbp

O script do Passo 1 preenche esses campos sozinho. Como o CRM já captura os campos do formulário normalmente, os valores seguem junto para o True Conversions. Quando o lead chega com um código do clique no próprio payload, ele sempre tem prioridade sobre o capturado pelo navegador.

Passo a passo para RD Station

No RD Station Marketing, crie os campos como campos ocultos/personalizados no formulário, com os nomes acima.
No mapeamento RD Marketing ↔ RD CRM, mapeie esses mesmos campos para que eles cheguem ao contato dentro do CRM.
Quando o lead avança no funil, o código do clique já está no contato e segue para o True Conversions.

Passo 2: Verificar

O jeito mais fácil: a página Configuração e rastreamento da conta verifica sozinha e mostra um cartão verde quando o script está capturando ("Script ativo — última captura...") ou quando os leads já chegam com código do clique.

Para verificar manualmente:

Visite a landing page com parâmetros de teste, ex.: https://seusite.com/?gclid=teste123&fbclid=teste456.
Abra o DevTools do navegador → Application → Cookies.
Confirme que _tc_gclid aparece com o valor teste123.
Se você usa os campos ocultos opcionais, inspecione o formulário e confirme que foram preenchidos.

No Console, window.getTCParams() retorna todos os valores capturados.

Confirme a tag do Google

No Google Ads, confirme que as conversões otimizadas para leads estão ativadas com a captura de dados fornecidos pelo usuário — é a própria camada de correspondência do Google e funciona em conjunto com este passo. Instruções: https://support.google.com/google-ads/answer/15713840.

Confirme também que a conta de anúncios usa uma ação de conversão exclusiva para o True Conversions — não a mesma ação que a tag do site já dispara. Veja os detalhes em Conectando o Google Ads.

Solução de problemas

Sintoma	Causa	Solução
Cookie `_tc_gclid` não aparece	Script não carregou	Confirme que a linha está no `<head>`/GTM em todas as páginas e que o container foi publicado
Verificação nunca fica verde	Linha instalada sem o token `?t=`	Copie a linha pronta na página Configuração e rastreamento (ela já inclui o token da conta)
Campos ocultos vazios no envio	Nomes diferentes do esperado	Os nomes precisam ser exatamente `gclid`, `fbc`, etc.
`getTCParams()` retorna objeto vazio	Visitante chegou sem parâmetros na URL	Normal — os cookies só são criados quando os parâmetros estão presentes

Referência de cookies

Nome do cookie	Origem	Expiração
`_tc_gclid`	`gclid` (URL)	90 dias
`_tc_wbraid`	`wbraid` (URL)	90 dias
`_tc_gbraid`	`gbraid` (URL)	90 dias
`_tc_fbclid`	`fbclid` (URL)	90 dias
`_tc_fbc`	pixel `_fbc` ou construído do `fbclid`	90 dias
`_tc_fbp`	pixel `_fbp`	90 dias
`_tc_utm_source` / `_tc_utm_medium` / `_tc_utm_campaign`	UTMs (URL)	90 dias