True Conversions - Guia de Instalação

Visão Geral

O True Conversions recebe eventos de conversão dos seus formulários/CRM via webhook, associa-os aos click IDs das plataformas de anúncios e envia os dados para Google Ads e Meta como conversões offline.

Para que a correspondência funcione, o click ID (gclid, fbclid) precisa ser capturado quando o visitante chega ao seu site e incluído no payload de envio do formulário.

Este guia cobre a configuração em dois passos:

1. Instalar a tag GTM que captura os click IDs
2. Incluir os valores capturados no payload do webhook

Passo 1: Instalar a Tag GTM

1. Abra o Google Tag Manager e selecione o seu container.
2. Vá até Tags > New.
3. Nomeie a tag como True Conversions - Click ID Capture.
4. Escolha Tag Type > Custom HTML.
5. Copie todo o conteúdo do arquivo gtm-template.html e cole no campo HTML.
6. Em Triggering, selecione All Pages (dispara em todas as visualizações de página).
7. Clique em Save, depois em Submit para publicar.

O que a tag faz

• Em cada carregamento de página, ela lê estes parâmetros da URL: gclid, fbclid, ttclid, utm_source, utm_medium, utm_campaign.
• Cada valor é armazenado em um cookie primário (first-party) (ex.: _tc_gclid) com expiração de 90 dias.
• Os cookies só são escritos quando o parâmetro está presente na URL — navegações internas nunca sobrescrevem valores capturados anteriormente.
• Uma função global window.getTCParams() é exposta para que seus scripts de formulário possam recuperar os valores armazenados.

Verificando a instalação

1. Visite sua página de destino com um parâmetro de teste, ex.: https://seusite.com/?gclid=test123
2. Abra o DevTools do navegador > Application > Cookies.
3. Confirme que você vê _tc_gclid com o valor test123.
4. No Console, execute window.getTCParams() — deve retornar { gclid: "test123" }.

Passo 2: Incluir os Click IDs no Payload do Webhook

Quando um formulário for submetido, inclua os parâmetros capturados nos dados que você envia para o webhook do True Conversions.

Exemplo: Formulário com JavaScript puro

document.querySelector('#my-form').addEventListener('submit', function (e) {
  e.preventDefault();

  var formData = {
    email: document.querySelector('#email').value,
    phone: document.querySelector('#phone').value,
    first_name: document.querySelector('#first_name').value,
    event_name: 'lead',
  };

  // Inclui click IDs e parâmetros UTM da tag True Conversions
  var tc = window.getTCParams();
  Object.assign(formData, tc);

  fetch('SUA_WEBHOOK_URL', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(formData),
  });
});

Exemplo: Abordagem com campos ocultos

Se você usa um construtor de formulários (Elementor, Typeform, etc.) que não permite JavaScript customizado no envio, você pode preencher campos ocultos.

Adicione uma segunda tag Custom HTML no GTM que dispara após o carregamento da página:

<script>
(function () {
  var tc = window.getTCParams();
  var fields = {
    gclid: tc.gclid || '',
    fbclid: tc.fbclid || '',
    ttclid: tc.ttclid || '',
  };
  for (var key in fields) {
    var el = document.querySelector('input[name="' + key + '"]');
    if (el) el.value = fields[key];
  }
})();
</script>

Depois, adicione campos ocultos <input name="gclid">, <input name="fbclid">, <input name="ttclid"> ao seu formulário. Eles serão enviados junto com os demais dados do formulário e encaminhados para o webhook pelo seu CRM ou backend.

Passo 3: Configurar o Mapeamento de Campos

No painel do True Conversions, vá até a página Field Mapping da conta e mapeie os nomes dos campos brutos do payload do webhook para os campos normalizados:

Ajuste a coluna "Campo bruto" para corresponder às chaves que seu formulário/CRM realmente envia.

Solução de Problemas

Referência de Cookies