--- title: "Integração Customizada" description: "Saiba como integrar qualquer plataforma ao OneClick Tracking via webhook customizado para rastrear conversões nas suas campanhas Meta Ads." --- O OneClick Tracking **corrige atribuições erradas feitas pela Meta**, entregando **dados reais baseados nas UTMs** e permitindo decisões de escala mais seguras. **Com o OneClick Tracking você visualiza no seu gerenciador o volume de conversões reais por período, facilitando uma auditoria rápida e clara, sem a necessidade de dashboards complicados de serem mantidos atualizados.** Nota: O **OneClick Tracking** elimina a necessidade de ferramentas extras de rastreamento! --- :::tip[Você pode conectar várias plataformas ao mesmo tempo] O OneClick Tracking permite conectar **mais de uma plataforma na mesma conta de anúncios** ao mesmo tempo (por exemplo, Hotmart e Eduzz juntas). Cada plataforma tem a sua própria integração — com o seu próprio link de Webhook ou credencial de acesso — e elas convivem sem competir entre si; basta repetir o passo a passo de **"Nova Integração"** para cada uma que você quiser conectar. A atribuição de cada venda à campanha certa é feita pela **UTM**, e não pela plataforma. Por isso, se uma campanha vende por uma plataforma e outras campanhas vendem por outra, cada conversão é ligada automaticamente à campanha de origem, independentemente de qual plataforma originou a venda. O cenário recomendado é **cada campanha atender a uma única plataforma** — evite uma mesma campanha vendendo em duas plataformas ao mesmo tempo. ::: ## Configurando o OneClick Tracking - Acesse sua conta OneClick Ads. - Vá até a aba “OneClick Tracking”, conforme disponível no menu lateral esquerdo do [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking). ![image1](../../../../../public/oneclick-tracking/common/image-1.png) 2. Clique em "Nova Integração". 3. Selecione o tipo de produto ("Geração de leads", "Infoproduto" ou "Ecommerce") e clique em Continuar. 4. Selecione a plataforma "**Customizado**" e clique em Continuar. :::tip[Prefira uma integração nativa quando ela existir] A opção "Customizado" é para plataformas que **ainda não têm** uma integração nativa dentro do OneClick Tracking. Antes de seguir este passo a passo, confira se a sua plataforma já aparece na lista de plataformas suportadas — ela pode ter ganhado uma integração nativa própria (mais simples de configurar, sem precisar do Make). O Chatwoot usado como exemplo abaixo, por exemplo, hoje já tem sua própria integração nativa; o exemplo continua válido para ilustrar o funcionamento do Make com qualquer outra plataforma que ainda dependa da integração Customizado. ::: 4.1 Como configurar uma integração Customizada utilizando o [Make AI](https://www.make.com): 4.2 Utilize esse [layout ](https://us2.make.com/public/shared-scenario/4UnfCA8fV8S/integration-webhooks-json)pronto no seu Make: ![image2](../../../../../public/oneclick-tracking/custom/image-1.png) 4.3 Clique em Editar e crie o primeiro webhook: ![image3](../../../../../public/oneclick-tracking/custom/image-2.png) 4.4 Copie o link do webhook e cole na integração de webhook da plataforma que você esta utilizando (você deve encontrar no app da sua plataforma, o lugar para fazer integrações com webhooks, no meu caso estou fazendo integração customizada com o Chatwoot que é um CRM): ![image4](../../../../../public/oneclick-tracking/custom/image-3.png) ![image5](../../../../../public/oneclick-tracking/custom/image-4.png) 4.5 Agora, de um Start no Make e espere até disparar algum evento de webhook vindo da sua plataforma (para Ecommerce e Infoproduto esses eventos vão ser disparados quando ocorrer alguma venda, mas, para CRMs os eventos vão ser disparados quando algum usuário for criado ou algum estágio for alterado) 4.5.1 Vou simular uma mudança de estágio no Chatwoot para prosseguirmos: ![image6](../../../../../public/oneclick-tracking/custom/image-5.png) Vou adicionar a etiqueta "etapa-1" no usuário "João Teste": ![image7](../../../../../public/oneclick-tracking/custom/image-6.png) ![image8](../../../../../public/oneclick-tracking/custom/image-7.png) 4.6 O evento foi disparado no Make: ![image9](../../../../../public/oneclick-tracking/custom/image-8.png) 4.7 Agora que o evento da plataforma foi recebido pelo Make, podemos tratá‑lo. O primeiro passo é criar um filtro para a próxima etapa (no caso de ecommerce/infoprodutos queremos pegar eventos com `status = "PAID"` ou outro status que você queira rastrear; no caso de CRM queremos rastrear estágios ou labels específicos). Como escolher o tipo de operador no filtro (Array Operators vs Text Operators): - Campos que são listas/arrays (por exemplo `labels`, `tags`, `items`) devem ser filtrados com **Array Operators**. Use operadores como `contains` para verificar se a lista contém um valor específico. Exemplo: se a etiqueta `etapa-1` estiver dentro de `labels`, escolha o campo `labels` → **Array Operators** → `contains` → `etapa-1`. - Campos que são valores simples de texto (por exemplo `status`, `email`, `phone`) devem ser filtrados com **Text Operators**. Use operadores como `equals`, `contains` ou `starts with` conforme o caso. Exemplo: para `status = "PAID"` escolha o campo `status` → **Text Operators** → `equals` → `PAID`. - Atenção: se você estiver selecionando um valor normal (não dentro de uma lista), escolha sempre **Text Operators** em vez de Array Operators — isso evita falsos negativos e operadores incompatíveis. No nosso exemplo o valor que queremos rastrear (`etapa-1`) vem dentro da lista `labels`, então usaremos o **Array Operators** para localizar esse item nos próximos eventos: ![image10](../../../../../public/oneclick-tracking/custom/image-9.png) Como exemplo de filtro quando o campo é um valor simples (não array), utilize a imagem abaixo que mostra a seleção de **Text Operators** e um `equals` para comparar um texto exato: ![image27](../../../../../public/oneclick-tracking/custom/image-21.png) Com o filtro correto criado (Array ou Text Operators), você garante que apenas os eventos desejados seguirão para as próximas ações do cenário. 4.7 Agora com esse evento registrado no Make e o filtro pronto, conseguimos fazer um mapeamento dos parâmetros que a gente quer, pro jeito que a gente precisa: No caso das integrações customizadas para CRM, a gente precisa enviar os dados para o OneClick conforme o payload abaixo (os payloads mudam de integração pra integração, no caso de Ecommerce e Infoproduto, os payloads são diferentes, mas o processo é o mesmo): :::tip[O modelo exato do JSON já vem pronto dentro do OneClick] Você não precisa reconstruir esse payload só a partir do modelo abaixo: a própria tela de configuração da integração "Customizado" mostra o modelo de JSON completo, já preenchido com o nome da sua plataforma e a sua chave secreta — um por tipo de produto (Ecommerce, Infoproduto ou Geração de leads). Copie esse modelo diretamente da tela ao montar o mapeamento no Make. ::: ```json { "payload_id": number, "platform": "nome_da_plataforma_cadastrada", "secret_key": "sua_chave_secreta", "lead_id": number, "data": { "lead": { "created_at": "string", "pipeline_id": "string", "tracking_parameters": { "sck": "string", "src": "string", "utm_source": "string", "utm_medium": "string", "utm_campaign": "string", "utm_content": "string", "utm_term": "string" } }, "customer": { "name": "string", "email": "string", "phone": "string" } } } ``` Copie e cole dentro do JSON do Make: ![image12](../../../../../public/oneclick-tracking/custom/image-11.png) ![image13](../../../../../public/oneclick-tracking/custom/image-12.png) Agora vamos mapear todos os parâmetros que a gente precisa (quando você clica dentro do Object uma caixinha se abre com o evento que a Make recebeu): ![image14](../../../../../public/oneclick-tracking/custom/image-13.png) ![image15](../../../../../public/oneclick-tracking/custom/image-14.png) **_ Muito importante você preencher os parâmetros da UTM (no caso do exemplo não veio nenhuma UTM no evento do webhook). Por isso, é importante você enviar um evento pro Make que contenha as UTMs, assim tracking consegue atribuir as conversões pras respectivas Campanhas, Conjuntos de Anúncio ou os próprios Anúncios _** 4.8 Com o JSON configurado, vem a ultima parte, que é enviar esse evento mapeado para o OneClick Ads, para isso devemos configurar o HTTP: ![image16](../../../../../public/oneclick-tracking/custom/image-15.png) - Cole o link de webhook disponibilizado na etapa 3 da configuração do Tracking dentro do parâmetro URL em HTTP: ![image17](../../../../../public/oneclick-tracking/custom/image-16.png) ![image18](../../../../../public/oneclick-tracking/custom/image-17.png) ![image19](../../../../../public/oneclick-tracking/custom/image-18.png) - Selecione o método: "POST" - Body Content Type: "application/JSON" - Body Content: "JSON string" (adquirido na etapa anterior) 4.9 Salve a integração e ative o "Immediately as data arrives": ![image20](../../../../../public/oneclick-tracking/custom/image-19.png) 5. Volte para a aba "Scenarios" e ative a integração (switch no canto esquerdo): ![image21](../../../../../public/oneclick-tracking/custom/image-20.png) Agora todo evento enviado pela sua plataforma vai ser recebido e tratado pelo Make! 6. Vá para o próximo passo da integração e copie o Script de UTM gerado dentro do OneClick Tracking. ![image22](../../../../../public/oneclick-tracking/common/image-2.png) 6.1. Insira no campo “Parâmetros de URL” dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image23](../../../../../public/oneclick-tracking/common/image-3.png) 7. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTM’s sejam carregadas automaticamente para dentro do card de leads gerados. a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 8. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image24](../../../../../public/oneclick-tracking/common/image-4.png) 9. Defina a Nomenclatura que suas campanhas, conjuntos de anúncios e anúncios receberão dentro do seu gerenciador de anúncios e clique em avançar. :::caution[A renomeação da campanha depende de conversões processadas] A nomenclatura configurada aqui **somente será aplicada ao nome da campanha no gerenciador de anúncios quando houver pelo menos 1 conversão processada**. Receber dados brutos do webhook da plataforma integrada não é suficiente — o sistema precisa ter estruturado e atribuído a conversão a uma campanha. Se o webhook está chegando mas o nome da campanha ainda não foi alterado, aguarde a primeira conversão ser registrada. ::: ![image25](../../../../../public/oneclick-tracking/common/image-5.png) ![image26](../../../../../public/oneclick-tracking/common/image-6.png) --- ## Pronto! Aguarde pelo menos 24 horas para que a configuração esteja vigente e todas as suas campanhas (as que receberem conversões) passarão a registrar as conversões dentro do próprio gerenciador de anúncios. ![image27](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - Só campanhas criadas após a configuração terão acesso ao dado de “Período Máximo”. Isso **não prejudica** de nenhum modo a otimização do OneClick Ads em campanhas mais antigas.