Integração Clint
OneClick Tracking — Integração com a Clint
O que é o OneClick Tracking?
Section titled “O que é o OneClick Tracking?”O OneClick Tracking é a funcionalidade da OneClick Ads que permite rastrear conversões reais geradas pelos seus anúncios de forma mais precisa e confiável.
Ao anunciar no Meta Ads, cada clique no anúncio carrega parâmetros de rastreamento chamados UTMs (por exemplo, utm_source, utm_campaign). Esses parâmetros acompanham o visitante ao longo da jornada, desde o anúncio até o preenchimento de um formulário ou abertura de um negócio no CRM.
O OneClick Tracking captura esses dados e, quando o lead avança até a etapa definida como conversão dentro do seu CRM (neste caso, a Clint), registra esse evento como uma conversão atribuída ao anúncio correto — tornando o ROAS e as métricas de campanha muito mais precisos.
O que é um webhook?
Section titled “O que é um webhook?”Um webhook é uma forma de um sistema enviar dados automaticamente para outro sistema em tempo real, sempre que um determinado evento acontece.
Nesta integração:
- A Clint é quem envia o webhook (com os dados do lead) quando ele chega em uma determinada etapa do funil.
- O OneClick Tracking é quem recebe esses dados e registra a conversão.
Como funciona a integração (visão geral)
Section titled “Como funciona a integração (visão geral)”- O lead clica no anúncio e as UTMs são capturadas.
- O lead preenche um formulário e entra como negócio na Clint.
- Quando o negócio avança até a etapa configurada, a Clint dispara automaticamente um webhook.
- O OneClick Tracking recebe o evento, identifica as UTMs associadas e registra a conversão.
Passo 1 — Configurar a integração no OneClick Tracking
Section titled “Passo 1 — Configurar a integração no OneClick Tracking”- Acesse o OneClick Tracking dentro da OneClick Ads.
- Selecione a conta de anúncios correspondente.
- Clique em Nova integração (ou Novo tracking).
- Selecione Clint como plataforma de origem.
- Preencha as informações solicitadas.
- Ao finalizar, o sistema irá gerar uma URL de webhook exclusiva para essa integração.
- Copie essa URL — você irá usá-la na configuração da Clint.
Passo 1.5 — Obter o Token da API da Clint
Section titled “Passo 1.5 — Obter o Token da API da Clint”Para configurar a integração, você precisará do token da API da Clint. Siga as instruções na documentação oficial: Como funciona a API da Clint.
Passo 2 — Configurar o webhook na Clint
Section titled “Passo 2 — Configurar o webhook na Clint”Para mais detalhes sobre como configurar webhooks na Clint, consulte: Como integrar a Clint com outras plataformas via webhook.
- Acesse sua conta na Clint e vá até o funil (pipeline) que deseja monitorar.
- No menu superior, clique na aba Integrações.
- Clique em criar uma nova integração e escolha a opção de integração via webhook.
- No assistente de configuração, passe pelas etapas:
- Introdução — leia as instruções gerais.
- Criação — defina o nome da integração (ex:
OneClick Tracking). - Mapeamento — configure os campos que serão enviados (veja o Passo 3).
- Configuração — informe a URL do webhook gerada no Passo 1 e defina o gatilho (etapa do funil que deve disparar o webhook).
- Salve a configuração.
Passo 3 — Selecionar os parâmetros no mapeamento de campos
Section titled “Passo 3 — Selecionar os parâmetros no mapeamento de campos”Na etapa de Mapeamento, você precisará indicar quais informações da Clint serão enviadas para o OneClick Tracking.
Abaixo estão os campos recomendados. Mapeie os campos da Clint (coluna esquerda) para os nomes de destino (coluna direita) conforme a imagem de referência:
| Campo na Clint | Mapear campo para |
|---|---|
| Nome | contact_name |
contact_email | |
| Telefone | contact_phone |
| Funil | deal_origin |
| Etapa do funil | deal_stage |
| Dono do Negócio | deal_user |
| Status do Negócio | deal_status |
| page_url | deal_page_url |
| utm_source | deal_utm_source |
| utm_medium | deal_utm_medium |
| utm_campaign | deal_utm_campaign |
| utm_term | deal_utm_term |
| utm_content | deal_utm_content |
Atenção: os campos de UTM (
utm_source,utm_medium,utm_campaign,utm_term,utm_content) são essenciais para que o OneClick Tracking consiga identificar o anúncio que gerou a conversão. Certifique-se de que esses campos estão sendo coletados e enviados corretamente.
A imagem abaixo ilustra o mapeamento de campos conforme exibido na Clint:
Observações importantes
Section titled “Observações importantes”- O webhook só será disparado quando o negócio atingir a etapa configurada como gatilho na Clint. Certifique-se de escolher a etapa que representa uma conversão real para o seu negócio (ex: “Proposta aceita”, “Venda fechada”, etc.).
- Cada conta de anúncios pode ter uma URL de webhook diferente. Se você gerencia múltiplas contas, crie uma integração separada para cada uma.
- As UTMs precisam estar presentes nos campos do negócio na Clint para que a atribuição funcione. Confirme que os formulários de captura de lead estão enviando esses dados para a Clint.
- Após configurar a integração, aguarde o próximo evento de conversão para verificar se os dados estão chegando corretamente no OneClick Tracking.
Resultado esperado
Section titled “Resultado esperado”Após a configuração, cada vez que um negócio na Clint avançar até a etapa configurada como gatilho, a Clint enviará automaticamente os dados para o OneClick Tracking. O sistema irá registrar a conversão e associá-la ao anúncio correto com base nas UTMs — permitindo que você visualize o ROAS real das suas campanhas diretamente na OneClick Ads.