Primeiros Passos com o True Conversions
Este guia cobre o fluxo completo de configuração, desde a criação de uma conta até a verificação da primeira conversão correspondida.
1. Criar uma Conta
- Faça login no painel do True Conversions.
- Vá até Accounts e clique em Add Account.
- Insira o nome da conta (ex.: a marca ou empresa que você gerencia).
- Uma Webhook URL única é gerada automaticamente para essa conta.
2. Instalar a Tag GTM
A tag GTM captura os IDs de clique de anúncios (gclid, fbclid, ttclid) e parâmetros UTM das URLs das páginas de destino e os armazena em cookies primários (first-party). Esses valores são incluídos nos envios de formulários para que o True Conversions possa associar as conversões aos cliques nos anúncios.
Veja as instruções completas no Guia de Instalação.
Resumo:
- No Google Tag Manager, crie uma tag Custom HTML com o script fornecido.
- Configure o acionador (trigger) como All Pages.
- Publique o container.
3. Conectar seu CRM
Navegue até a página CRM Integrations da conta e conecte o CRM que envia os eventos de conversão.
| CRM | Método de conexão | Guia |
|---|---|---|
| Pipedrive | OAuth (um clique) | Configuração Pipedrive |
| RD Station Marketing | OAuth (um clique) | Configuração RD Station |
| ActiveCampaign | API Key | Configuração ActiveCampaign |
Se o seu CRM não está listado, você pode usar a Manual Webhook URL exibida no topo da página de CRM Integrations. Configure seu CRM para enviar payloads JSON via POST para essa URL quando conversões ocorrerem.
4. Conectar Plataformas de Anúncios
Navegue até a página Ad Integrations da conta e conecte as plataformas de anúncios para onde deseja enviar as conversões correspondidas.
| Plataforma | Função | Guia |
|---|---|---|
| Google Ads | Enhanced Conversions for Leads | Configuração Google Ads |
| Meta (Facebook) | Conversions API (CAPI) | Configuração Meta |
5. Configurar o Mapeamento de Campos
Vá até a página Field Mapping da conta. Mapeie os nomes dos campos brutos do payload do webhook do CRM para os campos normalizados que o True Conversions espera:
| Campo normalizado | Descrição |
|---|---|
email |
Email do contato |
phone |
Telefone do contato |
first_name |
Primeiro nome do contato |
last_name |
Sobrenome do contato |
gclid |
Google Ads click ID |
fbclid |
Meta click ID |
ttclid |
TikTok click ID |
event_name |
Nome do evento de conversão (ex.: lead, sale) |
value |
Valor da conversão |
currency |
Código da moeda (ex.: BRL, USD) |
Para Pipedrive, RD Station e ActiveCampaign, os mapeamentos padrão já vêm pré-configurados. Ajuste apenas se o seu CRM usar nomes de campos diferentes do padrão.
6. Verificar as Taxas de Correspondência
Quando os eventos começarem a fluir, vá até a página Stats da conta para monitorar:
- Events received -- total de payloads de webhook recebidos.
- Events processed -- eventos que foram normalizados e roteados.
- Match rate -- porcentagem de eventos que a plataforma de anúncios correspondeu a um clique. Taxas mais altas significam melhor atribuição e otimização de campanhas.
Dicas para melhorar a taxa de correspondência:
- Garanta que a tag GTM dispare na página de destino onde o parâmetro de click ID aparece na URL.
- Verifique se o cookie do click ID persiste entre as páginas até a página de envio do formulário / conversão.
- Inclua
emailephoneem cada evento de conversão -- esses são os identificadores primários que as plataformas de anúncios usam para correspondência. - O True Conversions aplica o hash SHA-256 automaticamente. Se você estiver enviando dados pré-hashados, certifique-se de que estejam em SHA-256 hex minúsculo.
Solução de Problemas
| Sintoma | Causa provável | Solução |
|---|---|---|
| Nenhum evento aparece no painel | Webhook do CRM não está disparando, ou URL incorreta | Verifique o status da integração na página CRM. Reconecte se o status mostrar "expired". |
| Eventos recebidos mas não processados | Worker não está rodando ou mapeamento de campos incompleto | Verifique se todos os campos obrigatórios estão mapeados na página Field Mapping. |
| Taxa de correspondência é 0% | Click IDs não estão chegando no payload do webhook | Verifique se a tag GTM está instalada e se os valores gclid/fbclid estão incluídos no payload do CRM. Veja o Guia de Instalação. |
| "Token expired" na integração do CRM | Token OAuth precisa ser renovado | Clique em Re-authorize na página CRM Integrations para reconectar. |