# OneClick Ads Docs > Central de ajuda do OneClick Ads: guias de integração de rastreamento de conversões, otimizações automáticas de campanhas Meta Ads, faturamento e muito mais. O OneClick Ads é uma plataforma de otimização automática de campanhas Meta Ads. Esta documentação cobre: configuração do OneClick Tracking (integrações com Hotmart, Kiwify, Shopify, Pipedrive, HubSpot, Kommo, GoHighLevel e outras plataformas), otimizações automáticas de campanhas, gerenciamento de assinatura e faturamento, e controle de orçamento via OneClick Budget. ## When to use this Reach for OneClick Ads Docs when you need to answer a question about how the OneClick Ads product works. Specifically: - Configuring **OneClick Tracking**: which webhook or credential a given checkout, CRM or ecommerce platform needs, and what the attribution modes do. - Understanding **automatic Meta Ads optimization** by OneClick Ads: the suffix system, pause/scale profiles, manual tags, target CPA and ROAS parameterization. - Linking and troubleshooting **Meta ad accounts**: Business Manager permissions, account access status, why an account shows as disconnected. - **Subscription and billing** questions: billing cycle, plan investment limits, upgrades, contracting without a sales call. - **OneClick Budget**: monthly ad-account spend ceilings, the alerts they raise, and what happens when the ceiling is reached. - Connecting an AI assistant to OneClick Ads over **MCP**, and what that assistant can read or change. - **Validated campaign structures** (Campanhas Validadas): proven CBO/ABO scale and creative-testing blueprints for Meta Ads. ## When not to use this - Meta Ads platform behaviour that is not OneClick Ads-specific — use Meta's own documentation. - Account-specific data (a real campaign's spend, a user's conversions). This site is static documentation; query the MCP server at https://mcp.oneclickads.com.br/mcp instead. - Internal API schemas or payload keys. The agent-facing contract is the MCP tool schema itself, not this site. ## Developer resources - [OneClick Ads MCP server](https://mcp.oneclickads.com.br/mcp): OneClick Ads MCP (Model Context Protocol) server endpoint. Authenticate with OAuth or with an API key sent as `Authorization: Bearer `. - [OneClick Ads MCP — connection guide](https://docs.oneclickads.com.br/pt-br/mcp/conectar-um-assistente-de-ia/): How to connect an AI assistant to OneClick Ads over MCP — OAuth flow and API-key flow, with a curl example. - [OneClick Ads MCP — capabilities](https://docs.oneclickads.com.br/pt-br/mcp/): What the OneClick Ads MCP server exposes: ad accounts, campaigns, ad sets, ads, optimizations and conversion logs. - [OneClick Ads API keys & connected apps](https://app.oneclickads.com.br/user/connections): Create, review and revoke OneClick Ads API keys and connected apps. - [OneClick Tracking — custom webhook integration](https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-customizada/): Send conversions from any platform into OneClick Tracking with a custom webhook payload. - [OneClick Tracking — integration catalog](https://docs.oneclickads.com.br/pt-br/oneclick-tracking/): Every first-party OneClick Tracking integration (Hotmart, Kiwify, Shopify, Nuvemshop, HubSpot, Pipedrive, Kommo, RD Station CRM and more). - [OneClick Ads — recursos para desenvolvedores](https://docs.oneclickads.com.br/pt-br/desenvolvedores/): Developer resources hub for OneClick Ads, in Portuguese. ## How to fetch this site - Every HTML page has a raw Markdown twin at the same path with a `.md` suffix: `https://docs.oneclickads.com.br/pt-br/faq/` → `https://docs.oneclickads.com.br/pt-br/faq.md`. - The Markdown twin is served as `text/markdown; charset=utf-8`. Prefer it over parsing the HTML. - `https://docs.oneclickads.com.br/llms.txt` lists every page; `https://docs.oneclickads.com.br/llms-full.txt` is the whole corpus in one file. - Unknown paths answer **HTTP 404** with a short recovery body — a 404 here means the page does not exist, not that the site is down. - Content is written in pt-BR (Brazilian Portuguese). --- # OneClick Ads — Central de Ajuda Source: https://docs.oneclickads.com.br/index.md > Documentação oficial do OneClick Ads — guias de integração de rastreamento de conversões, otimizações automáticas de campanhas Meta Ads, faturamento e boas práticas para anunciantes. import { CardGrid, LinkCard } from '@astrojs/starlight/components'; O **OneClick Ads** é uma plataforma de otimização automática de campanhas Meta Ads que reduz o CPA, escala conversões e rastreia resultados com precisão. Esta central de ajuda reúne guias práticos para configurar integrações, entender o sistema de sufixos, parametrizar campanhas e gerenciar sua assinatura. ## Como podemos ajudar? --- # Documentação OneClick Ads Source: https://docs.oneclickads.com.br/pt-br.md > Base de conhecimento completa do OneClick Ads: rastreamento de conversões com OneClick Tracking, otimizações automáticas de campanhas Meta Ads, vinculação de contas e gestão de assinatura. O **OneClick Ads** é uma plataforma de otimização automática de campanhas Meta Ads. Este guia reúne tudo que você precisa para configurar, integrar e extrair o máximo da plataforma. ## Módulos - [OneClick Tracking](/pt-br/oneclick-tracking/) — Rastreamento preciso de conversões com integração a Hotmart, Kiwify, Shopify, Pipedrive, HubSpot e outras plataformas. Corrige atribuições erradas da Meta com base nas UTMs das suas campanhas. - [Meta — Contas de Anúncios](/pt-br/meta/) — Vinculação e gerenciamento de contas de anúncios do Facebook/Meta no OneClick Ads. - [Otimizações](/pt-br/otimizacoes/) — Sistema de sufixos, controle de campanhas por tags manuais, parametrização (CPA, ROAS, orçamento) e boas práticas para escalar com eficiência. - [Campanhas Validadas](/pt-br/campanhas-validadas/) — Catálogo de estruturas de campanha comprovadas (CBO Andrômeda, ABO Teste de Criativos e outras) para escalar ou testar criativos, com público, criativos e orçamento recomendados. - [Assinatura e Faturamento](/pt-br/assinatura/) — Planos, ciclos de cobrança, limites de investimento e como fazer upgrade. - [OneClick Budget](/pt-br/oneclick-budget/) — Controle de orçamento mensal por conta de anúncios: alertas de limite e bloqueio automático de escala. - [Notificações](/pt-br/notifications/) — Canais de notificação disponíveis (WhatsApp e e-mail) e como configurá-los. - [Assistente de IA (MCP)](/pt-br/mcp/) — Conecte um assistente de IA (como o Claude) à sua conta para consultar dados e operar campanhas em linguagem natural. --- # Assinatura e Faturamento — OneClick Ads Source: https://docs.oneclickads.com.br/pt-br/assinatura.md > Tudo sobre planos, ciclos de cobrança e limites de investimento do OneClick Ads: como funciona o faturamento mensal, o que acontece ao atingir o limite do plano e como fazer upgrade. Tudo sobre planos, ciclos de cobrança e limites de investimento no OneClick Ads. ## Artigos - [Como funciona o ciclo de faturamento (Billing) e o limite de investimento](/pt-br/assinatura/como-funciona-o-ciclo-de-faturamento-billing/) - [Como contratar o OneClick Ads sem reunião](/pt-br/assinatura/como-contratar-sem-reuniao/) --- # Como contratar o OneClick Ads sem reunião Source: https://docs.oneclickads.com.br/pt-br/assinatura/como-contratar-sem-reuniao.md > Passo a passo para contratar o OneClick Ads diretamente pelo app, sem precisar agendar uma reunião: criar login, escolher o plano e concluir a contratação. > Você pode contratar o OneClick Ads de forma autônoma, direto pelo app. ## Como contratar o OneClick Ads sem fazer reunião? 1. Acesse o **app**; 2. **Crie um login** ou faça login; 3. Você será direcionado à **tela de planos**; 4. **Selecione o plano** desejado — ou, se quiser começar sem compromisso, veja se algum teste gratuito está disponível para você: - No filtro padrão **"Todos os Recursos"**, pode aparecer um **teste gratuito completo (14 dias)**, com acesso tanto à otimização de campanhas quanto ao rastreamento de conversões. - No filtro **"Apenas Tracking"**, pode aparecer a opção de **teste gratuito de rastreamento de conversões (30 dias)**. 5. **Conclua a contratação** diretamente pelo app. :::note Cada conta só pode ativar **um teste gratuito**, entre todas as opções disponíveis. Se você já usou um teste gratuito antes (de qualquer tipo), ou já foi assinante do OneClick Ads, a tela de planos não vai oferecer um novo teste — só planos pagos. ::: :::note O plano **Enterprise** é sob orçamento personalizado: nesse caso, a contratação é feita por contato comercial, e não diretamente pelo app. ::: :::tip[Veja também] Para entender limites de investimento, ciclos de cobrança e upgrade, consulte [Como funciona o ciclo de faturamento (Billing)](/pt-br/assinatura/como-funciona-o-ciclo-de-faturamento-billing/). ::: --- # Como funciona o ciclo de faturamento (Billing) e o limite de investimento no OneClick Ads Source: https://docs.oneclickads.com.br/pt-br/assinatura/como-funciona-o-ciclo-de-faturamento-billing.md > Entenda como funciona o faturamento mensal do OneClick Ads: limite de investimento por plano, reset do ciclo, o que acontece ao atingir o teto e como fazer upgrade. > Sobre os limites de investimento no OneClick Ads O OneClick Ads funciona com **limite de investimento mensal**: seu plano define quanto você pode investir no mês, e esse limite é **reiniciado automaticamente a cada novo ciclo mensal**. --- ## Visão geral - Seu plano (ex.: **R$ 100k/mês**) define o **teto máximo de investimento** dentro do ciclo mensal. - O sistema soma todo o investimento realizado no período e compara com o limite do plano. - Ao iniciar um novo ciclo mensal, o limite volta ao valor total contratado. - Valores não utilizados em um mês **não acumulam** para o próximo. --- ## Como o limite é calculado Durante o ciclo mensal, o OneClick Ads acompanha o **gasto total do mês** e valida se ele está dentro do **limite do seu plano**. **Exemplo (Plano de R$ 100k/mês):** - Você pode investir **até R$ 100k** no total durante o mês. - Quando um novo mês começa, o contador volta para **R$ 0** e você tem **R$ 100k** disponíveis novamente. Observação: o ciclo de acompanhamento do limite segue o **mês-calendário** (do dia 1 até o último dia do mês) — não necessariamente a data em que você assinou ou foi cobrado. --- ## O que acontece quando você atinge o limite Quando o investimento acumulado no mês **se aproxima ou ultrapassa o limite do seu plano**, o sistema avisa você. Se o investimento **permanecer acima do limite de forma contínua por cerca de 24 horas**, o OneClick Ads: - **Pausa automaticamente as otimizações** para evitar que o gasto continue subindo além do contratado; e - Solicita uma ação para continuar investindo: - **Fazer upgrade do plano** (aumentar o limite do mês atual), ou - **Aguardar o próximo mês**, quando o limite será reiniciado. Uma ultrapassagem breve e pontual não pausa nada de imediato — o que importa é ficar acima do limite de forma contínua. --- ## Exemplos práticos ## Cenário 1: ✅ Dentro do limite **Plano:** R$ 100k/mês - Você investe **R$ 70k** ao longo do ciclo mensal. ✅ Tudo certo. No próximo ciclo, você volta a ter **R$ 100k** disponíveis. --- ## Cenário 2: ❌ Tentativa de investir acima do limite **Plano:** R$ 100k/mês - Você investe **R$ 100k** e o gasto permanece acima disso por cerca de 24 horas. ❌ O sistema **pausa automaticamente** e solicita **upgrade** ou espera pelo **reset do próximo mês**. --- ## Cenário 3: ℹ️ Valor não utilizado não vira crédito **Plano:** R$ 100k/mês - Ciclo 1: investe **R$ 60k** - Ciclo 2: deseja investir **R$ 140k** ❌ Não é possível no mesmo plano, porque o limite do ciclo 2 continua sendo **R$ 100k**. ✅ Para investir mais, é necessário **upgrade**. --- ## Soma de contas conectadas O limite mensal considera a **soma do investimento de todas as contas de anúncio conectadas** ao OneClick Ads. **Exemplo:** Se você conectou 3 contas e investiu R$ 40k + R$ 30k + R$ 35k no ciclo mensal, o total é **R$ 105k** — e isso conta contra o seu limite. ✅ Vantagem: você pode distribuir o investimento entre contas como preferir, desde que respeite o teto do plano. --- ## Mudança de plano (upgrade) Se você precisa aumentar o limite para investir mais no mês atual, a alternativa é fazer um **upgrade de plano**. Assim que o upgrade é aplicado, o **teto** passa a refletir o novo valor contratado (conforme as regras comerciais do seu contrato) — o investimento já realizado no mês continua contando, só que agora comparado a um limite maior, o que libera espaço para investir mais dentro do mesmo mês. --- # Campanhas Validadas — Estruturas de Escala Comprovadas Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas.md > Catálogo das Campanhas Validadas do OneClick Ads: estruturas de escala e de teste de criativos comprovadas para Meta Ads (CBO e ABO), com público, criativos e orçamento recomendados para cada uma. > Estruturas de campanha Meta Ads já testadas e aprovadas — escolha um modelo e replique o que dá certo. As **Campanhas Validadas** são um catálogo de estruturas de campanha comprovadas para Meta Ads. Em vez de montar uma campanha do zero, você escolhe um modelo que já provou performar e o replica na sua conta, ajustando público, criativos e orçamento conforme o seu projeto. Cada estrutura tem um objetivo claro — **escalar** o que já funciona ou **testar criativos** com método — e traz recomendações de público, criativo e orçamento. ## Como ler a notação de formato Cada estrutura tem um **formato** no padrão `campanha - conjuntos - anúncios`: - `1-6-3` = **1** campanha · **6** conjuntos de anúncios · **3** anúncios em cada conjunto. - `1-1-10` = **1** campanha · **1** conjunto · **10** anúncios. Quando aparece uma letra, ela é uma variável que você define: - **X** = número de conjuntos (normalmente igual ao número de criativos que você quer testar). - **Y** = número de anúncios por conjunto. - **3x** = 3 réplicas do mesmo anúncio dentro do conjunto. ## CBO ou ABO? - **CBO (orçamento por campanha):** um orçamento único no nível da campanha, que a Meta distribui automaticamente entre os conjuntos, priorizando os que performam melhor. Melhor para **escalar**. - **ABO (orçamento por conjunto):** um orçamento definido em cada conjunto. Melhor para **testar com justiça**, garantindo investimento parecido para cada variação. ## Estruturas de escala Para investir mais no que já converte: - [Escala ABO I](/pt-br/campanhas-validadas/escala-abo-i/) — `1-5-1` (ABO) - [Mix Top Quente](/pt-br/campanhas-validadas/mix-top-quente/) — `1-4-5` (ABO, remarketing) - [Escala CBO I](/pt-br/campanhas-validadas/escala-cbo-i/) — `1-6-3` (CBO) - [Escala CBO II — CPA Desejado](/pt-br/campanhas-validadas/escala-cbo-ii-cpa-desejado/) — `1-6-3` (CBO) - [Escala CBO III](/pt-br/campanhas-validadas/escala-cbo-iii/) — `1-5-10` (CBO) - [Escala Andrômeda](/pt-br/campanhas-validadas/escala-andromeda/) — `1-1-10` (CBO) - [Escala Andrômeda II](/pt-br/campanhas-validadas/escala-andromeda-ii/) — `1-X-Y` (CBO) - [CBO 1-1-1](/pt-br/campanhas-validadas/cbo-1-1-1/) — `1-1-1` (CBO, escala ou teste) ## Estruturas de teste de criativos Para descobrir quais criativos merecem escala: - [Teste de Criativos ABO](/pt-br/campanhas-validadas/teste-de-criativos-abo/) — `1-X-3x` (ABO) - [Teste de Criativos CBO](/pt-br/campanhas-validadas/teste-de-criativos-cbo/) — `1-X-3x` (CBO) - [Teste de Criativos Andrômeda](/pt-br/campanhas-validadas/teste-de-criativos-andromeda/) — `1-1-X` (CBO) ## Como aplicar no OneClick Ads No OneClick Ads, você monta essas estruturas a partir de uma **campanha de referência** pelo menu **Criar Campanha** da Meta: escolha a campanha base, o formato desejado e os criativos, e o OneClick Ads cria a nova campanha na sua conta. > **Observação:** a Meta não permite converter entre CBO e ABO ao replicar. Para criar uma estrutura **CBO**, parta de uma referência **CBO**; para uma **ABO**, parta de uma referência **ABO**. Depois de criar, vale colocar a inteligência do OneClick Ads para otimizar a campanha — veja [Otimizações](/pt-br/otimizacoes/) e [Como Parametrizar Campanhas](/pt-br/otimizacoes/como-parametrizar-campanhas/). --- # CBO 1-1-1 Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/cbo-1-1-1.md > Estrutura validada CBO 1-1-1 (formato 1-1-1) para Meta Ads com público aberto e Advantage+: a estrutura mínima, que serve tanto para teste de criativos quanto para escala. > A estrutura mínima e versátil: um conjunto, um anúncio — pode servir tanto para testar quanto para escalar. **Tipo:** CBO (orçamento por campanha) · **Objetivo:** teste de criativos ou escala. ## Formato `1-1-1` — 1 campanha · 1 conjunto de anúncios · 1 anúncio. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Quando você quer isolar completamente uma combinação de público e criativo — seja para uma leitura limpa em teste, seja para escalar um vencedor em sua própria estrutura. ## Público - **Público aberto com a função Advantage+ (Adv+) ativada.** - Segmente **gênero** e **idade mínima**. ## Criativos - **1 anúncio** por campanha. Essa estrutura pode ser usada tanto para **teste de criativos** quanto para **escala**. ## Orçamento e configurações - Orçamento diário = **25% a 100% do valor de venda do produto** (ou do ticket médio). > **Importante:** defina os **públicos de referência a nível de conta de anúncios** (Advantage+ audience), nas [configurações de público do Ads Manager](https://adsmanager.facebook.com/adsmanager/manage/advertising_settings/audience_segments). --- Ver também: [todas as Campanhas Validadas](/pt-br/campanhas-validadas/). Código no catálogo: `#CBO-08`. --- # Escala ABO I Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/escala-abo-i.md > Estrutura validada Escala ABO I (formato 1-5-1) para escalar no Meta Ads: um público frio Top1 duplicado em 5 conjuntos, cada um com o melhor criativo dos últimos 90 dias. > Escala simples em ABO: pegue o melhor público e o melhor criativo e distribua o orçamento em 5 conjuntos iguais. **Tipo:** ABO (orçamento por conjunto) · **Objetivo:** escala. ## Formato `1-5-1` — 1 campanha · 5 conjuntos de anúncios · 1 anúncio por conjunto. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Quando você já tem um público e um criativo vencedores e quer escalar de forma controlada, dando a cada conjunto o mesmo orçamento. ## Público - Seu **Top 1 público frio**, duplicado em **5 conjuntos** idênticos. ## Criativos - O **Top 1 criativo dos últimos 90 dias** em cada conjunto. ## Orçamento e configurações - Distribua o orçamento entre os 5 conjuntos (ABO). - A janela de **90 dias pode variar** conforme o projeto — use o período que melhor representa a performance recente da conta. --- Ver também: [todas as Campanhas Validadas](/pt-br/campanhas-validadas/). Código no catálogo: `#ABO-01`. --- # Escala Andrômeda Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/escala-andromeda.md > Estrutura validada Escala Andrômeda (formato 1-1-10) para escalar no Meta Ads com público aberto e Advantage+: um único conjunto com 5 a 20 criativos variados e orçamento proporcional ao ticket. > A estrutura de escala mais enxuta: um único conjunto aberto com Advantage+ e muitos criativos variados. **Tipo:** CBO (orçamento por campanha) · **Objetivo:** escala. ## Formato `1-1-10` — 1 campanha · 1 conjunto de anúncios · 10 anúncios (de 5 a 20). [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Para escalar concentrando o aprendizado em um só conjunto de público aberto, deixando os criativos fazerem a segmentação e a Meta otimizar com Advantage+. ## Público - **Público aberto com a função Advantage+ (Adv+) ativada.** - Segmente apenas a **idade mínima**. ## Criativos - **5 a 20 anúncios** em formatos diferentes e com ângulos de copy distintos — vídeos, carrosséis e imagens estáticas. ## Orçamento e configurações - Orçamento diário = **50% a 200% do valor de venda do produto** (ou do ticket médio). > **Importante:** defina os **públicos de referência a nível de conta de anúncios** (Advantage+ audience), nas [configurações de público do Ads Manager](https://adsmanager.facebook.com/adsmanager/manage/advertising_settings/audience_segments). --- Ver também: [Escala Andrômeda II](/pt-br/campanhas-validadas/escala-andromeda-ii/) · [Teste de Criativos Andrômeda](/pt-br/campanhas-validadas/teste-de-criativos-andromeda/) · [todas as Campanhas Validadas](/pt-br/campanhas-validadas/). Código no catálogo: `#CBO-05`. --- # Escala Andrômeda II Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/escala-andromeda-ii.md > Estrutura validada Escala Andrômeda II (formato 1-X-Y) para escalar no Meta Ads em lotes: público aberto com Advantage+ e até 50 conjuntos/lotes de criativos por campanha, sem teto de orçamento. > A Andrômeda em lotes: uma campanha viva que cresce à medida que novos lotes de criativos validados chegam. **Tipo:** CBO (orçamento por campanha) · **Objetivo:** escala em larga escala. ## Formato `1-X-Y` — 1 campanha · **X** conjuntos (lotes) · **Y** anúncios por conjunto. - **X** = número de **lotes de criativos**, com até **50 conjuntos/lotes** na mesma campanha. - **Y** = número de criativos em cada lote — entre **3 e 10** anúncios por conjunto. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Para escalar de forma contínua: em vez de abrir uma campanha nova a cada validação, você acumula lotes de criativos vencedores dentro de uma única campanha. ## Público - **Público aberto com a função Advantage+ (Adv+) ativada.** - Segmente a **idade mínima** e, opcionalmente, o **gênero**. ## Criativos - Cada conjunto é um **lote** com **3 a 10 criativos**. - Pegue **conjuntos já validados de outras campanhas** e duplique-os dentro desta. - Conforme novos lotes de criativos chegarem, basta **inserir novos conjuntos** nesta mesma campanha. ## Orçamento e configurações - Orçamento diário = **no mínimo 50% do valor de venda do produto** (ou do ticket médio). - **Sem teto máximo** — escale enquanto a sua oferta aguentar. > **Importante:** defina os **públicos de referência a nível de conta de anúncios** (Advantage+ audience), nas [configurações de público do Ads Manager](https://adsmanager.facebook.com/adsmanager/manage/advertising_settings/audience_segments). --- Ver também: [Escala Andrômeda](/pt-br/campanhas-validadas/escala-andromeda/) · [todas as Campanhas Validadas](/pt-br/campanhas-validadas/). Código no catálogo: `#CBO-07`. --- # Escala CBO I Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/escala-cbo-i.md > Estrutura validada Escala CBO I (formato 1-6-3) para escalar no Meta Ads: público frio Top1 duplicado 6 vezes (ou público aberto) com os Top 3 criativos dos últimos 90 dias e orçamento no nível da campanha. > Escala clássica em CBO: deixe a Meta distribuir o orçamento entre 6 conjuntos e priorizar o que performa. **Tipo:** CBO (orçamento por campanha) · **Objetivo:** escala. ## Formato `1-6-3` — 1 campanha · 6 conjuntos de anúncios · 3 anúncios por conjunto. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Para escalar deixando o algoritmo da Meta concentrar o orçamento nos conjuntos que performam melhor, mantendo variedade de público e criativo. ## Público - **Top 1 público frio duplicado 6 vezes**, ou públicos abertos. - Em públicos abertos, é o **criativo** que assume a qualidade da segmentação. ## Criativos - Os **Top 3 criativos dos últimos 90 dias**. ## Orçamento e configurações - Investimento diário entre **R$ 200 e R$ 1.000/dia**. - **60% do orçamento diário** distribuído entre os conjuntos como **orçamento mínimo**. - A janela de **90 dias pode variar** conforme o projeto. --- Ver também: [todas as Campanhas Validadas](/pt-br/campanhas-validadas/). Código no catálogo: `#CBO-01`. --- # Escala CBO II — CPA Desejado Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/escala-cbo-ii-cpa-desejado.md > Estrutura validada Escala CBO II (formato 1-6-3) com meta de custo por resultado no Meta Ads: defina o CPA máximo aceitável, use orçamento alto e os Top 2 criativos dos últimos 90 dias. > Escala com teto de custo: você diz à Meta o custo máximo por conversão aceitável e investe alto dentro dele. **Tipo:** CBO (orçamento por campanha) · **Objetivo:** escala com controle de CPA. ## Formato `1-6-3` — 1 campanha · 6 conjuntos de anúncios · 3 anúncios por conjunto. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Quando você tem um custo por conversão-alvo claro e quer escalar sem estourá-lo, deixando a Meta buscar resultados dentro desse teto. ## Público - **Top 1 público frio duplicado 6 vezes**, ou públicos abertos. - Em públicos abertos, o **criativo** é o responsável pela qualidade da segmentação. ## Criativos - Os **Top 2 criativos dos últimos 90 dias**. ## Orçamento e configurações - Defina a **"Meta de custo por resultado"** no valor máximo aceitável por conversão. - O **orçamento diário precisa ser alto** — a estratégia depende de volume. - Se a campanha **não gastar**, crie uma nova com outros anúncios e outras audiências. - A janela de **90 dias pode variar** conforme o projeto. --- Ver também: [todas as Campanhas Validadas](/pt-br/campanhas-validadas/) · [Como Parametrizar Campanhas](/pt-br/otimizacoes/como-parametrizar-campanhas/). Código no catálogo: `#CBO-02`. --- # Escala CBO III Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/escala-cbo-iii.md > Estrutura validada Escala CBO III (formato 1-5-10) para escalar no Meta Ads com público de interesses duplicado 5 vezes e os 10 melhores anúncios da conta, sem orçamento mínimo por conjunto. > Escala com público de interesses e um bloco robusto de criativos por conjunto. **Tipo:** CBO (orçamento por campanha) · **Objetivo:** escala. ## Formato `1-5-10` — 1 campanha · 5 conjuntos de anúncios · 10 anúncios por conjunto. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Para escalar apoiado em públicos de interesse mais evidentes ou já validados, com um volume grande de criativos por conjunto. ## Público - Um **público de interesses** — o mais óbvio possível, ou o mais validado — **duplicado 5 vezes**. ## Criativos - Os **10 melhores anúncios da conta** no período máximo disponível. - O número de criativos pode variar **entre 5 e 10** por conjunto. ## Orçamento e configurações - **Não aloque orçamento mínimo** nos conjuntos — deixe a Meta distribuir livremente (CBO). --- Ver também: [todas as Campanhas Validadas](/pt-br/campanhas-validadas/). Código no catálogo: `#CBO-03`. --- # Mix Top Quente Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/mix-top-quente.md > Estrutura validada Mix Top Quente (formato 1-4-5) para remarketing no Meta Ads: quatro janelas de público quente (7, 30, 90 e 180 dias) com os Top 5 criativos dos últimos 90 dias. > Remarketing organizado por temperatura de público: impacte quem já interagiu com a marca, em quatro janelas de tempo. **Tipo:** ABO (orçamento por conjunto) · **Objetivo:** escala com público quente (remarketing). ## Formato `1-4-5` — 1 campanha · 4 conjuntos de anúncios · 5 anúncios por conjunto. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Para reengajar públicos que já tiveram contato com a marca, separando por quão recente foi esse contato — assim você controla quanto investir em cada janela. ## Público Um conjunto para cada janela de remarketing: - **Conjunto 1:** Remarketing 7 dias - **Conjunto 2:** Remarketing 30 dias - **Conjunto 3:** Remarketing 90 dias - **Conjunto 4:** Remarketing 180 dias O **público de remarketing** combina: visitantes do site (Pixel — Page View) + envolvimentos no Instagram e Facebook + finalizações de compra iniciadas. ## Criativos - Os **Top 5 criativos dos últimos 90 dias**, ou anúncios específicos para remarketing. - **Promover anúncios:** a cada 7–14 dias, duplique dentro de cada conjunto os criativos que se validaram em outras campanhas. ## Orçamento e configurações - Avalie o **tamanho do público de envolvimento** da conta antes de escalar — públicos pequenos esgotam rápido. - A janela de **90 dias pode variar** conforme o projeto. --- Ver também: [todas as Campanhas Validadas](/pt-br/campanhas-validadas/). Código no catálogo: `#ABO-02`. --- # Teste de Criativos ABO Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/teste-de-criativos-abo.md > Estrutura validada Teste de Criativos ABO (formato 1-X-3x) para testar criativos no Meta Ads com justiça: um criativo por conjunto, em 3 réplicas, com orçamento mínimo garantido por conjunto. > Teste de criativos com justiça: cada anúncio no seu próprio conjunto, com orçamento garantido para provar seu potencial. **Tipo:** ABO (orçamento por conjunto) · **Objetivo:** teste de criativos. ## Formato `1-X-3x` — 1 campanha · **X** conjuntos · **3 réplicas** do mesmo anúncio em cada conjunto. O número de conjuntos (**X**) é igual ao número de criativos que você quer testar. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Quando você quer descobrir quais criativos merecem escala, dando a cada um uma chance justa de gastar e gerar dados — sem que o algoritmo sufoque uma variação cedo demais. ## Público - **Projetos já validados, buscando escala:** Top 1 público frio ou público aberto. - **Produtos novos, com públicos quentes:** use envolvimentos (30, 90 ou 180 dias). ## Criativos - **1 criativo por conjunto**, em **3 réplicas** do mesmo anúncio. - O número de conjuntos acompanha o número de criativos a testar. ## Orçamento e configurações - **60% do orçamento diário** deve ser distribuído entre os conjuntos como **orçamento mínimo**, para garantir que cada criativo receba investimento. --- Ver também: [todas as Campanhas Validadas](/pt-br/campanhas-validadas/teste-de-criativos-abo/). Código no catálogo: `#ABO-05`. --- # Teste de Criativos Andrômeda Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/teste-de-criativos-andromeda.md > Estrutura validada Teste de Criativos CBO Andrômeda (formato 1-1-X) para testar criativos no Meta Ads com público aberto e Advantage+: um conjunto onde o número de anúncios é o número de criativos a testar. > A versão de teste da Andrômeda: um conjunto aberto com Advantage+, onde cada anúncio é um criativo em teste. **Tipo:** CBO (orçamento por campanha) · **Objetivo:** teste de criativos. ## Formato `1-1-X` — 1 campanha · 1 conjunto de anúncios · **X** anúncios, onde **X** é o número de criativos que você quer testar. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Para testar criativos dentro da lógica Andrômeda — público aberto e Advantage+ — mantendo tudo em um único conjunto. ## Público - **Público aberto com a função Advantage+ (Adv+) ativada.** - Segmente apenas a **idade mínima**. ## Criativos - **X anúncios**, onde X é o número de criativos a serem testados (recomenda-se de 5 a 20 no conjunto). ## Orçamento e configurações - Orçamento diário = **25% a 100% do valor de venda do produto** (ou do ticket médio). > **Importante:** defina os **públicos de referência a nível de conta de anúncios** (Advantage+ audience), nas [configurações de público do Ads Manager](https://adsmanager.facebook.com/adsmanager/manage/advertising_settings/audience_segments). --- Ver também: [Escala Andrômeda](/pt-br/campanhas-validadas/escala-andromeda/) · [todas as Campanhas Validadas](/pt-br/campanhas-validadas/). Código no catálogo: `#CBO-06`. --- # Teste de Criativos CBO Source: https://docs.oneclickads.com.br/pt-br/campanhas-validadas/teste-de-criativos-cbo.md > Estrutura validada Teste de Criativos CBO (formato 1-X-3x) para testar criativos no Meta Ads com público frio: um criativo por conjunto, em 3 réplicas, no máximo 5 conjuntos por campanha. > Teste de criativos em CBO, enxuto: um criativo por conjunto, no máximo 5 conjuntos, para leituras rápidas. **Tipo:** CBO (orçamento por campanha) · **Objetivo:** teste de criativos. ## Formato `1-X-3x` — 1 campanha · **X** conjuntos · **3 réplicas** do mesmo anúncio em cada conjunto. O número de conjuntos (**X**) é igual ao número de criativos a testar, **até no máximo 5**. [Entenda a notação](/pt-br/campanhas-validadas/#como-ler-a-notação-de-formato). ## Quando usar Para testar criativos em projetos já validados, mantendo a campanha enxuta — sem espalhar o orçamento por conjuntos demais. ## Público - **Top 1 público** — públicos frios. - **Não** trabalhe com mais de **5 conjuntos** por campanha. ## Criativos - **1 criativo por conjunto**, em **3 réplicas** do mesmo anúncio. - O número de conjuntos acompanha o número de criativos a testar (respeitando o limite de 5). ## Orçamento e configurações - **60% do orçamento diário** distribuído entre os conjuntos como **orçamento mínimo**. --- Ver também: [todas as Campanhas Validadas](/pt-br/campanhas-validadas/). Código no catálogo: `#CBO-04`. --- # Recursos para Desenvolvedores — OneClick Ads Source: https://docs.oneclickads.com.br/pt-br/desenvolvedores.md > Recursos técnicos do OneClick Ads em endereços previsíveis: servidor MCP, chaves de API, webhook de conversões do OneClick Tracking e os arquivos legíveis por agentes (llms.txt, AGENTS.md, sitemap). OneClick Ads developer resources: MCP server, API keys, conversion webhooks and machine-readable docs. Esta página reúne, em um só lugar, tudo o que um desenvolvedor — ou um agente de IA — precisa para integrar com o **OneClick Ads**. ## Servidor MCP do OneClick Ads O endereço do servidor MCP é: ``` https://mcp.oneclickads.com.br/mcp ``` É por ele que um assistente de IA lê e opera a sua conta: contas de anúncios, campanhas, conjuntos, anúncios, otimizações e as conversões registradas pelo OneClick Tracking. - [Conectar um assistente de IA (MCP)](/pt-br/mcp/conectar-um-assistente-de-ia/) — as duas formas de autenticar: **OAuth** (login interativo, como no conector do Claude) e **chave de API** no cabeçalho `Authorization: Bearer `, com exemplo de `curl`. - [O que dá para pedir ao assistente](/pt-br/mcp/) — a lista completa de artigos do MCP. Suas chaves de API e os aplicativos conectados ficam em [**Conexões → Apps conectados**](https://app.oneclickads.com.br/user/connections), onde você também revoga o acesso de qualquer integração. ## Webhook de conversões (OneClick Tracking) Se a sua plataforma não está na lista de integrações prontas, você envia as conversões por um **webhook customizado**: - [Integração Customizada](/pt-br/oneclick-tracking/integracao-customizada/) — o passo a passo do webhook, incluindo um cenário pronto no Make. - [Catálogo de integrações](/pt-br/oneclick-tracking/) — Hotmart, Kiwify, Shopify, Nuvemshop, HubSpot, Pipedrive, Kommo, RD Station CRM e as demais plataformas já suportadas. - [Modos de atribuição](/pt-br/oneclick-tracking/modos-de-atribuicao/) — como cada conversão é ligada à campanha de origem pela UTM. ## Arquivos legíveis por máquina Esta documentação é publicada também em formatos que agentes conseguem consumir diretamente: | Endereço | O que é | | ------------------------------------------------------------------------- | ---------------------------------------------------------------------- | | [`/llms.txt`](https://docs.oneclickads.com.br/llms.txt) | Índice de todas as páginas, com título, descrição e link em Markdown | | [`/llms-full.txt`](https://docs.oneclickads.com.br/llms-full.txt) | O conteúdo completo da documentação em um único arquivo Markdown | | [`/AGENTS.md`](https://docs.oneclickads.com.br/AGENTS.md) | Instruções para agentes: quando usar esta documentação e como buscá-la | | [`/sitemap-index.xml`](https://docs.oneclickads.com.br/sitemap-index.xml) | Sitemap XML de todas as páginas | Além disso, **toda página tem uma versão em Markdown** no mesmo endereço com o sufixo `.md` — por exemplo, `…/pt-br/faq/` também responde em `…/pt-br/faq.md`. --- # Perguntas Frequentes Source: https://docs.oneclickads.com.br/pt-br/faq.md > Respostas rápidas para as dúvidas mais recorrentes sobre o OneClick Ads: consultoria e suporte, funcionalidades em desenvolvimento (roadmap) e solução de erros e problemas comuns. Respostas rápidas para as dúvidas mais recorrentes sobre o OneClick Ads. Para guias completos por tema, consulte os módulos no menu lateral (Otimizações, OneClick Tracking, Assinatura, etc.). ## Tópicos - [Consultoria e Suporte](/pt-br/faq/consultoria-e-suporte/) — consultoria em grupo, frequência dos encontros e a forma correta de testar a plataforma. - [Funcionalidades e Roadmap](/pt-br/faq/funcionalidades-e-roadmap/) — o que está em desenvolvimento: integrações, dashboards, criação de campanhas e white label. - [Erros e Problemas](/pt-br/faq/erros-e-problemas/) — o que fazer diante de mensagens de erro, falhas de acesso e campanhas que não aparecem. --- # Consultoria e Suporte Source: https://docs.oneclickads.com.br/pt-br/faq/consultoria-e-suporte.md > Dúvidas frequentes sobre a consultoria em grupo do OneClick Ads: objetivo, frequência e duração dos encontros, e a forma correta de testar a plataforma. > Como funciona a consultoria em grupo e onde tirar dúvidas sobre o uso do OneClick Ads. ## Qual é o objetivo da consultoria em grupo? A consultoria em grupo é um canal recorrente para: - esclarecer dúvidas operacionais e estratégicas; - apresentar melhores práticas de uso do OneClick Ads; - demonstrar funcionalidades atuais e novas; - coletar feedback para orientar melhorias de produto e materiais de suporte. ## Qual é a frequência e duração das consultorias? As consultorias acontecem **toda segunda-feira, às 11h**, com duração estimada de **30 minutos a 1 hora**. O formato é aberto: os usuários entram e trazem dúvidas e casos reais. ## Qual é a forma correta de testar o OneClick Ads? Recomenda-se testar **no mesmo ambiente** (mesma conta de anúncios e ativos) em que as campanhas já rodam, criando ou duplicando campanhas dentro da conta principal. Testes em uma conta de anúncios nova tendem a **piorar o resultado** por falta de histórico e inteligência acumulada, o que dificulta comparações justas. :::tip[Veja também] Para um método completo de medição e comparação de resultados, consulte [Boas práticas para usar e medir a performance](/pt-br/otimizacoes/boas-praticas-para-usar-e-medir-a-performance-do-oneclick-ads/). ::: --- # Erros e Problemas Source: https://docs.oneclickads.com.br/pt-br/faq/erros-e-problemas.md > Solução para problemas comuns no OneClick Ads: erro no servidor ao carregar campanhas, falha de acesso à conta (reconectar), campanhas que não aparecem na lista, erro de "Anunciante ausente" ao criar conjuntos de anúncios, erro de "Termos de Geração de Cadastros" ao duplicar campanhas de Lead Ads e nomenclatura do tracking que demora a atualizar. > O que fazer diante das mensagens e situações mais comuns na plataforma. ## O que significa "erro no servidor" ao carregar campanhas? É um erro relacionado à **API da Meta** (instabilidade). Atualize a página (**F5**) e aguarde alguns instantes antes de tentar novamente. ## O que significa "falha de acesso à conta / reconecte"? Depende da mensagem exata: - **Perda de acesso (pedindo para reconectar)**: geralmente é um problema de **autenticação** (token expirado ou inválido). Reconecte a conta dentro do OneClick e confirme as **permissões** (páginas e Business Managers). - **Falta de permissão para gerenciar campanhas**: a conta continua conectada, mas falta a permissão de **gerenciar campanhas** na Business Manager da Meta. Nesse caso, **reconectar não resolve** — é preciso conceder essa permissão diretamente na Business Manager. Depois de conceder, o aviso sai sozinho: conferimos a permissão de tempo em tempo e liberamos a conta quando encontramos o acesso. Em ambos os casos, confirme também que a conta de anúncios necessária está **habilitada** no OneClick. ## Por que uma campanha pode "não aparecer" na lista? Dois motivos principais: - **Filtros aplicados** — por exemplo, a lista pode estar mostrando apenas campanhas ativas; - **Paginação** — clique em **"carregar mais campanhas"** para listar campanhas mais antigas. ## Por que a criação de um conjunto de anúncios falha com "Anunciante ausente" / "Advertiser is missing"? Essa mensagem vem da própria Meta e indica que a Business Manager ainda não concluiu a **verificação de Beneficiário e Pagador** (Beneficiary and Payer), exigida para veicular anúncios em determinadas localizações — incluindo o Brasil. Não é algo que o OneClick Ads possa preencher automaticamente: a verificação precisa ser concluída diretamente nas configurações de conformidade da Business Manager, na própria Meta. Depois de concluída, tente criar o conjunto de anúncios (ou duplicar a campanha) novamente. ## O que significa o erro de "Termos de Geração de Cadastros" ao duplicar uma campanha? Essa mensagem vem da própria Meta e aparece ao duplicar ou criar campanhas que usam **Formulários Instantâneos (Lead Ads)**: a Página do Facebook usada para gerar os anúncios de cadastro ainda não aceitou os **Termos de Geração de Cadastros** da Meta. A mensagem já traz um link para aceitar os termos — um administrador da Página precisa abri-lo e confirmar a aceitação (ou acessar diretamente https://www.facebook.com/ads/leadgen/tos, selecionando a Página no topo). Se a Página já aparece como aceita, confira dois pontos antes de tentar de novo: - Se é realmente a **mesma Página** promovida por este conjunto de anúncios — o anúncio pode usar uma Página diferente da que aparece no criativo; - Se essa Página está **compartilhada com o OneClick Ads** na conexão da conta da Meta. Depois de aceitar os termos com a Página certa, tente duplicar ou criar a campanha novamente. ## Por que a nomenclatura do OneClick Tracking pode demorar para aparecer ou atualizar? A nomenclatura é atualizada **em ciclos**. Caso a campanha não apareça com a nomenclatura esperada: 1. Atualize a tela (**F5**); 2. Verifique os **filtros** (campanhas ativas/inativas). :::caution[A renomeação depende de conversões processadas] A nomenclatura só é aplicada ao nome da campanha **quando há pelo menos 1 conversão processada e atribuída**. Receber dados brutos do webhook não é suficiente. Se o webhook está chegando mas o nome ainda não mudou, aguarde a primeira conversão ser registrada. Veja mais em [Integração Hotmart](/pt-br/oneclick-tracking/integracao-hotmart/). ::: --- # Funcionalidades e Roadmap Source: https://docs.oneclickads.com.br/pt-br/faq/funcionalidades-e-roadmap.md > O que está em desenvolvimento no OneClick Ads: expansão de integrações de tracking, área de metas no Dashboard de campanhas e novos perfis de otimização. > O que está sendo construído e como novas funcionalidades devem chegar à plataforma. :::note As prioridades e prazos abaixo refletem o planejamento atual e podem mudar. Para dúvidas específicas, fale com o suporte. ::: ## Quais são as funcionalidades prioritárias em desenvolvimento? A fila de desenvolvimento prioriza: 1. **Expansão de integrações** do OneClick Tracking; 2. **Área de metas** dentro do Dashboard de campanhas (o Dashboard em si já está disponível — veja abaixo); 3. **Novos perfis de otimização** da nossa IA para diferentes cenários. A **otimização por ROAS** — ideal para e-commerces e operações guiadas pelo retorno sobre investimento — já está **disponível na plataforma**. Veja como ativá-la em [Como Parametrizar Campanhas](/pt-br/otimizacoes/como-parametrizar-campanhas/). Na sequência, entram otimizações para campanhas de **tráfego (cliques no link)** e de **aquisição de seguidores**. Campanhas de **reconhecimento de marca** tendem a ter prioridade menor, por normalmente não exigirem o mesmo nível de otimização focada em performance. ## O que o Dashboard de campanhas já entrega? O **Dashboard de campanhas** já está disponível na plataforma, voltado a acompanhar performance com foco em **resultado e gestão**, incluindo: - visão consolidada de investimento e performance em tempo real, por conta de anúncios; - indicadores para ajudar a identificar pontos de atenção na performance. Ainda em desenvolvimento: uma área de **metas** para definir objetivos (ex.: ROAS alvo, investimento no mês, faturamento ou meta de conversões) e acompanhar quanto foi atingido e o que falta para bater a meta. ## Como funciona a criação de campanha dentro da plataforma? Já é possível criar uma campanha nova a partir de uma **campanha de referência**, pelo menu **Criar Campanha**: 1. Você escolhe a campanha de referência (uma estrutura que já performa); 2. Define o formato desejado e os criativos; 3. O OneClick Ads publica a nova campanha automaticamente na sua conta. Veja o catálogo de estruturas prontas para usar como referência em [Campanhas Validadas](/pt-br/campanhas-validadas/). Para o dia a dia — acompanhar performance, ligar/pausar e renomear campanhas, conjuntos e anúncios sem abrir o Gerenciador da Meta — use o [Gerenciador de Anúncios](/pt-br/meta/gerenciador-de-anuncios/) do próprio OneClick Ads. ## Posso personalizar o texto que a IA aplica nas campanhas otimizadas? Sim. Na aba **Marca** do seu **Perfil de Usuário** você personaliza, de forma gratuita e sem precisar falar com o suporte, o emoji, o nome que aparece no lugar de "OneClick" (por exemplo, o nome da sua agência) e os textos de ativo/inativo usados no nome das campanhas otimizadas. Veja o passo a passo em [Personalizando a Tag de Otimização](/pt-br/otimizacoes/personalizando-a-tag-de-otimizacao/). Não há previsão confirmada de uma plataforma totalmente white label (com logo e identidade completa). --- # Assistente de IA (MCP) Source: https://docs.oneclickads.com.br/pt-br/mcp.md > Conecte um assistente de IA (como o Claude) ao OneClick Ads via MCP para consultar contas, campanhas, otimizações e conversões em linguagem natural — com segurança e por leitura primeiro. O OneClick Ads expõe um **servidor MCP** (Model Context Protocol) que permite conectar um assistente de IA — como o **Claude** — diretamente aos seus dados da conta. Com isso, você pode pedir, em linguagem natural, coisas como “resuma minhas campanhas ativas de hoje” ou “quantas conversões chegaram pela Hotmart esta semana?”, e o assistente consulta os dados reais do OneClick para responder. A conexão é **segura por padrão**: o assistente só acessa os seus dados, você escolhe se a conexão é **somente leitura** ou também de **escrita**, e pode revogar o acesso a qualquer momento. Com o MCP você pode tanto **analisar** (ler dados e decidir com base neles) quanto **agir** — editar a estrutura no Meta (ligar, pausar, orçamento, renomear) e operar a camada de otimização do OneClick (parametrizar CPA/ROAS, ativar otimizações, criar campanhas) — tudo em linguagem natural, sem precisar saber IDs. ## Artigos - [Conectar um assistente de IA (MCP)](/pt-br/mcp/conectar-um-assistente-de-ia/) — como ligar o Claude à sua conta (OAuth ou chave de API). - [Onboarding guiado por IA](/pt-br/mcp/onboarding-guiado-com-ia/) — peça "iniciar onboarding" e o assistente conduz a configuração da conta etapa por etapa, verificando o progresso sozinho. - [Analisar o desempenho das campanhas com IA](/pt-br/mcp/analisar-o-desempenho-com-ia/) — 50 perguntas prontas de leitura e análise, desempenho ao vivo direto da Meta, além de cruzamentos avançados. - [Editar campanhas, conjuntos e anúncios com IA](/pt-br/mcp/editar-campanhas-conjuntos-e-anuncios-com-ia/) — ações de estrutura no Meta: ligar/pausar, ajustar orçamento e renomear. - [Parametrizar e otimizar campanhas com IA](/pt-br/mcp/operar-campanhas-com-ia/) — a camada do OneClick: parametrizar CPA/ROAS/orçamento, definir o limite mensal de investimento da conta, ativar otimizações e reaproveitar o padrão da conta. - [Criando novas campanhas com IA](/pt-br/mcp/criando-novas-campanhas/) — o guia completo de criação: estrutura, orçamento, criativos (anúncios existentes, imagem ou vídeo por link) e copy. - [Prompts prontos para operar campanhas](/pt-br/mcp/prompts-para-operar-campanhas/) — comandos de ação para copiar, colar e adaptar. - [Formulários de cadastro (Lead Ads) com IA](/pt-br/mcp/formularios-de-cadastro-lead-ads/) — liste os formulários da página e use um deles ao criar campanhas ou anúncios de geração de leads. --- # Analisar o desempenho das campanhas com IA Source: https://docs.oneclickads.com.br/pt-br/mcp/analisar-o-desempenho-com-ia.md > 50 perguntas prontas para pedir ao Claude, via MCP do OneClick Ads, e analisar o desempenho de campanhas, conjuntos e anúncios: melhores estruturas, quando escalar, onde está a verba, fadiga de criativo, funil, tendências, atribuição por UTM e Meta, comparações, descoberta e relatórios — além de descobrir por que um anúncio foi reprovado, como um conjunto está configurado, o que está travando as otimizações da conta agora, e o desempenho ao vivo direto da Meta. > Conecte o **Claude** ao OneClick Ads via MCP e faça perguntas em linguagem natural > sobre o desempenho das suas campanhas, conjuntos e anúncios — para decidir com dados, > não no achismo. Depois de [conectar um assistente de IA](/pt-br/mcp/conectar-um-assistente-de-ia/), o Claude consegue consultar o histórico de desempenho que o OneClick Ads guarda das suas **campanhas, conjuntos de anúncios e anúncios**: gasto, ROAS, custo por conversão, custo por clique, custo por checkout, conversões (por rastreio UTM e pelo pixel do Meta), frequência e muito mais — em várias janelas de tempo (hoje, 3, 7, 14, 30 e 90 dias, além do recorde histórico). Essas ferramentas são de **leitura e análise**: o Claude lê os dados, interpreta e te responde — **quem decide o próximo passo é você** (ou as otimizações automáticas do OneClick Ads). Abaixo estão **50 perguntas prontas** para copiar, colar e adaptar. :::tip[Como usar] Substitua os trechos entre colchetes — como `[nome da campanha]` — pelo nome real da sua estrutura. Você não precisa saber IDs: descreva pelo nome e o Claude localiza. ::: ## Escolher a melhor estrutura 1. "Claude, usando o MCP do OneClick, avalie qual a melhor campanha da minha conta agora." 2. "Claude, qual o meu melhor anúncio da campanha [nome da campanha]? E o pior?" 3. "Claude, qual o meu melhor conjunto de anúncios da campanha [nome] e a frequência dele está saudável?" 4. "Claude, entre as minhas campanhas ativas, qual tem o melhor ROAS nos últimos 7 dias?" 5. "Claude, qual anúncio da conta tem o menor custo por conversão neste momento?" ## Quando escalar 6. "Claude, quais campanhas estão com o ROAS dos últimos 3 dias acima do dos últimos 14 dias? Quais posso escalar?" 7. "Claude, o meu custo por conversão de hoje está pior que a média dos últimos 7 dias na campanha [nome]? É seguro subir orçamento?" 8. "Claude, olha os checkouts iniciados nos últimos 3 dias do meu conjunto novo e me diz se já dá pra escalar." 9. "Claude, o conjunto que subi ontem já tem tração suficiente ou ainda é cedo pra avaliar?" 10. "Claude, quais anúncios estão prontos pra receber mais verba sem perder eficiência?" ## Onde está o dinheiro 11. "Claude, qual campanha está acelerando mais rápido esta semana?" 12. "Claude, tem algum anúncio com ROAS alto mas gasto baixo que eu deveria estar escalando?" 13. "Claude, onde estou queimando verba sem retorno nos últimos 7 e 14 dias?" 14. "Claude, quais conjuntos concentram a maior parte do meu gasto e como está o retorno de cada um?" 15. "Claude, se eu tivesse que cortar 20% do orçamento hoje, quais estruturas seriam as primeiras candidatas?" ## Criativo e frequência 16. "Claude, meus criativos estão cansando? Veja a frequência dos últimos 7 dias junto com o custo por conversão." 17. "Claude, qual anúncio da campanha [nome] tem a frequência mais alta agora?" 18. "Claude, a queda de desempenho do meu melhor anúncio bate com aumento de frequência?" 19. "Claude, quais criativos ainda têm espaço de público antes de saturar?" 20. "Claude, monta um ranking dos meus anúncios por sinal de fadiga (frequência x custo subindo)." ## Diagnóstico de funil 21. "Claude, em que etapa do funil eu perco eficiência na campanha [nome]? Compare custo por clique, por checkout e por conversão." 22. "Claude, meu custo por checkout iniciado está subindo mais que o custo por clique? Onde está o gargalo?" 23. "Claude, o problema da campanha [nome] é topo (clique), meio (checkout) ou fundo (conversão) de funil?" 24. "Claude, quais conjuntos geram muitos cliques mas poucos checkouts?" 25. "Claude, compara a passagem de clique para checkout entre os meus dois melhores conjuntos." ## Tendências e histórico 26. "Claude, me dá a tendência da campanha [nome] nos últimos 30 dias." 27. "Claude, o ROAS do meu melhor conjunto está subindo ou caindo ao longo do tempo?" 28. "Claude, como evoluiu o custo por conversão da campanha [nome] desde que eu a criei?" 29. "Claude, o gasto dessa campanha está estável, acelerando ou desacelerando na última semana?" 30. "Claude, qual foi o melhor momento histórico de ROAS dessa campanha e o quão longe estou dele hoje?" ## Atribuição e confiança no dado 31. "Claude, quais os dados de UTM da campanha [nome] e como se comparam com as conversões do pixel do Meta?" 32. "Claude, posso confiar no ROAS que o Meta está me mostrando nessa campanha?" 33. "Claude, minhas conversões via UTM caíram na campanha [nome] — é queda de performance ou o rastreio quebrou?" 34. "Claude, em quais campanhas o pixel do Meta e o rastreio por UTM mais divergem?" 35. "Claude, o número de conversões que o OneClick rastreia bate com o que o Meta reporta neste anúncio?" ## Comparações e benchmarks 36. "Claude, compara o desempenho das minhas 3 principais campanhas nos últimos 7 dias." 37. "Claude, esse conjunto novo está performando acima ou abaixo da média da campanha?" 38. "Claude, quais anúncios estão acima da média de ROAS da campanha [nome]?" 39. "Claude, compara o custo por conversão de hoje com a média dos últimos 30 dias nas minhas campanhas." 40. "Claude, meus conjuntos ativos estão puxando o resultado pra cima ou pra baixo em relação ao total da campanha?" ## Descoberta e navegação 41. "Claude, qual o ID da campanha [nome]?" 42. "Claude, lista as campanhas da minha conta de anúncios com o desempenho atual de cada uma." 43. "Claude, quais conjuntos existem dentro da campanha [nome] e como cada um está indo?" 44. "Claude, me mostra os anúncios ativos da campanha [nome] com o gasto e o retorno de cada um." 45. "Claude, quantos conjuntos e anúncios ativos essa campanha tem agora?" ## Relatórios e rotinas 46. "Claude, monta um resumo da minha conta hoje: quem está escalando, quem estabilizou e quem preocupa." 47. "Claude, me faz um relatório das 5 melhores e das 5 piores estruturas por ROAS." 48. "Claude, quais estruturas mudaram de tendência da semana passada pra esta?" 49. "Claude, prepara um panorama da conta pra eu apresentar ao cliente: gasto, conversões e ROAS por campanha." 50. "Claude, me diz quais estruturas passaram de positivas para negativas nos últimos dias." ## Quando o problema não é performance — é entrega Nem todo resultado ruim é questão de criativo ou de verba: às vezes o anúncio simplesmente **não está rodando**. O Claude consegue investigar isso sem você abrir o Gerenciador da Meta. **O anúncio foi reprovado — e por quê.** Na listagem de anúncios, o Claude mostra o status real de entrega de cada um, que é diferente do simples "ativo/pausado": um anúncio pode estar ligado e ainda assim **reprovado**, **com pendências** ou **em análise** pela Meta. Quando isso aparece, peça o motivo — ele traz o que a Meta apontou na revisão, com o problema encontrado e a área da política envolvida: - "Claude, tem algum anúncio reprovado na campanha [nome]?" - "Claude, por que o anúncio [nome] foi reprovado? O que a Meta apontou?" - "Claude, esse anúncio está em análise ou já foi recusado de vez?" Se a Meta não tiver detalhado o motivo, o Claude avisa e indica o caminho no Gerenciador da Meta para você ler o aviso original. **Como um conjunto está configurado.** Antes de culpar o criativo, vale conferir as regras de entrega do conjunto — para o que ele otimiza, quando começa e termina, em quais posicionamentos aparece, qual conversão ele promove e **quem** ele alcança (localização, idade, gênero e os públicos incluídos e excluídos): - "Claude, como está configurado o conjunto [nome]? Otimização, período, posicionamentos e público." - "Claude, esse conjunto está com um público muito estreito para o orçamento que ele tem?" - "Claude, o conjunto [nome] tem data de término marcada?" Quando a conclusão for **mudar** o público, veja [Editar campanhas, conjuntos e anúncios com IA](/pt-br/mcp/editar-campanhas-conjuntos-e-anuncios-com-ia/) — lá está o cuidado que essa mudança pede. ## O que está travando as otimizações agora Quando a Meta exige alguma ação sua para liberar uma otimização — aceitar um termo de uso, resolver uma peça de anúncio removida, regularizar algo na conta — o OneClick Ads te avisa por notificação **uma única vez**. Se você não estava olhando naquela hora, ou quer conferir tudo de uma vez antes de investigar campanha por campanha, peça direto ao Claude: - "Claude, tem alguma coisa travando minhas otimizações agora?" - "Claude, lista tudo que está pendente na minha conta segundo a Meta." - "Claude, o que eu preciso resolver para essa campanha voltar a rodar sem restrição?" O Claude retorna cada pendência com o que precisa ser feito e um link direto para revisar no Gerenciador de Anúncios da Meta — sem esperar a próxima notificação. Veja também [Acesso e Status da Conta de Anúncios](/pt-br/meta/acesso-e-status-da-conta-de-anuncios/) para entender a diferença entre isso e um problema de acesso à conta inteira. Depois de resolver algo do lado da Meta, você pode avisar o Claude para o OneClick tentar de novo sem esperar — essa parte é escrita, então está em [Avisar que você resolveu uma pendência](/pt-br/mcp/operar-campanhas-com-ia/#avisar-que-você-resolveu-uma-pendência). ## Desempenho ao vivo, direto da Meta Além do histórico que o OneClick Ads guarda, o Claude também consegue puxar os números **ao vivo**, direto da API da Meta, no momento em que você pergunta — útil para decidir algo agora mesmo, sem esperar a próxima atualização. 1. "Claude, quais foram os criativos com melhor desempenho da minha conta esta semana, direto da Meta?" 2. "Claude, olhando os dados ao vivo da Meta dos últimos 7 dias, qual anúncio devo escalar agora?" 3. "Claude, como está o desempenho ao vivo desta campanha agora — CTR, custo por conversão e ROAS?" 4. "Claude, olhando só de 1 a 8 de setembro, direto da Meta, qual anúncio teve o melhor ROAS?" :::tip[Também dá para pedir um intervalo específico de datas] Além de períodos relativos ("últimos 7 dias"), você pode pedir um intervalo exato de datas para os dados ao vivo — útil para comparar um período específico ou auditar uma data passada. A Meta só disponibiliza esses dados ao vivo para os **últimos 37 meses**; para um período mais antigo, peça o histórico que o OneClick Ads já guarda. ::: :::note[Como o Claude escolhe o "melhor" criativo] Diferente do cruzamento com o OneClick Tracking abaixo (que é feito na hora, sob pedido), essa leitura já vem **rankeada** direto da Meta. A ordem é: primeiro por ROAS (retorno sobre o investimento), quando a Meta reporta esse dado para o anúncio; sem ROAS, pelo número de conversões; e, na ausência de ambos, pelo valor investido. O Claude sempre te diz qual critério foi usado para cada anúncio. ::: ## Bônus — cruzamentos avançados Duas análises mais fundas que combinam fontes de dados diferentes. Peça-as quando quiser uma leitura de retorno mais fiel do que a do Gerenciador sozinho: - "Claude, cruza os dados do OneClick Tracking com os do Gerenciador e me diz qual foi o **melhor anúncio** da conta neste mês." - "Claude, calcula o ROAS real por anúncio usando a receita rastreada pelo OneClick Tracking dividida pelo gasto do Gerenciador." - "Claude, **agrupa os anúncios pelo nome do criativo** — o mesmo criativo pode estar duplicado em vários conjuntos, então consolida antes de me dizer qual vende mais." - "Claude, me separa o melhor anúncio por **eficiência (ROAS)** e o melhor por **volume (receita)** — são criativos diferentes?" :::tip[Por que agrupar por criativo] O mesmo criativo costuma rodar como vários anúncios (um por conjunto), cada um com um ID diferente. Sem consolidar por nome, um campeão pode aparecer "fatiado" e parecer menor do que realmente é. ::: Quando quiser **agir** sobre essas conclusões (parametrizar, escalar, criar campanha), veja [Parametrizar e otimizar campanhas com IA](/pt-br/mcp/operar-campanhas-com-ia/). --- ## Dica final Comece pelas perguntas de **descoberta** (itens 41 a 45) para o Claude mapear a sua conta e, em seguida, aprofunde com as análises de **escala**, **funil** e **tendência**. Como tudo aqui é leitura, você pode explorar à vontade — nenhuma dessas perguntas altera as suas campanhas. Para conectar o Claude à sua conta, veja [Conectar um assistente de IA (MCP)](/pt-br/mcp/conectar-um-assistente-de-ia/). --- # Conectar um assistente de IA (MCP) Source: https://docs.oneclickads.com.br/pt-br/mcp/conectar-um-assistente-de-ia.md > Passo a passo para conectar um assistente de IA ao OneClick Ads via MCP: conexão por OAuth (login, como no conector do Claude) ou por chave de API no cabeçalho Authorization, com exemplo de curl. > Conecte um assistente de IA (como o **Claude**) aos seus dados do OneClick Ads e > faça perguntas em linguagem natural sobre campanhas, otimizações e conversões. O OneClick Ads oferece um **servidor MCP** (Model Context Protocol) — um endpoint que assistentes de IA entendem nativamente. Depois de conectado, o assistente pode consultar, por exemplo, suas contas de anúncios, campanhas, otimizações e os logs de conversão do OneClick Tracking. ## O endereço do servidor ``` https://mcp.oneclickads.com.br/mcp ``` Esse é o único endereço que você precisa informar ao seu assistente. Existem **duas formas** de autenticar a conexão. Escolha a que o seu aplicativo suporta: | Forma | Quando usar | | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **OAuth (login)** | Aplicativos com suporte a conector MCP e login interativo — por exemplo, os apps do **Claude** (Claude.ai, Claude Desktop, Claude Code). | | **Chave de API (cabeçalho)** | Integrações que enviam um token fixo no cabeçalho `Authorization` — por exemplo, a **API do Claude** (parâmetro de conector MCP) ou agentes próprios em servidor. | --- ## Opção 1 — Conexão por OAuth (login) Indicada para clientes que abrem uma janela de login. É o caso dos conectores personalizados do Claude. Nesse fluxo você **não precisa gerar nenhuma chave**: o próprio aplicativo faz o login e pede a sua autorização. 1. No seu assistente, adicione um **conector/servidor MCP personalizado**. 2. Informe o endereço do servidor: `https://mcp.oneclickads.com.br/mcp`. 3. O aplicativo abrirá uma janela de **login do OneClick Ads**. Entre com a sua conta. 4. Revise e **autorize** os acessos solicitados (leitura e/ou escrita). 5. Pronto — a conexão fica salva no aplicativo e é renovada automaticamente. No caso do Claude, esse fluxo de OAuth é executado de ponta a ponta pelo próprio app. Para detalhes sobre o conector MCP do Claude, consulte a [documentação oficial da Anthropic](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector). Você pode acompanhar e revogar as conexões autorizadas a qualquer momento em [**Conexões → Apps conectados**](https://app.oneclickads.com.br/user/connections). --- ## Opção 2 — Conexão por chave de API (cabeçalho `Authorization`) Indicada para integrações que não fazem login interativo e enviam um token fixo no cabeçalho `Authorization: Bearer `. É a forma mais simples para agentes próprios e para a API do Claude. ### Passo 1 — Gere a sua chave de API 1. Acesse [**Conexões → Chaves de API**](https://app.oneclickads.com.br/user/connections) na sua conta OneClick Ads. 2. Escolha o escopo da chave: - **Somente leitura** (recomendado para começar) — consulta dados, sem alterar nada. - **Leitura e escrita** — permite também alterar otimizações e contas. 3. Clique em **Gerar chave** e **copie o token na hora** — ele aparece **uma única vez** e não pode ser recuperado depois. 4. Guarde o token como um **segredo** (cofre de senhas do aplicativo). Nunca cole em documentos, código ou conversas públicas. ### Passo 2 — Use a chave no cabeçalho Envie o token no cabeçalho `Authorization`: ``` Authorization: Bearer SUA_CHAVE_DE_API ``` ### Conectando pela API do Claude A API do Claude aceita servidores MCP que usam um token no cabeçalho. Informe o endereço do servidor e a sua chave de API no campo de autorização do conector: ```json { "mcp_servers": [ { "type": "url", "url": "https://mcp.oneclickads.com.br/mcp", "name": "oneclickads", "authorization_token": "SUA_CHAVE_DE_API" } ] } ``` O `authorization_token` é enviado pelo Claude como `Authorization: Bearer SUA_CHAVE_DE_API`. Veja os detalhes na [documentação do conector MCP do Claude](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector). --- ## Gerir vários clientes, cada um com a própria conta OneClick (agências) Se você é agência ou gestor de tráfego e cada cliente tem a **própria conta OneClick Ads**, a conexão é sempre **por login**: o assistente enxerga exatamente as contas de anúncios do login que autorizou a conexão. Para operar as contas de outro cliente, você troca **qual login** está conectado. - **Por OAuth (login):** cada conexão vale para **um login**. Para trocar de cliente, desconecte o conector e reconecte fazendo o login da conta OneClick **dele** (ou peça para o próprio cliente autorizar). Num mesmo app costuma haver **um conector por login** — para manter vários clientes ativos ao mesmo tempo, use logins/sessões separadas do assistente. - **Por chave de API:** gere **uma chave por cliente** (cada uma na conta OneClick do respectivo cliente) e aponte cada agente/sessão para a chave certa. É o caminho mais prático para automações que atendem várias contas. :::tip[Confirme em qual cliente você está] Antes de operar, confirme a conexão ativa: _"Claude, quais contas de anúncios eu enxergo agora?"_ — as contas listadas são as do login/chave conectado. Se aparecer o cliente errado, troque a conexão antes de qualquer ação de escrita. ::: :::note[Uma ação em várias contas do mesmo login é outra coisa] Aqui tratamos de clientes com **contas OneClick separadas**. Se as várias contas de anúncios estão **sob o mesmo login**, você não troca de conexão — basta pedir a ação para todas de uma vez. Veja [Editar campanhas, conjuntos e anúncios com IA](/pt-br/mcp/editar-campanhas-conjuntos-e-anuncios-com-ia/). ::: --- ## Testando a conexão com curl Para confirmar que a sua chave funciona, faça uma chamada de leitura. O comando abaixo lista as suas contas de anúncios Meta: ```bash curl https://mcp.oneclickads.com.br/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -H 'Authorization: Bearer SUA_CHAVE_DE_API' \ --data '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "listMetaAdAccounts", "arguments": {} } }' ``` - **Com a chave correta**, a resposta traz os seus dados (status HTTP `200`). - **Sem a chave** (ou com uma chave inválida), a resposta é `401 Unauthorized`. - Com uma chave **somente leitura**, tentar uma ação de escrita retorna um erro indicando que a operação exige o escopo de escrita — exatamente o comportamento esperado. --- ## Por onde começar depois de conectar Conectou o assistente e não sabe por onde começar? Abra **Prompts**, no menu lateral do OneClick Ads (`app.oneclickads.com.br/prompts`). A página traz comandos prontos, organizados em quatro temas — entender a conta, otimizar campanhas, criativos e rastreamento — cada um com um botão de **copiar**. Cole no seu assistente e adapte os detalhes (nome da campanha, valores) antes de enviar. Se ainda não conectou nenhum assistente, a página mostra os mesmos prompts com um aviso e um atalho para [**Conexões**](https://app.oneclickads.com.br/user/connections) — dá para ver o que o assistente vai poder fazer antes mesmo de conectar. Para comandos de **ação** mais avançados (parametrizar em lote, criar campanhas por replicação), veja [Prompts prontos para operar campanhas](/pt-br/mcp/prompts-para-operar-campanhas/). --- ## Segurança e boas práticas - **Comece por leitura.** Conecte primeiro com escopo somente leitura, valide os dados e só depois considere a escrita. - **A escrita altera campanhas de verdade.** Ações como ativar/desativar otimizações mudam o comportamento real das suas campanhas. Use escopo de escrita apenas quando necessário e, de preferência, com confirmação humana antes de cada alteração. - **Trate a chave como uma senha.** Ela dá acesso à sua conta. Guarde-a apenas no cofre de segredos do aplicativo. - **Revogue quando quiser.** Se uma chave vazar ou não for mais usada, revogue-a em [**Conexões → Chaves de API**](https://app.oneclickads.com.br/user/connections) e gere uma nova. O mesmo vale para apps conectados por OAuth. --- # Criando novas campanhas com IA Source: https://docs.oneclickads.com.br/pt-br/mcp/criando-novas-campanhas.md > Peça uma campanha nova ao Claude, via MCP do OneClick Ads, em linguagem natural: escolher a campanha de referência, montar a estrutura de conjuntos e anúncios, definir orçamento, escolher os criativos (anúncios que já rodam, imagem por link ou vídeo por link) e escrever a copy. Também dá para montar um conjunto de anúncios totalmente do zero, sem nenhuma referência, ou adicionar anúncios a um conjunto já existente — com prompts prontos para copiar e adaptar. > **Dá para criar campanha nova conversando.** Depois de > [conectar um assistente de IA](/pt-br/mcp/conectar-um-assistente-de-ia/), você descreve a campanha > que quer — estrutura, orçamento, criativos e copy — e o Claude sobe ela na sua conta de > anúncios. Sem montar nada na mão, sem saber IDs. Este artigo é o guia completo de **criação**. Para ajustar o que já existe (ligar, pausar, mudar orçamento, renomear), veja [Editar campanhas, conjuntos e anúncios com IA](/pt-br/mcp/editar-campanhas-conjuntos-e-anuncios-com-ia/). Para configurar a otimização automática da campanha depois de criada, veja [Parametrizar e otimizar campanhas com IA](/pt-br/mcp/operar-campanhas-com-ia/). :::caution[A criação acontece de verdade] A campanha é criada na sua conta de anúncios do Meta. Conecte com escopo de **escrita** e peça sempre para **subir pausada** — assim você revisa no Gerenciador antes de qualquer centavo ser gasto. ::: ## Toda campanha nasce de uma referência sua A criação funciona por **replicação**: você aponta uma campanha que já existe na conta para servir de molde, e o Claude monta a nova a partir dela — herdando público, segmentação, objetivo e configurações que você já validou. O que você define no pedido é o que muda: quantos conjuntos, quantos anúncios, quais criativos, qual copy, qual orçamento. Na prática isso é uma vantagem: você não recria segmentação a cada campanha nem corre o risco de subir algo com público diferente do que funciona na sua conta. :::note[Escolha uma referência do mesmo tipo de orçamento] Ao **duplicar** uma campanha inteira, a nova nasce com o **mesmo tipo de orçamento** da referência. Se você quer uma campanha com orçamento no nível da campanha (CBO), escolha uma referência CBO; se quer orçamento por conjunto (ABO), escolha uma referência ABO. Peça ao Claude para conferir o tipo da referência antes de criar — ele identifica e avisa se não bater com o que você pediu. ::: ## Ou criar uma campanha nova sem duplicar tudo Em vez de replicar uma campanha inteira, dá para pedir uma campanha **do zero**: você define o nome, o objetivo e o orçamento, e só os **conjuntos** vêm de uma campanha existente que serve de modelo — cada um herda público e segmentação do conjunto que o inspirou, mas a campanha em si não copia nada da referência além disso. - _"Claude, cria a campanha [nome], pausada, com orçamento de R$ 150 por dia, usando os conjuntos da campanha [campanha de referência] como modelo."_ É o jeito de pedir um objetivo ou um tipo de orçamento (CBO ou ABO) diferente do que a campanha de inspiração usa — coisa que a duplicação não permite, porque ali a nova sempre herda objetivo e tipo de orçamento da referência. ## Ou montar um conjunto de anúncios totalmente do zero Até aqui, mesmo na criação "do zero" acima, os **conjuntos de anúncios** ainda precisavam ter um conjunto já existente na conta como modelo — ele emprestava o público. Agora dá para pedir um conjunto **sem nenhuma referência**: você descreve o público, o orçamento e o objetivo, e o Claude monta a segmentação do zero. - **Localização** — por enquanto, só por país (ex.: Brasil). Ainda não dá para segmentar por estado, cidade ou CEP num conjunto sem referência — a saída é partir de um **público salvo** que já tenha essa segmentação: o Claude aplica a segmentação salva como base (estado, cidade e CEP incluídos, se houver) e você só ajusta o que quiser por cima. - **Idade e gênero** — como em qualquer conjunto. - **Públicos personalizados** — quais incluir e quais excluir. - **Expansão de público Advantage+** — ligar ou desligar como em qualquer conjunto. Como não há referência para herdar, o Claude também pergunta a **estratégia de lance** da campanha nesse modo — na criação por referência ela sempre vem herdada, então normalmente você nem precisa pensar nisso. - _"Claude, cria a campanha [nome] com um conjunto novo do zero: Brasil, 25 a 45 anos, ambos os gêneros, orçamento de R$ 100/dia, objetivo de conversão, sobe pausada."_ - _"Claude, monta um conjunto do zero usando o público salvo [nome do público salvo] como base, só ajustando a idade mínima para 30."_ :::note[Uma coisa ou outra, não as duas] Num mesmo pedido, os conjuntos são todos por referência ou todos do zero — não dá para misturar os dois modos na mesma campanha. ::: ## Você também pode adicionar a uma campanha já existente Em vez de criar uma campanha nova, você pode pedir para os conjuntos copiados entrarem direto em uma **campanha que já existe e está em veiculação** — o mesmo recurso disponível no menu [Criar Campanha](/pt-br/meta/criando-e-duplicando-campanhas/) do painel, agora também por conversa. - _"Claude, adiciona 3 conjuntos parecidos com a campanha [referência] à campanha [campanha existente]."_ Nesse caso não há nome nem status novos para a campanha — você só escolhe se os conjuntos adicionados sobem **ativos** ou **pausados**. :::caution[Atenção ao adicionar em uma campanha já ativa] Se a campanha de destino já estiver ativa, os conjuntos adicionados podem começar a veicular imediatamente. E se ela usa orçamento otimizado (CBO), adicionar novos conjuntos redistribui o orçamento já em uso pelos conjuntos existentes. ::: ## Ou só adicionar anúncios a um conjunto já existente Quando o que está faltando não é um conjunto novo, mas mais um criativo dentro de um conjunto que já está rodando — por exemplo, testar mais duas variações no conjunto que está consumindo mais verba — não é preciso duplicar o conjunto inteiro. Duplicar cria um conjunto sem o histórico de entrega do original e, numa campanha com orçamento otimizado (CBO), esse conjunto novo passa a disputar verba com o original. Agora dá para pedir direto: - _"Claude, sobe mais 2 anúncios no conjunto [nome] usando essas imagens: [link 1], [link 2]."_ - _"Claude, adiciona um anúncio ao conjunto [nome] reaproveitando o criativo do anúncio [nome de outro anúncio]."_ Os criativos dos anúncios novos vêm das mesmas três fontes de sempre — anúncio que já roda na conta, imagem por link ou vídeo por link (veja [Escolhendo os criativos](#escolhendo-os-criativos) acima) — e a copy (texto, título, descrição, botão, link) segue as mesmas regras: opcional, e herdada campo a campo quando você reaproveita um anúncio existente. :::note[Aqui não é tudo ou nada] Diferente da criação de campanha, adicionar anúncios a um conjunto é **melhor esforço por anúncio**: se um dos criativos falhar, os outros continuam sendo criados normalmente, e o assistente avisa quais entraram e quais não. ::: ## O que você define no pedido | Você escolhe | Se não disser nada | | -------------------------------------------------------------- | ------------------------------------- | | **Campanha de referência** | obrigatório — é o molde | | **Estrutura**: quantos conjuntos e quantos anúncios em cada um | copia os conjuntos da referência | | **Orçamento diário** | mantém o orçamento da referência | | **Criativos** de cada anúncio | mantém os anúncios da referência | | **Copy**: texto, título, descrição, botão, link | herda a copy do anúncio de referência | | **Tags de URL** | ficam de fora — informe se você usa | | **Nome** da campanha | mantém o nome da referência | | **Status** (ativa ou pausada) | você precisa dizer — peça **pausada** | Você pode ser genérico (_"replica essa campanha com R$ 100/dia"_) ou detalhista (definindo copy e criativo anúncio por anúncio). O Claude pergunta o que faltar em vez de inventar. Se a campanha de referência for de **formulário de cadastro** (o anúncio abre o formulário em vez de levar para um site), o formulário é herdado do anúncio de referência. Para usar outro, veja [Formulários de cadastro (Lead Ads) com IA](/pt-br/mcp/formularios-de-cadastro-lead-ads/). ## Escolhendo os criativos São **três fontes** — e você pode misturá-las na mesma campanha: ### 1. Anúncios que já rodam na sua conta A opção mais rápida e a mais usada para escala: reaproveitar os criativos que já provaram performance. Você descreve pelo critério, não pelo nome do arquivo. - _"Claude, usa os meus 10 melhores anúncios dos últimos 90 dias."_ - _"Claude, pega os 3 criativos com melhor retorno da campanha [nome] e replica em 5 conjuntos."_ :::tip[Diga o critério e a janela] "Melhores" por **retorno**, por **volume de conversões** ou por **custo por conversão**? Nos últimos 7, 30 ou 90 dias? Peça também para **consolidar por criativo** — o mesmo anúncio costuma rodar em vários conjuntos, e consolidar evita contar um campeão "fatiado" em pedaços. Se a conta não rastreia receita, o assistente ranqueia por conversões e custo por conversão. ::: ### 2. Imagem por link Criativo estático novo, que ainda não existe na conta: você manda o **link** da imagem (um arquivo do Google Drive, por exemplo) e o Claude cria os anúncios com ela. - _"Claude, cria a campanha usando essa imagem em todos os anúncios: [link]"_ - _"Claude, monta 3 conjuntos, cada um com uma dessas imagens: [link 1], [link 2], [link 3]"_ ### 3. Vídeo por link Mesma ideia para vídeo: você manda o link e o assistente cuida do envio e do processamento pelo Meta — que pode levar alguns minutos. Ele acompanha e só cria os anúncios quando o vídeo estiver pronto. - _"Claude, sobe esse vídeo e usa ele na campanha nova: [link]"_ - _"Claude, cria a campanha com esse vídeo [link] e a copy da campanha [nome de referência]."_ :::caution[O link precisa estar público] Para imagem e vídeo, o arquivo tem que estar compartilhado como **"qualquer pessoa com o link"**. Se estiver restrito, o assistente avisa na hora — é só liberar o compartilhamento e pedir de novo. Arquivo no seu computador não funciona: suba para o Drive (ou outro serviço) e compartilhe o link. ::: ## Definindo a copy Para cada anúncio você pode definir: - **Texto principal** — o corpo do anúncio, o texto que aparece acima da mídia. - **Título** — a chamada principal, curta. - **Descrição** — a linha de apoio abaixo do título. - **Botão (chamada para ação)** — ex.: "Saiba mais", "Comprar agora", "Cadastre-se". - **Link de destino** — para onde o clique leva. - **Tags de URL** — os parâmetros de rastreamento no fim do link, quando você usa. **Tudo é opcional, e a herança é por conjunto.** Cada conjunto novo herda a copy do anúncio de referência do conjunto que lhe serviu de molde — então, se a copy que já roda está boa, basta trocar o criativo e não escrever nada. E a herança é campo por campo: dá para mudar só o título e deixar texto, descrição, botão e link vindos da referência. :::caution[As tags de URL são a exceção] Para **criativo novo** (imagem ou vídeo por link), as tags de URL **não** são herdadas: elas entram só se você pedir. Se você usa parâmetros de rastreamento nos seus links, informe-os no pedido — _"aplica as minhas tags de rastreamento em todos os anúncios"_ — ou o anúncio novo sobe sem elas. Ao reaproveitar um anúncio que já existe, as tags dele são mantidas. ::: O **link de destino** é o único campo que a Meta exige em todo anúncio com mídia. Se a referência não tiver um para herdar, o assistente pede o link antes de criar qualquer coisa — em vez de subir um anúncio incompleto. Exemplos de como pedir: - _"Claude, cria a campanha com essa imagem [link] e o texto principal: 'Sua planilha de controle financeiro pronta em 5 minutos.' Título: 'Comece hoje'. Botão: Saiba mais. Destino: [seu link]."_ - _"Claude, mantém a copy da campanha de referência, só troca o criativo por esse vídeo [link]."_ - _"Claude, usa a mesma copy em todos os 10 anúncios, mas muda o título de cada um para testar chamada."_ :::tip[Peça as variações para o próprio assistente] Você não precisa escrever cada versão. Peça: _"Claude, me sugere 5 títulos diferentes para essa oferta e cria um anúncio com cada um"_ — e ele escreve as variações e monta a estrutura de teste. Vale pedir para ele se basear no que já converte: _"escreve no mesmo tom das minhas campanhas que melhor performam"_. ::: :::note[A página do Facebook] Os anúncios são publicados pela mesma página da campanha de referência. Se essa referência não tiver uma página identificável, o assistente pede para você indicar qual usar — antes de criar qualquer coisa. ::: ## Formatos validados: peça pelo nome Você não precisa desenhar a estrutura. Os formatos que já testamos e recomendamos estão nas [Campanhas Validadas](/pt-br/campanhas-validadas/) — e o Claude monta qualquer um deles pelo nome ou pela notação (**1-1-10**, **1-4-5**, **1-5-1**, **1-6-3**). - _"Claude, monta uma Escala Andrômeda (1-1-10) com os meus 10 melhores anúncios dos últimos 90 dias, R$ 100/dia, e sobe pausada."_ - _"Claude, cria uma campanha no formato 1-5-1: o meu melhor anúncio replicado em 5 conjuntos idênticos, R$ 100/dia."_ - _"Claude, distribui os meus 20 melhores criativos em 4 conjuntos de 5 (formato 1-4-5)."_ ## Prompts sugeridos Copie, cole e adapte. Substitua os trechos entre colchetes. ### O básico 1. "Claude, replica a campanha [nome] com R$ 150/dia e sobe pausada." 2. "Claude, quais campanhas eu tenho que servem de boa referência para uma campanha de escala?" 3. "Claude, essa campanha [nome] é CBO ou ABO? Quero criar uma nova do mesmo tipo." 4. "Claude, adiciona 2 conjuntos parecidos com a campanha [referência] à campanha [campanha existente], pausados." 5. "Claude, cria a campanha [nome], pausada, com orçamento de R$ 150 por dia na campanha, usando os conjuntos da campanha [campanha de referência] como referência." ### Conjunto sem referência 1. "Claude, cria a campanha [nome] com um conjunto do zero: Brasil, 25 a 45 anos, orçamento de R$ 100/dia, objetivo de conversão, sobe pausada." 2. "Claude, monta um conjunto do zero a partir do público salvo [nome], só trocando o orçamento para R$ 200/dia." ### Escala com os melhores criativos 4. "Claude, monta uma Escala Andrômeda (1-1-10) com os meus 10 melhores anúncios dos últimos 90 dias, R$ 100/dia, pausada." 5. "Claude, cria uma campanha 1-5-1 com o meu melhor criativo por retorno, consolidando por criativo antes de escolher." 6. "Claude, usa a campanha [nome] como referência e preenche com os anúncios que tiveram melhor custo por conversão nos últimos 30 dias." ### Criativo novo (imagem ou vídeo) 7. "Claude, cria a campanha usando essa imagem em todos os anúncios: [link]" 8. "Claude, sobe esse vídeo [link] e cria uma campanha com ele, herdando a copy da campanha [nome]." 9. "Claude, monta um teste de criativos com essas 4 imagens, uma por conjunto: [links]" 10. "Claude, esse link de imagem está acessível? Confere antes de criar a campanha." ### Copy 11. "Claude, cria a campanha com esse criativo [link], texto principal '[texto]', título '[título]', botão 'Saiba mais' e destino [link]." 12. "Claude, mantém toda a copy da referência e só troca o criativo." 13. "Claude, me sugere 5 títulos para essa oferta e cria um anúncio com cada um, mesmo criativo e mesmo texto principal." 14. "Claude, adiciona as minhas tags de rastreamento no link de todos os anúncios da campanha nova." ### Acompanhar e finalizar 15. "Claude, já concluiu a criação? Me avisa se algum anúncio falhou." 16. "Claude, reenvia o que falhou por erro momentâneo do Meta." 17. "Claude, agora parametriza essa campanha nova no perfil Max Performance com custo por conversão para pausar de R$ 90." ## Depois de pedir: o que acontece 1. **A criação roda em segundo plano.** Você não fica esperando — o assistente acompanha e te avisa quando terminar. 2. **Ou sai completa, ou não sai nada.** Se algum anúncio falhar no meio do caminho, a campanha parcial é desfeita. Você nunca fica com uma campanha meio montada na conta. 3. **Revise no Gerenciador.** Confira criativos, copy, público e orçamento com ela ainda pausada. 4. **Ative e parametrize.** Ligue a campanha e peça ao Claude para configurar a otimização automática — veja [Como Parametrizar Campanhas](/pt-br/otimizacoes/como-parametrizar-campanhas/). :::tip[Falha momentânea não é o fim] Instabilidade do Meta acontece. Se a criação falhar por isso, é só pedir para o assistente reenviar — não precisa remontar o pedido do zero. ::: ## O que ainda não dá para fazer por aqui Para não te deixar tentando algo que não vai funcionar: - **Segmentar um conjunto do zero por estado, cidade ou CEP.** Sem um público salvo como base, a localização de um conjunto sem referência é só por país — para esse nível de detalhe, use uma referência ou um público salvo com essa segmentação. - **Mudar o tipo de orçamento ao duplicar uma campanha inteira.** Nesse caso a nova sempre herda CBO ou ABO da referência — para escolher um tipo diferente, use a criação do zero. - **Carrossel ou vários criativos no mesmo anúncio.** Cada anúncio usa uma mídia. Para testar várias, crie um anúncio por criativo. - **Anexar arquivo do computador.** Imagem e vídeo entram por link público. - **Trocar o criativo de um anúncio que já existe.** Nesse caso, crie um anúncio novo com o criativo novo. ## Boas práticas - **Sempre pausada.** Revise antes de gastar. - **Confirme o orçamento por dia.** O valor que você informa é diário — vale conferir antes. - **Descreva pelo nome.** Campanha, conjunto, anúncio, tag no nome: nunca precisa de IDs. - **Peça um resumo antes.** _"Me mostra o que você vai criar antes de subir"_ — dá para ajustar sem desfazer nada. - **Libere os links antes de pedir.** Imagem e vídeo compartilhados como "qualquer pessoa com o link" evitam ida e volta. - **Peça as tags de rastreamento junto.** Em criativo novo elas não vêm da referência — cite no pedido se você usa. --- # Editar campanhas, conjuntos e anúncios com IA Source: https://docs.oneclickads.com.br/pt-br/mcp/editar-campanhas-conjuntos-e-anuncios-com-ia.md > Agora o seu assistente de IA (como o Claude), conectado ao OneClick Ads via MCP, não só analisa como também executa: ligar e pausar, ajustar orçamento, renomear e editar o público dos conjuntos — localização, idade, gênero e públicos personalizados — em linguagem natural, sem abrir o Gerenciador. Com casos de uso para lançamentos de infoproduto, promoções de e-commerce, geração de leads e gestão de várias contas. > Depois de [conectar um assistente de IA](/pt-br/mcp/conectar-um-assistente-de-ia/) **com permissão > de escrita**, o Claude passa a **executar** ações nas suas campanhas — ligar e pausar, > ajustar orçamento, renomear e mudar **quem** um conjunto alcança — a partir de um pedido em > linguagem natural. Você continua no controle: descreve o que quer, o assistente faz. Até agora, o assistente de IA conectado ao OneClick Ads era ótimo para **ler e analisar** (veja [Analisar o desempenho com IA](/pt-br/mcp/analisar-o-desempenho-com-ia/)). A novidade é que ele também consegue **agir na estrutura** das suas contas de anúncios: **campanhas, conjuntos e anúncios**. Na prática, você deixa de alternar entre o chat e o Gerenciador de Anúncios para cada ajuste — pede em uma frase e pronto. ## Duas inteligências que se somam O OneClick Ads tem uma **inteligência artificial que otimiza sozinha**: ela acompanha a performance 24 horas por dia e decide, por conta própria, **o que pausar** (o que está caro) e **o que escalar** (o que está indo bem) — pelo custo por conversão e pelo ROAS. Isso continua funcionando exatamente como antes. O **assistente de IA** que você conecta (como o Claude) tem outro papel: ele são as **mãos** para as decisões de **contexto** que só você conhece — quando uma oferta começa, quando um produto esgotou, quanto de verba faz sentido investir num dia de pico, como organizar a conta. São coisas que a inteligência do OneClick, de propósito, não decide por você. :::tip[A ideia central] A **inteligência do OneClick Ads** cuida de _o que cortar e o que escalar_ pela performance. O **assistente de IA** cuida do _contexto_: quando estar no ar, quanto investir num dia específico, o que organizar — e entrega tudo isso para o OneClick continuar otimizando. Uma não substitui a outra; elas trabalham juntas. ::: ## O que você pode pedir para o assistente fazer Três tipos de ação valem em qualquer nível — **campanha**, **conjunto** ou **anúncio**: - **Ligar ou pausar** — o mesmo botão de liga/desliga do Gerenciador. Útil para começar, parar ou retomar a veiculação de uma estrutura específica. - **Ajustar o orçamento diário** — mudar quanto uma campanha (quando o orçamento fica na campanha) ou um conjunto (quando o orçamento fica nos conjuntos) gasta por dia. É a sua **decisão de verba**; a inteligência do OneClick segue otimizando dentro do valor que você definir. - **Renomear** — trocar o nome de uma campanha, conjunto ou anúncio para manter a sua organização e o seu padrão de nomenclatura. E há uma quarta ação, específica do **conjunto de anúncios**: - **Editar o público** — mudar **quem** o conjunto alcança: localização, faixa etária, gênero e os públicos personalizados que ele inclui ou exclui. Tem uma seção própria mais abaixo, porque pede mais cuidado que as outras. Você **não precisa saber IDs**: descreve pelo nome que o assistente localiza a estrutura certa. ## Casos de uso ### Lançamentos e datas (infoprodutos) Quem vende curso ou infoproduto trabalha por **calendário de lançamento**. Peça ao assistente para **ligar as campanhas de captação no dia de abertura** e **pausá-las no encerramento do carrinho** — sem precisar acordar cedo para apertar o botão. > "Claude, liga a campanha de captação do lançamento agora." > > "Claude, o carrinho fechou — pausa todas as campanhas do lançamento [nome]." ### Promoções e estoque (e-commerce) Loja tem imprevisto de estoque e data de promoção. O assistente resolve o **contexto** que nenhuma otimização por performance conhece: > "Claude, o produto [nome] esgotou — pausa os anúncios dele." > > "Claude, a promoção de fim de semana começou: liga as campanhas de oferta." ### Verba para dias de pico Datas como Black Friday, um dia de _live_ ou uma virada de campanha pedem **mais verba** — uma aposta sua, não uma decisão de otimização: > "Claude, hoje é dia de pico: sobe o orçamento diário da campanha [nome] para R$ 1.000." > > "Claude, passou a data — devolve o orçamento da campanha [nome] para R$ 300." ### Janelas de veiculação (horário) Se o seu público converte melhor em certas horas, o assistente liga e pausa por **horário**: > "Claude, liga as campanhas de remarketing só agora no horário nobre." > > "Claude, encerrou o dia — pausa as campanhas de prospecção." ### Parada de emergência Site fora do ar, problema no checkout ou no rastreamento? Pause tudo em segundos: > "Claude, deu problema no site — pausa todas as campanhas ativas desta conta agora." ### Organização e padrão de nomes Nomes consistentes deixam a sua conta mais fácil de ler e de acompanhar: > "Claude, renomeia os conjuntos da campanha [nome] no padrão [público] — [idade] — [criativo]." ### Gestão de várias contas (agências e gestores de tráfego) Se você cuida de **várias contas**, o assistente aplica a mesma ação de contexto em todas de uma vez, em linguagem natural: > "Claude, à meia-noite as campanhas de Black Friday precisam ir ao ar em todas as minhas contas." ### Preparar o terreno e entregar para a inteligência do OneClick Você pode combinar as ações: pedir para **duplicar a sua campanha campeã**, ajustar o orçamento, nomear no padrão e **deixar a inteligência do OneClick Ads assumir a otimização** dali em diante — tudo a partir de um pedido, sem montar nada na mão. ## Editar o público de um conjunto de anúncios O público é a resposta para **quem** vê os seus anúncios, e ele vive no **conjunto**. Agora você pode ajustá-lo pelo assistente, sem abrir o Gerenciador da Meta: - **Localização** — onde o conjunto entrega (países, estados, cidades ou CEPs) e, se quiser, onde ele **não** deve entregar. - **Faixa etária** — a idade mínima e a máxima que o conjunto alcança. - **Gênero** — alcançar todos ou restringir a um gênero. - **Públicos personalizados** — quais públicos o conjunto **inclui** e quais ele **exclui**. São os públicos criados a partir dos seus próprios dados (visitantes do site, lista de clientes, engajamento, públicos semelhantes). - **Expansão de público Advantage+** — ligar ou desligar a permissão para a Meta entregar **além** do público que você definiu quando ela prevê um resultado melhor. ### Comece perguntando o que existe hoje Antes de mudar qualquer coisa, peça para o assistente **ler** a configuração atual — ele consegue mostrar o público de um conjunto e a lista de públicos disponíveis na conta, com o tamanho aproximado de cada um: > "Claude, quais públicos eu tenho disponíveis nesta conta de anúncios?" > > "Claude, quem o conjunto [nome] está alcançando hoje? Localização, idade, gênero, interesses e > públicos." > > "Claude, a expansão Advantage+ está ligada nesse conjunto? Qual faixa de idade a Meta sugere > pra ele?" > > "Claude, o que tem dentro do público salvo [nome]?" > > "Claude, qual a estratégia de lance desse conjunto (ou dessa campanha)?" ### Pedindo a mudança > "Claude, no conjunto [nome], sobe a idade mínima para 25 anos." > > "Claude, exclui o público [nome do público de compradores] do conjunto [nome] — não quero > anunciar para quem já comprou." > > "Claude, restringe o conjunto [nome] a São Paulo e Rio de Janeiro." > > "Claude, tira todas as exclusões de público do conjunto [nome]." > > "Claude, desliga a expansão Advantage+ no conjunto [nome]: quero que ele respeite exatamente > o público que eu defini." :::caution[Mexer no público reinicia o aprendizado da Meta] Toda mudança de público faz o conjunto **voltar à fase de aprendizado** da Meta: a entrega e o custo por resultado ficam instáveis por alguns dias, e um conjunto que estava indo bem pode piorar antes de se recuperar. Por isso o assistente **avisa e pede a sua confirmação** antes de aplicar. Evite mexer no público de um conjunto que está performando bem — e, quando quiser testar um público novo, costuma ser mais seguro **duplicar** o conjunto do que reeditar o que já funciona. ::: ### Três detalhes que evitam sustos - **Só muda o que você pediu.** O que você não citar continua exatamente como está — pedir para mudar a idade não mexe na localização nem nos públicos. - **Remover é sempre explícito.** Para tirar uma exclusão ou limpar a lista de públicos, peça com todas as letras ("remove todas as exclusões"). A localização é a única que não pode ficar vazia: a Meta exige que o conjunto entregue em algum lugar, então ela é **substituída**, nunca apagada. - **Não existe desfazer na Meta.** Uma segmentação sobrescrita não volta sozinha. Vale pedir ao assistente que **mostre o público atual antes** de aplicar a mudança, para você ter o registro do que havia. :::note[Públicos salvos: dá para consultar, não para aplicar direto] Além dos públicos personalizados, a conta pode ter **públicos salvos** — configurações de segmentação guardadas no Gerenciador da Meta. O assistente consegue **listar** esses públicos e mostrar o que cada um contém (localização, idade, interesses e outros critérios), mas a Meta **não aceita** que um público salvo seja aplicado a um conjunto já existente por esse caminho. Para usar a segmentação de um público salvo, monte-a pelo Gerenciador da Meta ou peça ao assistente para montar um **conjunto novo do zero usando o público salvo como base** — veja [Criando novas campanhas com IA](/pt-br/mcp/criando-novas-campanhas/). ::: ## Seguro por padrão - **Leitura e escrita são separadas.** Analisar (ler) nunca altera nada. As ações desta página só funcionam se você tiver conectado o assistente **com permissão de escrita** — e você pode revogar esse acesso quando quiser. - **Você continua no comando.** O assistente executa o que você pede; peça uma confirmação antes de ações mais sensíveis (como subir muito o orçamento) sempre que quiser revisar. - **Ligar ou ajustar orçamento aumenta o investimento.** Como mexe em dinheiro real, vale combinar limites com o assistente — por exemplo, um teto de orçamento e um aumento máximo por vez. - **Mudança de público tem custo de aprendizado.** É a ação mais sensível desta página: ela reinicia a fase de aprendizado do conjunto. O assistente sempre avisa e pede confirmação antes de aplicar. :::note[Ligar não é a mesma coisa que otimizar] Ligar uma campanha coloca a estrutura para veicular; **ativar a otimização do OneClick Ads** é o que faz a inteligência começar a ajustar e proteger essa campanha. São coisas diferentes — e você pode pedir as duas ao assistente. ::: ## E as rotinas do dia a dia? Muitos desses pedidos viram **rotinas**: o assistente pode repetir a ação em um horário fixo — subir a verba de manhã em dias combinados, ligar e pausar por janela de horário, congelar o orçamento no fim do mês para não estourar a verba do cliente. Combine sempre limites de segurança (teto de orçamento e aumento máximo por rodada) para as rotinas rodarem com tranquilidade. --- ## Próximos passos - Ainda não conectou? Veja [Conectar um assistente de IA (MCP)](/pt-br/mcp/conectar-um-assistente-de-ia/). - Quer decidir com dados antes de agir? Use as [50 perguntas de análise de desempenho](/pt-br/mcp/analisar-o-desempenho-com-ia/). --- # Formulários de cadastro (Lead Ads) com IA Source: https://docs.oneclickads.com.br/pt-br/mcp/formularios-de-cadastro-lead-ads.md > Campanhas de formulário de cadastro da Meta abrem o formulário dentro do próprio anúncio, sem levar a pessoa para um site. Veja como pedir ao assistente a lista de formulários que a sua página já tem, escolher um pelo nome na conversa e usá-lo ao criar uma campanha ou adicionar anúncios — e o que só pode ser feito na Meta. > **Dá para escolher o formulário conversando.** Quando o anúncio abre um > formulário de cadastro, o assistente consegue listar os formulários que a sua > página já tem e usar o que você escolher — sem você precisar procurar nada no > Gerenciador de Anúncios. ## O que é uma campanha de formulário de cadastro Em algumas campanhas o anúncio não leva a pessoa para um site: ele abre um formulário ali mesmo, dentro do Facebook ou do Instagram. A pessoa preenche nome, e-mail, telefone — o que você tiver pedido — e o contato chega para você. A Meta chama isso de **formulário instantâneo**, e o formulário pertence à **página** do Facebook, não à conta de anúncios. Ou seja: os formulários que você pode usar num anúncio são os formulários da página que aquele anúncio publica. ## Como pedir a lista ao assistente Peça em linguagem natural, apontando o conjunto de anúncios: > Liste os formulários de cadastro disponíveis na página do conjunto > **Remarketing — Setembro** da campanha **Captação Q3**. O assistente descobre sozinho qual é a página a partir do conjunto e responde com os formulários que ela tem, cada um com: - o **nome** do formulário; - se está **ativo** ou **arquivado**; - o **idioma**; - **quando foi criado**; - um **resumo das perguntas** que ele faz. É por isso que dá para escolher pelo nome: você não precisa copiar nenhum código. ## Como usar o formulário escolhido Depois de escolher, é só seguir a conversa normalmente: > Crie a campanha **Captação Outubro**, pausada, com R$ 80 por dia, usando os > conjuntos da campanha **Captação Q3** como referência, com o formulário > **Orçamento — Setembro**. O mesmo vale para adicionar anúncios a um conjunto que já existe. Se você não disser nada sobre formulário, o assistente reaproveita o que o anúncio de referência já usa — que costuma ser o que você quer. ## O que ainda é feito na Meta **Criar um formulário novo.** O assistente lista e usa os formulários que já existem; criar um do zero — escrever as perguntas, apontar a política de privacidade, definir a mensagem de agradecimento — continua sendo feito por você no Gerenciador de Anúncios ou na própria página. **Aceitar os Termos de Geração de Cadastros.** A Meta exige que um administrador da página aceite esses termos antes de qualquer anúncio de cadastro rodar. É um passo único, feito uma vez por página, e só um administrador da página consegue fazer. Se a sua página ainda não aceitou, a Meta recusa a criação e o assistente te avisa com o link para resolver. **Ver os contatos que chegaram.** Os cadastros preenchidos continuam sendo consultados na Meta ou na ferramenta para onde você já os envia. ## Se algo não aparecer - **A lista veio vazia.** A página provavelmente ainda não tem nenhum formulário — crie o primeiro na Meta e peça a lista de novo. - **Falta um formulário que você sabe que existe.** Confirme se ele está na mesma página que o conjunto publica: um formulário de outra página não pode ser usado ali, e a Meta recusa. - **O assistente disse que não conseguiu ler os formulários da página.** Isso é permissão, não configuração sua: significa que a conexão do OneClick Ads com a Meta não alcança essa página. Fale com o suporte. --- # Onboarding guiado por IA Source: https://docs.oneclickads.com.br/pt-br/mcp/onboarding-guiado-com-ia.md > Peça ao seu assistente de IA para conduzir a configuração da sua conta OneClick Ads: ele verifica o que falta, orienta cada etapa (conectar o Meta, ativar o rastreamento, criar a primeira otimização) e confirma a conclusão passo a passo. > Diga **"iniciar onboarding no OneClick Ads"** ao seu assistente de IA e ele > conduz a configuração da sua conta do começo ao fim — verificando sozinho o > que você já concluiu e o que ainda falta. Depois de [conectar um assistente de IA](/pt-br/mcp/conectar-um-assistente-de-ia/) à sua conta, você não precisa descobrir sozinho por onde começar. O assistente consulta o seu **checklist de configuração** — o mesmo que aparece na página de [Conquistas](https://app.oneclickads.com.br/rewards) do app — e passa a agir como um guia pessoal: explica cada etapa, envia o link certo do app, tira dúvidas e confere se deu certo antes de seguir adiante. ## O que o assistente verifica e orienta As etapas centrais da configuração são detectadas **automaticamente**: assim que você conclui uma no app, o assistente enxerga a mudança na conversa seguinte — sem precisar marcar nada como feito. 1. **Conectar sua conta do Meta e habilitar uma conta de anúncios** — essa etapa acontece no app (envolve o login do Facebook no navegador). O assistente envia o link, explica o passo a passo e confirma quando a conta estiver ativa. 2. **Ativar o OneClick Tracking** — o assistente pergunta em qual plataforma você vende (Hotmart, Eduzz, Kiwify, entre outras, incluindo CRMs como Pipedrive ou Kommo) e explica como funciona o rastreamento de conversões. Para a maioria delas, ele já cria a integração por você e devolve as informações que faltam do seu lado; depois, confirma se as conversões estão chegando. 3. **Parametrizar sua primeira otimização** — aqui o assistente pode ir além de orientar: com a sua confirmação, ele mesmo encontra a campanha e cria a otimização por você, em linguagem natural. Além do essencial, o assistente também conhece as demais missões da página de Conquistas — como criar campanhas por replicação, acompanhar o dashboard e plugar o OneClick em mais campanhas — e sugere os próximos passos conforme o seu momento. ## Conquistas e pontos O onboarding guiado e a página de **Conquistas** andam juntos: cada etapa concluída vale pontos e aproxima você dos marcos de recompensa. Como a detecção é automática, os pontos das etapas de configuração são creditados sozinhos — e o assistente comemora com você quando isso acontece. ## Antes de começar - Tenha uma **conta no OneClick Ads** com **assinatura ativa**. - [Conecte o seu assistente de IA](/pt-br/mcp/conectar-um-assistente-de-ia/) (como o Claude) à sua conta. ## Exemplos do que dizer - “Iniciar onboarding no OneClick Ads.” - “O que falta configurar na minha conta?” - “Já conectei minha conta do Meta — o que vem agora?” - “Continuar meu onboarding de onde parei.” - “Quantos pontos eu já tenho nas Conquistas?” O progresso fica salvo na sua conta, não na conversa: você pode parar quando quiser e retomar dias depois, em outro chat ou até em outro assistente, que o guia continua exatamente de onde você parou. --- # Parametrizar e otimizar campanhas com IA Source: https://docs.oneclickads.com.br/pt-br/mcp/operar-campanhas-com-ia.md > Use o Claude, via MCP do OneClick Ads, para operar a camada de otimização do OneClick em linguagem natural: parametrizar otimizações (uma ou várias de uma vez), ajustar custo por conversão, ROAS e orçamento, definir o limite mensal de investimento da conta, ativar e pausar otimizações, reaproveitar o padrão da conta, criar campanhas por replicação e descobrir campanhas ativas ainda sem otimização — sempre com confirmação antes de alterar. > Depois de [conectar um assistente de IA](/pt-br/mcp/conectar-um-assistente-de-ia/), o **Claude** > não só lê seus dados — ele também opera a **camada de otimização do OneClick**: > parametrizar CPA/ROAS/orçamento, ativar e pausar otimizações e até criar campanhas, tudo > pedido em linguagem natural. Enquanto o artigo de [análise de desempenho](/pt-br/mcp/analisar-o-desempenho-com-ia/) cobre o que o Claude **lê**, este cobre o que ele **faz** na otimização por você. São ações de **escrita**: quase todas mudam o comportamento real das suas campanhas na conta — a exceção é marcar uma pendência como resolvida, que só altera o registro do OneClick. :::note[Estrutura no Meta é outro artigo] Aqui o foco é a **camada de otimização do OneClick** (parametrizar CPA/ROAS, ativar otimizações, criar por replicação). Para editar a **estrutura no Meta** — ligar/pausar, mudar orçamento ou renomear campanhas, conjuntos e anúncios — veja [Editar campanhas, conjuntos e anúncios com IA](/pt-br/mcp/editar-campanhas-conjuntos-e-anuncios-com-ia/). ::: :::caution[A escrita altera campanhas de verdade] Ações como parametrizar, ativar, pausar ou criar campanhas têm efeito real na sua conta de anúncios. Conecte com escopo de **escrita** apenas quando for operar, e peça ao assistente que **confirme com você** antes de aplicar mudanças em lote. Você não precisa saber IDs: descreva a campanha pelo nome e o Claude localiza. ::: ## Parametrizar uma campanha Você define os parâmetros de otimização em linguagem natural e o Claude aplica. Os parâmetros que você controla são os mesmos do painel (veja [Como Parametrizar Campanhas](/pt-br/otimizacoes/como-parametrizar-campanhas/)): - **Perfil de otimização** (ex.: Max Performance, Max Escala, Conservador). - **Custo por conversão para pausar** — o teto de CPA que protege a campanha. - **Valor de venda do produto** — a base para o cálculo de ROAS/CPA em campanhas de venda. - **ROAS mínimo** — para os perfis que otimizam por retorno. - **Orçamento diário máximo** — o teto até onde o OneClick pode escalar. Exemplo: _"Claude, parametrize a campanha [nome] no Max Performance com custo por conversão para pausar de R$ 90 e orçamento máximo de R$ 300."_ :::tip[O robô cuida dos detalhes] Campos obrigatórios (como o valor de venda em campanhas de venda) e detalhes técnicos da conta são resolvidos pelo próprio assistente. Se faltar uma informação obrigatória, ele avisa em vez de aplicar algo incompleto. ::: ## Parametrizar várias campanhas de uma vez Você não precisa repetir a ação campanha por campanha. Descreva o **critério** e o Claude aplica em lote — por exemplo, por uma tag no nome, por tipo de orçamento (CBO/ABO) ou com exceções. - _"Claude, reparametrize todas as campanhas ativas com a tag [MX] no nome para custo por conversão de R$ 5,75 e orçamento máximo de R$ 75."_ - _"Claude, ajuste todas as campanhas de venda desta conta para ROAS mínimo 3 e orçamento máximo de R$ 100, **exceto** as que têm 'CALENDLY' no nome."_ - _"Claude, use orçamento máximo de R$ 500 para as campanhas CBO e R$ 250 para as ABO."_ O assistente processa cada campanha de forma independente e te devolve o que deu certo e o que falhou — dá para corrigir só o que ficou pendente. ## Ajustar um parâmetro pontual Não precisa reconfigurar tudo para mudar uma coisa só. - _"Claude, muda só o custo por conversão para pausar da campanha [nome] para R$ 350."_ - _"Claude, sobe o orçamento máximo dessa campanha para R$ 10 mil por dia."_ :::tip[Confirme a unidade] Orçamento máximo é um teto **diário**. Ao pedir um valor alto, confirme se é por dia — o Claude aponta saltos grandes (ex.: 10×) para você validar antes. ::: ## Definir o limite mensal de investimento da conta Além do orçamento de cada campanha, você também pode pedir ao assistente para ajustar o [limite mensal de investimento](/pt-br/otimizacoes/definindo-limite-mensal-de-investimento-da-conta-de-anuncios/) — o teto que vale para a **conta de anúncios inteira**, não para uma campanha específica. - _"Claude, define o limite mensal de investimento desta conta em R$ 30 mil."_ - _"Claude, remove o limite mensal desta conta — deixa a escala ilimitada."_ - _"Claude, qual é o limite mensal configurado nesta conta hoje?"_ :::tip[Um teto, todas as campanhas] Esse limite é por **conta**, não por campanha: funciona como uma trava geral que protege o orçamento combinado com o cliente, mesmo com várias otimizações escalando ao mesmo tempo. ::: ## Ativar, reativar e pausar otimizações - _"Claude, ativa a otimização da campanha [nome]."_ - _"Claude, reativa as otimizações que estão pausadas nas campanhas com a tag [A34]."_ - _"Claude, desativa a otimização da campanha [nome] por enquanto."_ ## Reaproveitar o padrão da conta Quando você cria uma campanha nova e quer manter a coerência com o resto da conta, o Claude consegue **puxar os valores que você já usa** nas outras otimizações ativas e aplicar os mesmos. - _"Claude, parametriza essas campanhas novas usando o mesmo padrão das outras otimizações ativas da conta."_ - _"Claude, qual valor de venda eu costumo usar nesta conta? Aplica ele nas campanhas novas."_ ## Pedir os parâmetros ideais a partir do histórico da conta Em vez de você chutar o custo por conversão ou o ROAS de corte, peça ao Claude para **analisar o histórico da conta e recomendar** os valores — ele olha o custo por conversão (e o ROAS) que os seus anúncios já entregam e sugere um ponto que corta os caros sem sufocar os que performam. - _"Claude, analisa o histórico de custo por conversão desta conta e me sugere um custo por conversão para pausar que corte os caros sem pausar os que já convertem."_ - _"Claude, qual ROAS mínimo faz sentido para esta conta com base no retorno médio dos últimos 90 dias?"_ - _"Claude, me recomenda um orçamento máximo por campanha coerente com o limite mensal desta conta."_ :::tip[Peça a lógica, não só o número] Peça para o assistente **explicar** a recomendação (ex.: "usei o custo por conversão do seu percentil 75") e apresentar uma faixa **conservadora × agressiva**. Assim você decide com contexto, não no escuro. ::: ## Conferir se um parâmetro não vai atrapalhar quem já converte Antes de aplicar um corte de custo por conversão (ou de ROAS) em campanhas **que já rodam**, peça ao Claude para **validar contra o desempenho atual**: ele verifica se o teto que você pensou pausaria anúncios que já estão convertendo — evitando que uma parametrização nova mate os seus vencedores. - _"Claude, antes de aplicar, confere se um custo por conversão para pausar de R$ 150 pausaria anúncios que já convertem nas campanhas [X] e [Y]. Não quero atrapalhá-las."_ - _"Claude, qual o menor custo por conversão para pausar que eu posso usar nesta campanha sem cortar o anúncio que carrega as conversões dela?"_ :::caution[O corte age no que já converte] Se os seus melhores anúncios rodam perto do teto que você definiu, o corte pode pausá-los. O assistente aponta esse risco **antes** de aplicar e sugere um valor com folga — especialmente importante em campanhas maduras que você não quer balançar. ::: ## Criar campanhas novas O Claude também **cria campanhas** para você: replicando uma campanha de referência sua e preenchendo com os seus melhores anúncios, com um criativo novo enviado por link (imagem ou vídeo) e com a copy que você definir — ideal para montar as [Campanhas Validadas](/pt-br/campanhas-validadas/) (formatos como **1-1-10**, **1-4-5**, **1-5-1**, **1-6-3**) sem montar nada na mão. - _"Claude, monta uma Escala Andrômeda (1-1-10) com os meus 10 melhores anúncios dos últimos 90 dias, R$ 100/dia, e sobe **pausada** para eu revisar."_ - _"Claude, cria a campanha com essa imagem [link] em todos os anúncios."_ O guia completo — estrutura, orçamento, escolha de criativos e como definir a copy, com prompts prontos — está em [Criando novas campanhas com IA](/pt-br/mcp/criando-novas-campanhas/). ## Auditar cobertura e padronização das campanhas ativas Dois casos comuns de manutenção: achar o que está rodando no Gerenciador mas **fora** do controle do OneClick, e conferir se as campanhas otimizadas seguem o **mesmo padrão**. - _"Claude, lista as campanhas ativas no Gerenciador desta conta que ainda não estão otimizadas no OneClick."_ - _"Claude, dessas, parametriza as de conversão com o padrão da conta."_ - _"Claude, tem alguma campanha ativa gastando sem estar sob o OneClick?"_ - _"Claude, confere se todas as campanhas ativas (menos as de rastreamento) estão no mesmo perfil e no mesmo custo por conversão, e me mostra as que fugiram do padrão."_ - _"Claude, alinha as que estiverem fora para o perfil Max Performance com custo por conversão de R$ 150 e orçamento máximo de R$ 500."_ ## Acompanhar as decisões da automação Operar com IA também é ter **transparência e controle**: a qualquer momento você pergunta o que a otimização do OneClick fez pelas suas campanhas e por quê — para seguir os próximos passos com tranquilidade. - _"Claude, o que o OneClick fez hoje na campanha [nome]?"_ - _"Claude, me mostra o histórico de ações da otimização da campanha [nome] nas últimas 24 horas."_ - _"Claude, essa campanha está escalando ou estabilizada agora? O que explica isso?"_ - _"Claude, a campanha [nome] já chegou no orçamento diário máximo que eu configurei?"_ - _"Claude, quais estruturas a otimização pausou ou escalou recentemente e com base em qual métrica?"_ ### Manter o marcador de status no nome A otimização ativa aparece no nome da campanha com o marcador **🤖 [OneClick ON]** (e **🤖 [OneClick OFF]** quando está desligada). Esse texto é personalizável — veja [Personalizando a Tag de Otimização](/pt-br/otimizacoes/personalizando-a-tag-de-otimizacao/). Se ele se perder numa edição manual do nome, peça para a IA repor: - _"Claude, reaplica o marcador 🤖 [OneClick ON] nas campanhas que estão com otimização ativa e ativas na Meta."_ - _"Claude, quais campanhas ativas estão com otimização ligada mas sem o marcador de status no nome? Corrige preservando o resto do nome."_ ## Avisar que você resolveu uma pendência Quando a Meta exige uma ação sua para liberar uma otimização — aceitar um termo de uso, repor uma peça de anúncio removida, regularizar um pagamento —, o OneClick Ads para de tentar aquela alteração e lista a pendência (veja [o que está travando as otimizações agora](/pt-br/mcp/analisar-o-desempenho-com-ia/)). Ele só a remove da lista quando **percebe sozinho** que o bloqueio saiu, o que pode levar até a próxima vez que a otimização tentar aquela ação. Se você já resolveu do lado da Meta e não quer esperar, é só dizer: - _"Claude, já aceitei os termos de cadastro da página. Marca essa pendência como resolvida."_ - _"Claude, resolvi o pagamento da conta e reconectei o Meta. Marca as duas pendências como resolvidas."_ - _"Claude, lista o que está pendente e marca como resolvido tudo que eu já arrumei."_ O Claude marca quantas pendências você indicar de uma vez, e a partir daí o OneClick volta a tentar as alterações que estavam paradas. Uma por uma, também dá para fazer isso no painel, em **Ações pendentes** — veja [Acesso e status da conta de anúncios](/pt-br/meta/acesso-e-status-da-conta-de-anuncios/#já-resolveu-avise). :::tip[Marcar não é consertar] Marcar como resolvido só avisa o OneClick para tentar de novo — ele **acredita em você**, não confere na Meta. Se o bloqueio não tinha sido resolvido de verdade, a próxima tentativa encontra o mesmo problema e a pendência volta para a lista. Nada se perde: você só a verá reaparecer. ::: ## Boas práticas ao operar por IA - **Comece pela leitura, opere depois.** Valide os dados com perguntas de análise antes de pedir alterações. - **Peça confirmação em lote.** Antes de aplicar em muitas campanhas, peça um resumo do que será alterado. - **Prefira 'pausada' ao criar.** Revise no Gerenciador antes de ativar. - **Descreva pelo nome.** Você nunca precisa de IDs — nome, tag ou critério bastam. --- # Prompts prontos para operar campanhas Source: https://docs.oneclickads.com.br/pt-br/mcp/prompts-para-operar-campanhas.md > Comandos prontos para pedir ao Claude, via MCP do OneClick Ads, e operar suas campanhas: parametrizar uma ou várias otimizações, ajustar custo por conversão, ROAS e orçamento, ativar e pausar, reaproveitar o padrão da conta, criar campanhas por replicação (1-5-2) e encontrar campanhas ativas sem otimização. > Comandos prontos para **operar** suas campanhas pelo Claude via MCP — o complemento de > ação das [50 perguntas de análise](/pt-br/mcp/analisar-o-desempenho-com-ia/). Copie, cole e adapte. Estes prompts **executam ações** na sua conta. Veja o guia [Parametrizar e otimizar campanhas com IA](/pt-br/mcp/operar-campanhas-com-ia/) para o contexto de cada uma. Para editar a estrutura no Meta (ligar/pausar, orçamento, renomear), veja [Editar campanhas, conjuntos e anúncios com IA](/pt-br/mcp/editar-campanhas-conjuntos-e-anuncios-com-ia/). :::caution[São ações de escrita] Estes comandos alteram campanhas de verdade. Use com o escopo de **escrita** e peça confirmação antes de aplicar mudanças em lote. Substitua os trechos entre colchetes — como `[nome da campanha]` — pelo nome real. Você não precisa saber IDs. ::: ## Parametrizar uma campanha 1. "Claude, parametrize a campanha [nome] no Max Performance com custo por conversão para pausar de R$ 90 e orçamento máximo de R$ 300." 2. "Claude, coloca a campanha [nome] no perfil Conservador com ROAS mínimo 3 e valor de venda de R$ 197." 3. "Claude, qual a parametrização atual da campanha [nome]?" 4. "Claude, parametriza a campanha [nome] no Max Escala usando o padrão da conta." ## Parametrizar várias de uma vez 5. "Claude, reparametrize todas as campanhas ativas com a tag [MX] no nome para custo por conversão de R$ 5,75 e orçamento máximo de R$ 75." 6. "Claude, ajusta todas as campanhas de venda para ROAS mínimo 3 e orçamento máximo de R$ 100, exceto as que têm 'CALENDLY' no nome." 7. "Claude, usa orçamento máximo de R$ 500 nas campanhas CBO e R$ 250 nas ABO." 8. "Claude, pega as campanhas com a tag [A34] e coloca todas em custo por conversão de R$ 110." ## Ajustar um parâmetro pontual 9. "Claude, muda só o custo por conversão para pausar da campanha [nome] para R$ 350." 10. "Claude, sobe o orçamento máximo da campanha [nome] para R$ 10 mil por dia." 11. "Claude, reduz o orçamento máximo dessa campanha para R$ 500." ## Ativar, reativar e pausar 12. "Claude, ativa a otimização da campanha [nome]." 13. "Claude, reativa as otimizações pausadas das campanhas com a tag [A34]." 14. "Claude, desativa a otimização da campanha [nome] por enquanto." ## Reaproveitar o padrão da conta 15. "Claude, qual valor de venda eu costumo usar nesta conta?" 16. "Claude, parametriza essas campanhas novas com o mesmo padrão das outras otimizações ativas da conta." ## Criar campanha por replicação (a partir dos melhores anúncios) Mais prompts de criação — criativo novo por link, copy, variações de título — em [Criando novas campanhas com IA](/pt-br/mcp/criando-novas-campanhas/). 17. "Claude, monta uma Escala Andrômeda (1-1-10) com os meus 10 melhores anúncios dos últimos 90 dias, CBO com R$ 100/dia, e sobe pausada." 18. "Claude, cria uma campanha no formato 1-5-1 com o meu melhor anúncio replicado em 5 conjuntos idênticos, CBO com R$ 100/dia, e sobe pausada." 19. "Claude, distribui os meus 20 melhores criativos em 4 conjuntos de 5 (formato 1-4-5) com o meu melhor público como referência." 20. "Claude, os melhores anúncios são por retorno ou por volume? Consolida por criativo antes de escolher." 21. "Claude, já concluiu a criação das campanhas que pedi? Me avisa se alguma falhou — e reenvia se der erro momentâneo da Meta." ## Recomendar e validar parâmetros 22. "Claude, analisa o histórico de custo por conversão desta conta e me sugere um custo por conversão para pausar que corte os caros sem pausar os que já convertem." 23. "Claude, qual ROAS mínimo faz sentido para esta conta com base no retorno médio dos últimos 90 dias?" 24. "Claude, antes de aplicar, confere se um custo por conversão para pausar de R$ 150 pausaria anúncios que já convertem nas campanhas [X] e [Y]." 25. "Claude, qual o menor custo por conversão para pausar que eu posso usar nesta campanha sem cortar o anúncio que carrega as conversões dela?" ## Encontrar e cobrir lacunas 26. "Claude, lista em tabela as campanhas ativas no Gerenciador que ainda não estão otimizadas no OneClick." 27. "Claude, dessas campanhas sem otimização, parametriza as de conversão com o padrão da conta." 28. "Claude, tem alguma campanha ativa gastando sem estar sob o OneClick?" 29. "Claude, confere se todas as campanhas ativas (menos as de rastreamento) estão no mesmo perfil e custo por conversão, e me mostra as que fugiram do padrão." 30. "Claude, alinha as que estiverem fora para o perfil Max Performance com custo por conversão de R$ 150 e orçamento máximo de R$ 500." --- # Meta — Contas de Anúncios Source: https://docs.oneclickads.com.br/pt-br/meta.md > Guias para vincular e gerenciar contas de anúncios da Meta (Facebook Ads) no OneClick Ads: passo a passo de vinculação via Business Manager e configurações de conta. Guias para conectar e configurar suas contas de anúncios da Meta no OneClick Ads. ## Artigos - [Vinculação de uma nova Conta de Anúncios](/pt-br/meta/vinculacao-de-uma-nova-conta-de-anuncios/) - [Acesso e Status da Conta de Anúncios](/pt-br/meta/acesso-e-status-da-conta-de-anuncios/) - [Contas de Anúncios em mais de um usuário](/pt-br/meta/contas-de-anuncios-em-mais-de-um-usuario/) - [Criando e duplicando campanhas](/pt-br/meta/criando-e-duplicando-campanhas/) - [Gerenciador de Anúncios](/pt-br/meta/gerenciador-de-anuncios/) --- # Acesso e Status da Conta de Anúncios Source: https://docs.oneclickads.com.br/pt-br/meta/acesso-e-status-da-conta-de-anuncios.md > Entenda como o OneClick Ads acompanha o acesso e o status das suas contas de anúncios da Meta, por que às vezes pedimos para reconectar ou ajustar permissões no Business Manager, e por que você pode ativar uma conta mas ainda precisar regularizar o acesso para ativar otimizações. > Entenda quando o OneClick Ads consegue operar sua conta de anúncios e o que fazer quando algo precisa da sua atenção. Para otimizar suas campanhas, o OneClick Ads precisa de uma conexão saudável com a sua conta de anúncios da Meta. Esta página explica as situações que podem aparecer no painel de **Contas de Anúncio** e o que fazer em cada uma. --- ## O que o OneClick Ads acompanha Existem três coisas diferentes — e independentes — que definem se conseguimos trabalhar na sua conta: ### 1. O nosso acesso à sua conta É a conexão entre o OneClick Ads e a Meta. Quando está tudo certo, conseguimos ler os dados e gerenciar as campanhas normalmente. Dois problemas podem aparecer aqui: - **Perdemos o acesso à conta.** Normalmente acontece quando a conexão com a Meta expirou ou foi revogada. Nesse caso, a solução é **reconectar sua conta Meta**. - **Não temos permissão para gerenciar campanhas.** Conseguimos ler os dados, mas a Meta bloqueia qualquer alteração. Isso acontece quando o perfil conectado não tem o papel de **gerenciar campanhas** na conta dentro do **Business Manager**. Aqui, **reconectar não resolve** — é preciso conceder o acesso de gerenciamento no Business Manager. Feito isso, **você não precisa fazer mais nada**: o OneClick Ads confere a permissão periodicamente e libera a conta sozinho quando encontra o acesso. ### 2. O status da conta no próprio Meta É a situação da conta dentro da Meta, independente do OneClick Ads. A conta pode estar ativa, com **pagamento pendente**, em análise ou desativada pela Meta. Esses casos se resolvem **do lado da Meta** (por exemplo, regularizando o pagamento ou recorrendo de uma desativação) — reconectar ou ajustar permissões no OneClick Ads não muda esse status. ### 3. Se a conta está ativada no OneClick Ads É a sua escolha de usar (ou não) o OneClick Ads naquela conta. Você liga e desliga isso pelo botão verde no painel de **Contas de Anúncio**. --- ## Ativar a conta x ativar otimizações Essa é a distinção mais importante: - **Ativar a conta de anúncios sempre é possível.** Mesmo que haja um problema de acesso, você pode ativar a conta no OneClick Ads. Isso deixa a conta pronta e visível no painel, com o aviso do que precisa ser regularizado — para que você possa resolver a permissão com calma, sem ficar travado logo no início. - **Ativar otimizações exige acesso saudável.** As otimizações fazem alterações reais nas suas campanhas (ajustes de orçamento, pausas, escalas). Por isso, enquanto houver um problema de acesso, não é possível ativar otimizações naquela conta. Regularize o acesso primeiro e, em seguida, ative as otimizações normalmente. Em resumo: a conta pode ficar ativa mesmo com um aviso de acesso, mas as otimizações só entram em ação quando a conexão está totalmente saudável. --- ## O que fazer em cada aviso | Aviso no painel | O que significa | Como resolver | | -------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | | Perdemos o acesso à conta | A conexão com a Meta expirou ou foi revogada | Reconecte sua conta Meta | | Sem permissão para gerenciar campanhas | O perfil conectado não pode alterar campanhas | Conceda o acesso de gerenciar campanhas no Business Manager — reconectar não resolve, e o aviso sai sozinho depois | | Conta com problema no Meta | A conta está com pendência, em análise ou desativada na Meta | Regularize a situação diretamente no Gerenciador de Anúncios da Meta | --- ## Quando algo pontual trava só uma ação da otimização Além dos três pontos acima — que afetam a conta de anúncios inteira — existem situações mais específicas: uma configuração pendente em um anúncio, um conjunto ou a própria conta que impede só **uma ação pontual** da otimização (por exemplo, um termo de uso que a Meta pede para aceitar, ou uma peça de anúncio removida). Nesses casos, o restante da conta continua funcionando normalmente — só aquela ação específica fica parada até você resolver o que a Meta está pedindo. Quando isso acontece, você recebe uma **notificação** (por e-mail e WhatsApp, conforme suas preferências em [Notificações](/pt-br/notifications/)) explicando o que precisa da sua atenção. Você não precisa reconectar a conta nem mexer em mais nada: assim que a pendência é resolvida do lado da Meta, o OneClick Ads percebe sozinho e a otimização volta a atuar normalmente. Enquanto a pendência continuar impedindo ações reais na conta, você recebe um lembrete resumindo a situação uma vez por dia — assim que ela é resolvida, os lembretes param. ### Onde ver tudo o que está pendente O menu **Ações pendentes**, no painel, lista todas as pendências abertas das suas contas de anúncios — agrupadas por conta, com o item bloqueado (uma página, um anúncio, a própria conta), o que a Meta está pedindo, desde quando o bloqueio existe e um link direto para o lugar certo no Gerenciador de Anúncios. Se a lista estiver vazia, não há nada travando as otimizações no momento. ### Já resolveu? Avise Esse "perceber sozinho" acontece na próxima vez que a otimização tentar aquela ação — ou seja, pode levar um tempo. **Se você já resolveu e não quer esperar, pode avisar** — e o OneClick volta a tentar em seguida. Há dois caminhos: - **No painel**, em **Ações pendentes**: o botão **Resolvido** na linha da pendência. - **Por um assistente de IA conectado**, que também consegue avisar várias de uma vez — [Parametrizar e otimizar campanhas com IA](/pt-br/mcp/operar-campanhas-com-ia/#avisar-que-você-resolveu-uma-pendência). Para só consultar o que está pendente, veja [Analisar o desempenho com IA](/pt-br/mcp/analisar-o-desempenho-com-ia/). Avisar não é o mesmo que consertar: o OneClick acredita em você e simplesmente tenta de novo. Se o bloqueio ainda existir, a pendência reaparece na tentativa seguinte. --- ## Dicas importantes - Ao abrir o painel de **Contas de Anúncio**, o OneClick Ads busca o status mais recente direto na Meta — se você acabou de resolver algo do lado da Meta, não precisa esperar a próxima sincronização automática para ver o painel atualizado. - O aviso continua visível até que a **causa** seja resolvida. Quando o problema é de **permissão** no Business Manager, reconectar não faz o aviso sair: o que resolve é conceder o papel de gerenciar campanhas. - Depois de conceder o acesso no Business Manager, o aviso sai **por conta própria**. Conferimos a permissão de tempo em tempo, então pode levar algumas horas até a conta voltar a aparecer como saudável. As otimizações que **já estavam ativas** voltam a rodar no ciclo seguinte, sem precisar reativá-las. - Se você tiver várias contas na mesma Business Manager, garanta que o perfil conectado tenha o papel de gerenciar campanhas em **todas** elas. --- # Contas de Anúncios em mais de um usuário Source: https://docs.oneclickads.com.br/pt-br/meta/contas-de-anuncios-em-mais-de-um-usuario.md > No OneClick Ads, cada e-mail é um usuário e uma conta de anúncios pertence a um usuário por vez. Entenda por que uma conta pode não aparecer e como transferi-la de um usuário para outro. > Uma conta de anúncios pertence a um usuário por vez. Entenda a regra e como transferi-la. No OneClick Ads, **cada e-mail é um usuário**, com o seu próprio plano, as suas contas de anúncios e as suas otimizações. O mesmo perfil da Meta pode ser conectado em mais de um usuário — é comum ter um usuário por cliente ou por sócio. Mas a conta de anúncios na Meta é **uma só**, então ela pertence a **um usuário por vez**. --- ## Quem ativa fica com a conta O usuário que ligar o botão **"Usar conta de anúncios"** passa a ser o dono dela. A partir daí, a conta e as suas otimizações aparecem **só** para esse usuário, e contam no limite do plano **dele**. Enquanto a conta estiver ativada, nenhum outro usuário consegue tomá-la — nem conectando o mesmo perfil da Meta de novo. Isso evita que uma conta em operação mude de lugar sozinha. **Se uma conta não aparece para você**, quase sempre é porque está ativada em outro usuário seu. Não é erro de vinculação, e reconectar a Meta não vai trazê-la: é preciso transferir. --- ## Como transferir uma conta entre usuários São três passos, e **a ordem importa**. 1. **Desative a conta no usuário atual.** Em **Contas de Anúncios**, desligue o botão **"Usar conta de anúncios"**. 2. **Entre com o outro usuário e abra a tela de Contas de Anúncios.** A conta só aparece depois que essa tela atualiza a lista junto à Meta. Se você já estava com ela aberta, **recarregue a página**. 3. **Ative a conta.** Ligue o botão **"Usar conta de anúncios"**. Pronto — a conta agora é desse usuário. :::caution Não tente ativar no novo usuário antes de desativar no antigo: enquanto estiver ativada, a conta nem aparece para o outro. ::: As otimizações **não são pausadas** durante a transferência — elas acompanham a conta e reaparecem no passo 3 com as mesmas configurações. --- ## Limite de contas do plano Cada plano define quantas contas de anúncios podem ficar **ativas ao mesmo tempo**. O plano é de cada usuário, então o limite também é: ter dois usuários **não soma** os limites. - **Se o plano do usuário de destino já estiver cheio**, o passo 3 não conclui e avisamos que você atingiu o máximo de contas ativas. Desative outra conta nesse usuário, ou mude de plano, antes de transferir. - **Reduzir o plano não desativa contas automaticamente.** As contas continuam como estão, mas você fica impedido de **ativar novas otimizações** até desativar contas suficientes. --- ## Dicas - Para saber a qual usuário a conta pertence, veja em qual painel ela aparece. - Mantenha cada conta no usuário em que você acompanha os resultados dela. - Se a conta não aparecer em **nenhum** usuário seu, o caso é de vinculação ou de acesso — veja [Vinculação de uma nova Conta de Anúncios](/pt-br/meta/vinculacao-de-uma-nova-conta-de-anuncios/) e [Acesso e Status da Conta de Anúncios](/pt-br/meta/acesso-e-status-da-conta-de-anuncios/). --- # Criando e duplicando campanhas Source: https://docs.oneclickads.com.br/pt-br/meta/criando-e-duplicando-campanhas.md > Como criar uma campanha nova direto no painel do OneClick Ads: duplicando uma campanha de referência, escolhendo estrutura, criativos e orçamento, em um passo a passo guiado. > No menu **Criar Campanha**, você monta uma campanha nova a partir de uma campanha que já > existe na sua conta — sem sair do OneClick Ads. ## Como funciona A criação funciona por **duplicação**: você escolhe uma campanha de referência que já existe na sua conta de anúncios, e o OneClick Ads monta a nova campanha a partir dela — herdando público, segmentação, objetivo e demais configurações já validadas. O que muda é o que você define no passo a passo: quantos conjuntos de anúncios, quantos anúncios em cada um, quais criativos usar e qual orçamento. :::note[Mesmo tipo de orçamento da referência] A campanha nova nasce com o mesmo tipo de orçamento da referência: se ela é CBO (orçamento no nível da campanha), a nova também é; se é ABO (orçamento por conjunto), a nova também é. Escolha uma referência do tipo de orçamento que você quer replicar. ::: ## O passo a passo 1. **Destino** — escolha se os conjuntos de anúncios copiados vão criar uma **campanha nova** ou ser adicionados a uma **campanha já existente e em veiculação** (veja a seção abaixo). 2. **Referência** — escolha, entre as campanhas já existentes na conta de anúncios selecionada, qual vai servir de molde (se o destino é uma campanha nova) ou qual vai receber os conjuntos copiados (se o destino é uma campanha existente). 3. **Estrutura** — defina quantos conjuntos de anúncios vão ser copiados e quantos anúncios em cada conjunto. 4. **Criativos** — para cada conjunto, escolha como os anúncios vão ser montados (veja as opções abaixo) e revise nome, texto, título, descrição, botão e link de cada um. 5. **Publicação** — se o destino é uma campanha nova, dê um nome a ela e escolha se sobe **ativa** ou **pausada**; se o destino é uma campanha existente, escolha se os conjuntos adicionados sobem **ativos** ou **pausados**. 6. **Acompanhamento** — a criação roda em segundo plano; esta tela mostra o progresso e avisa quando termina (ou se algum anúncio falhou). :::caution[Sempre revise antes de ativar] Recomendamos sempre subir pausado e revisar tudo no Gerenciador de Anúncios da Meta antes de ativar — assim nenhum centavo é gasto antes da sua conferência. ::: ## Para onde vão os conjuntos copiados Na etapa de Destino, você escolhe entre duas opções: - **Criar uma campanha nova** — uma campanha nova é criada do zero e recebe os conjuntos de anúncios copiados da campanha de referência. É o comportamento descrito no restante desta página. - **Adicionar a uma campanha que já existe** — nenhuma campanha nova é criada: os conjuntos de anúncios copiados entram em uma campanha que já está na sua conta. Nesse caso, a campanha escolhida na etapa de Referência é a própria campanha de destino, e a etapa de Estrutura só define quantos conjuntos e anúncios serão adicionados a ela. :::caution[Atenção ao adicionar em uma campanha já ativa] Se a campanha de destino já estiver **ativa**, os conjuntos adicionados podem começar a veicular imediatamente, de acordo com o status escolhido na Publicação. E se ela usa **orçamento otimizado (CBO)**, adicionar novos conjuntos redistribui o orçamento já em uso pelos conjuntos existentes. ::: ## Escolhendo os criativos de cada conjunto Na etapa de Criativos, cada anúncio pode ser montado de três formas — e você pode misturá-las dentro da mesma campanha: - **Enviar um arquivo novo** — upload de uma imagem ou vídeo direto do seu computador. - **Criativos da campanha de referência** — reaproveita um anúncio que já roda na campanha escolhida como molde. - **Criativos de outra campanha** — escolhe uma campanha diferente da conta e reutiliza um criativo dela. Ao reaproveitar um criativo existente, os campos de texto, título, descrição, botão e link vêm preenchidos com os valores do anúncio original — você só edita o que quiser mudar; deixar um campo em branco mantém o valor original. ## Depois de pedir a criação - A criação roda em segundo plano: você acompanha o progresso na própria tela, sem precisar esperar parado. - Se algum anúncio falhar no meio do caminho, o OneClick Ads desfaz a criação parcial — você nunca fica com uma campanha pela metade, nem com conjuntos incompletos numa campanha existente. - Em alguns casos, a Meta não deixa duplicar um conjunto de anúncios mantendo a mesma janela de atribuição da referência. Quando isso acontece, o OneClick Ads recria o conjunto do zero automaticamente, reaproveitando o restante da configuração, e a tela de acompanhamento avisa que aquele conjunto foi recriado — junto com a janela de atribuição que a Meta aplicou no lugar da original. - Depois de revisar e ativar a campanha (ou os conjuntos adicionados), configure a otimização automática — veja [Como Parametrizar Campanhas](/pt-br/otimizacoes/como-parametrizar-campanhas/). ## Prefere pedir em linguagem natural? Se você usa um assistente de IA conectado ao OneClick Ads, também é possível criar a campanha descrevendo o que você quer em uma conversa, incluindo formatos das [Campanhas Validadas](/pt-br/campanhas-validadas/) pelo nome. Veja [Criando novas campanhas com IA](/pt-br/mcp/criando-novas-campanhas/). --- # Gerenciador de Anúncios Source: https://docs.oneclickads.com.br/pt-br/meta/gerenciador-de-anuncios.md > Veja suas campanhas, conjuntos de anúncios e anúncios da Meta em tabelas dentro do OneClick Ads: acompanhe performance, ligue, pause, renomeie e edite o orçamento diário sem abrir o Gerenciador de Anúncios da Meta. > O **Gerenciador de Anúncios** do OneClick Ads mostra suas campanhas, conjuntos de anúncios e > anúncios da Meta em tabelas, com métricas de performance, direto no painel — para o dia a > dia, sem precisar abrir o Gerenciador de Anúncios da própria Meta. ## Onde encontrar No menu lateral de cada conta de anúncios, acesse **Gerenciador de Anúncios**. ## Uma tabela só, do jeito que a Meta organiza A lista começa pelas campanhas. Clique para **expandir uma campanha** e ver seus conjuntos de anúncios logo abaixo, na mesma tabela — sem abrir outra tela. Expanda um conjunto de anúncios do mesmo jeito para ver os anúncios dentro dele. Em qualquer um dos três níveis (campanha, conjunto ou anúncio), você acompanha métricas de performance (investimento, resultados, custo por resultado, orçamento diário, entre outras) para o período que escolher — um atalho como **Hoje** ou **Ontem**, ou qualquer intervalo de datas no calendário. ## De onde vêm as métricas As métricas de cada linha vêm direto da Meta, atualizadas para o período que você escolher. Quando a Meta não consegue responder alguma métrica na hora, o OneClick Ads mostra o último valor salvo daquele campo, para que a tabela nunca fique com uma célula vazia. ## O que você pode fazer direto na tabela - **Ligar e pausar** — ative ou pause uma campanha, conjunto ou anúncio direto na linha da tabela, em qualquer um dos três níveis. - **Renomear** — edite o nome direto na tabela, em qualquer um dos três níveis; a mudança é aplicada na sua conta da Meta. - **Editar o orçamento diário** — clique no valor da coluna "Orçamento Diário" (ícone de lápis) para editá-lo direto na tabela, em campanhas e conjuntos de anúncios. Aperte **Enter** ou clique no ícone de confirmação para salvar; clicar fora ou apertar **Esc** cancela sem salvar. A edição só aparece quando aquele nível tem orçamento próprio — não é possível editá-lo, por exemplo, no nível de um conjunto de anúncios cujo orçamento é definido pela campanha (CBO). - **Personalizar as colunas** — as colunas padrão seguem o mesmo formato do Gerenciador de Anúncios da própria Meta (nome, status, orçamento diário, gasto, conversões, CPA, entre outras); pelo menu de gerenciamento de colunas você escolhe outras métricas para exibir e em qual ordem, incluindo as métricas do OneClick Tracking — que aparecem com um destaque visual próprio, para diferenciá-las das métricas padrão da Meta. - **Criar uma campanha nova** — o botão de criação leva direto para o fluxo de [Criando e duplicando campanhas](/pt-br/meta/criando-e-duplicando-campanhas/). - **Abrir a otimização da campanha** — na linha de cada campanha, o botão de atalho "Relatório de Inteligência" abre a mesma central de otimização automática usada na tela de [Otimizações](/pt-br/otimizacoes/como-parametrizar-campanhas/), já focada naquela campanha. :::tip[Primeira vez usando?] Um tour guiado aparece na primeira visita, mostrando onde estão as principais ações da tabela. ::: ## Diferença para o Gerenciador de Anúncios da Meta O Gerenciador de Anúncios do OneClick Ads não substitui todas as funções do Gerenciador da Meta — ele foi feito para o que você mais faz no dia a dia: acompanhar performance, ligar/pausar e renomear. Para ações mais avançadas de configuração (criativos, estrutura de orçamento), use o Gerenciador da própria Meta ou o menu [Criar Campanha](/pt-br/meta/criando-e-duplicando-campanhas/) do OneClick Ads. Uma parte dessa configuração já dá para resolver **conversando**: com um [assistente de IA conectado](/pt-br/mcp/conectar-um-assistente-de-ia/), você consulta como um conjunto está configurado, descobre por que um anúncio foi reprovado pela Meta e ajusta o **público** do conjunto — localização, idade, gênero e públicos personalizados. Veja [Editar campanhas, conjuntos e anúncios com IA](/pt-br/mcp/editar-campanhas-conjuntos-e-anuncios-com-ia/). ## Próximos passos - Veja como [criar e duplicar campanhas](/pt-br/meta/criando-e-duplicando-campanhas/) direto do OneClick Ads. - Configure a [otimização automática](/pt-br/otimizacoes/como-parametrizar-campanhas/) para suas campanhas. --- # Vinculação de uma nova Conta de Anúncios Source: https://docs.oneclickads.com.br/pt-br/meta/vinculacao-de-uma-nova-conta-de-anuncios.md > Passo a passo para vincular uma conta de anúncios da Meta (Facebook Ads) ao OneClick Ads: acesso ao Business Manager, autorização e ativação das contas importadas. > Aprenda a vincular contas de anúncios ao OneClick Ads. Neste guia, você vai aprender como fazer a vinculação correta das suas contas de anúncios ao OneClick Ads. --- ## Passo a passo para vincular contas de anúncio - No menu lateral, vá até **Contas de Anúncio**. - Clique no botão verde **"Vincular nova conta de anúncios"**. - Uma janela da **Meta (Facebook)** será aberta. - Faça login com o seu perfil que tem acesso às BMs desejadas. - A Meta mostrará todas as páginas do facebook. - Escolha a opção **"Todas as páginas"** e avance. - Em seguida, a Meta mostrará todos os **Business Managers (BMs)** às quais você tem acesso. - Escolha **todas as BMs** que deseja plugar no OneClick Ads e avance. - Clique em "Concluir" e finalize o processo. - Aguarde até que as contas de anúncios das BMs escolhidas serão automaticamente importadas. A conta estará listada no painel do OneClick Ads, e você precisará ativá-la no botão verde para começar. --- ## Dicas importantes - Sempre selecione **todas as contas de anúncio da BM** durante o processo. - A fanpage precisa **pertencer à BM selecionada** na vinculação. - Se for necessário, refaça o processo usando a **BM correta** e compartilhe os ativos via **parceiro**. - Se você usa **mais de um usuário** no OneClick Ads e uma conta não aparece depois da vinculação, ela provavelmente está ativada em outro usuário seu. Veja [Contas de Anúncios em mais de um usuário](/pt-br/meta/contas-de-anuncios-em-mais-de-um-usuario/). --- # Notificações — OneClick Ads Source: https://docs.oneclickads.com.br/pt-br/notifications.md > Saiba como o OneClick Ads envia notificações automáticas sobre o desempenho e os limites das suas campanhas. Entenda os canais disponíveis e como configurá-los. O OneClick Ads envia notificações automáticas para mantê-lo informado sobre eventos importantes das suas campanhas — como alertas de orçamento e bloqueios de escala. As notificações são entregues pelos canais configurados no seu perfil. ## Escolhendo o que você recebe Na aba **Notificações** do seu perfil de usuário, você encontra as notificações agrupadas por categoria (por exemplo, as relacionadas às suas **Otimizações**) e pode ativar ou desativar, para cada notificação, o envio por WhatsApp e por e-mail de forma independente. ## Ajustando pelo assistente de IA Se você [conecta um assistente de IA](/pt-br/mcp/conectar-um-assistente-de-ia/) com escopo de escrita, também pode pedir para ele ajustar suas preferências de notificação em linguagem natural, sem precisar abrir o painel: - _"Claude, desativa as notificações de otimização no WhatsApp."_ - _"Claude, quais categorias de notificação eu tenho ativadas hoje?"_ - _"Claude, ativa de novo as notificações de limite mensal de investimento."_ ## Canais disponíveis ### WhatsApp Para receber notificações via WhatsApp, no menu lateral clique em **WhatsApp** (seção **Notificações**), insira seu número de WhatsApp no campo correspondente e clique em **Salvar**. Veja [Canais de Notificação: WhatsApp](/pt-br/notifications/canais-whatsapp/) para o passo a passo completo, incluindo a confirmação pedida antes de os alertas começarem a chegar. > Você pode alterar ou remover o número a qualquer momento pelo mesmo painel de perfil. ### E-mail Você também recebe notificações por e-mail, automaticamente, no endereço cadastrado na sua conta OneClick Ads — não é preciso nenhuma configuração adicional. Na aba **Notificações**, cada notificação tem um controle próprio para o canal de e-mail, independente do WhatsApp. ## Artigos - [Canais de Notificação: WhatsApp](/pt-br/notifications/canais-whatsapp/) --- # Canal de Notificação: WhatsApp Source: https://docs.oneclickads.com.br/pt-br/notifications/canais-whatsapp.md > Como configurar o WhatsApp como canal de notificação no OneClick Ads para receber alertas automáticos sobre suas campanhas. > Receba alertas automáticos do OneClick Ads diretamente no seu WhatsApp. O canal WhatsApp permite que o OneClick Ads envie notificações em tempo real sobre eventos relevantes das suas campanhas, como alertas de limite de orçamento e bloqueios de escala. --- ## Como habilitar 1. No menu lateral, na seção **Notificações**, clique em **WhatsApp**. 2. No campo **WhatsApp**, insira seu número com o código do país (ex: +55 11 99999-9999). 3. Clique em **Salvar**. 4. Quando o OneClick Ads tiver a primeira notificação para te enviar, você receberá uma mensagem de confirmação no WhatsApp perguntando se deseja receber os alertas ("Sim, enviar" / "Agora não") — não é uma mensagem instantânea ao salvar o número. As notificações só começam a chegar depois que você confirmar. :::note[A confirmação expira e é pedida de novo] Essa confirmação vale por um período limitado. Passado esse tempo, o OneClick Ads envia uma nova mensagem de confirmação antes de continuar entregando alertas — é só confirmar novamente para manter o canal ativo. ::: --- ## Como desabilitar ou alterar - Para **alterar o número**, basta editar o campo e salvar novamente — a confirmação de recebimento será pedida de novo para o número atualizado. - Para **desabilitar** as notificações via WhatsApp, remova o número do campo e salve, ou simplesmente responda "Agora não" na mensagem de confirmação. --- ## Notificações enviadas via WhatsApp As notificações enviadas por este canal estão listadas nos módulos de cada funcionalidade. Consulte: - [OneClick Budget — Notificações de Limite Mensal](/pt-br/oneclick-budget/notificacoes-limite-mensal-de-investimento/) - [Relatório de Inteligência Diária](/pt-br/otimizacoes/relatorio-de-inteligencia-diaria/) — resumo diário do que a inteligência do OneClick Ads fez pelas suas campanhas. --- # OneClick Budget — Controle de Orçamento de Campanhas Source: https://docs.oneclickads.com.br/pt-br/oneclick-budget.md > Gerencie o orçamento mensal das suas contas de anúncios no OneClick Ads: defina limites, receba alertas automáticos e entenda como o sistema bloqueia escalas quando o teto é atingido. Guias sobre o controle de orçamento mensal de contas de anúncios no OneClick Ads. ## Artigos - [Notificações de Limite Mensal de Investimento](/pt-br/oneclick-budget/notificacoes-limite-mensal-de-investimento/) --- # Notificações de Limite Mensal de Investimento Source: https://docs.oneclickads.com.br/pt-br/oneclick-budget/notificacoes-limite-mensal-de-investimento.md > Entenda as notificações automáticas enviadas pelo OneClick Ads quando o gasto mensal se aproxima ou ultrapassa o limite configurado na conta de anúncios. > Receba alertas automáticos sobre o orçamento mensal das suas campanhas. O OneClick Ads envia notificações automáticas para mantê-lo informado sobre o status do limite mensal de investimento da sua conta de anúncios. As notificações são entregues por WhatsApp e por e-mail, conforme os canais habilitados no seu [Perfil de Usuário](/pt-br/notifications/canais-whatsapp/) — por padrão, ambos os canais estão ativos. --- ## Notificação 1 — Limite mensal se aproximando ou ultrapassado ### Quando é enviada Essa notificação é disparada quando o gasto acumulado no mês corrente atinge ou supera o percentual de alerta do limite mensal configurado para a conta de anúncios. ### O que a mensagem informa - Qual conta de anúncios atingiu o alerta. - O valor gasto até o momento. - O limite mensal configurado. ### Ação esperada do usuário Revise o orçamento da conta e decida se deseja: - Aumentar o limite mensal, caso o desempenho das campanhas justifique maior investimento. - Manter o limite atual e aguardar o encerramento do ciclo mensal. - Pausar manualmente campanhas de menor prioridade para preservar o orçamento restante. --- ## Notificação 2 — Limite mensal está segurando o crescimento (escala bloqueada) ### Quando é enviada Essa notificação é disparada quando uma campanha pede mais orçamento diário do que cabe dentro do limite mensal configurado para a conta de anúncios, e o OneClick Ads cancela automaticamente esse aumento para não estourar o teto. ### O que a mensagem informa - O limite mensal configurado para a conta e até quanto o OneClick Ads pode escalar dentro dele (uma pequena margem é sempre reservada como segurança, para nunca ultrapassar o valor configurado). - Quanto já foi investido no mês corrente e quanto ainda está disponível de orçamento por dia. - Qual campanha pediu o aumento e de quanto seria esse aumento. - O que aconteceu: o aumento foi cancelado, mas nada muda na campanha — ela continua rodando normalmente com o orçamento atual. - O que fazer: um valor sugerido de novo limite mensal para liberar esse aumento ainda neste mês, ou a opção de não fazer nada e deixar o sistema retomar a escala automaticamente no início do próximo ciclo. ### Ação esperada do usuário - Toque no botão da notificação para ir direto à tela de contas de anúncios e ajustar o limite mensal, caso queira liberar o aumento ainda este mês. - Ou não faça nada: o OneClick Ads volta a escalar normalmente no início do próximo ciclo mensal. ### Observação O OneClick Ads envia no máximo um alerta desse tipo por conta de anúncios a cada 7 dias. Se mais de uma campanha pedir aumento nesse período, apenas a primeira é citada na mensagem — mas outras campanhas da mesma conta podem ter sido bloqueadas pelo mesmo motivo depois dela. --- ## Observações importantes - As notificações são enviadas para o número de WhatsApp e para o e-mail cadastrados na sua conta, de acordo com os canais habilitados para cada notificação. - Nenhuma otimização ou escala automática é alterada por estas notificações — elas são puramente informativas. - Para alterar ou remover seu número de WhatsApp, ou para ativar/desativar cada canal, acesse novamente o **Perfil de Usuário**. --- ## Artigos relacionados - [Canais de Notificação: WhatsApp](/pt-br/notifications/canais-whatsapp/) - [Definindo Limite Mensal de Investimento da Conta de Anúncios](/pt-br/otimizacoes/definindo-limite-mensal-de-investimento-da-conta-de-anuncios/) --- # OneClick Tracking — Rastreamento de Conversões para Meta Ads Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking.md > Guia completo do OneClick Tracking: integre com Hotmart, Kiwify, Shopify, Nuvemshop, Pipedrive, HubSpot, Kommo e outras plataformas para rastrear conversões reais nas suas campanhas Meta Ads via UTM. O **OneClick Tracking** é um sistema de rastreamento de conversões que corrige atribuições erradas feitas pela Meta, entregando dados reais baseados nas UTMs das suas campanhas. :::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. ::: ## O que o OneClick Tracking resolve na prática? Ele cria uma camada de rastreamento baseada em **UTMs** e na integração direta com a plataforma de vendas/CRM para: - **receber conversões diretamente da fonte** (ex.: Hotmart via webhook); - **capturar parâmetros** que mapeiam campanha, conjunto e anúncio; - **exibir a quantidade de conversões e o CPA real** dentro do Gerenciador de Anúncios; - **reduzir divergências e atraso de atribuição** da Meta. ### O tracking mostra resultado também em conjunto e anúncio? Sim. A atualização de nomenclatura ocorre em **campanha, conjunto e anúncio**. Isso permite identificar qual conjunto e qual anúncio (criativo) está gerando vendas rastreadas, com **CPA rastreado em cada nível**. ### O OneClick Tracking vale para todas as campanhas ou apenas para as otimizadas? O rastreamento é aplicado **em nível de conta**. Ao concluir a configuração, as campanhas passam a ser rastreadas **independentemente de estarem ou não com otimização ativa**, e a nomenclatura de tracking passa a aparecer em campanha, conjunto e anúncio. ## Integrações disponíveis As integrações disponíveis cobrem **infoprodutos** (ex.: Hotmart), **e-commerce** e **geração de leads via CRM** (ex.: Pipedrive, com evento por mudança de etapa). - [Integração Hotmart](/pt-br/oneclick-tracking/integracao-hotmart/) - [Integração Pipedrive](/pt-br/oneclick-tracking/integracao-pipedrive/) - [Integração Shopify](/pt-br/oneclick-tracking/integracao-shopify/) - [Integração Eduzz](/pt-br/oneclick-tracking/integracao-eduzz/) - [Integração Greenn](/pt-br/oneclick-tracking/integracao-greenn/) - [Integração Yampi](/pt-br/oneclick-tracking/integracao-yampi/) - [Integração Nuvemshop](/pt-br/oneclick-tracking/integracao-nuvemshop/) - [Integração Kiwify](/pt-br/oneclick-tracking/integracao-kiwify/) - [Integração Perfect Pay](/pt-br/oneclick-tracking/integracao-perfect-pay/) - [Integração Guru Digital Manager](/pt-br/oneclick-tracking/integracao-guru-digital-manager/) - [Integração Kommo](/pt-br/oneclick-tracking/integracao-kommo/) - [Integração HubSpot](/pt-br/oneclick-tracking/integracao-hubspot/) - [Integração GoHighLevel](/pt-br/oneclick-tracking/integracao-gohighlevel/) - [Integração Chatwoot](/pt-br/oneclick-tracking/integracao-chatwoot/) - [Integração Customizada](/pt-br/oneclick-tracking/integracao-customizada/) - [Integração Clint](/pt-br/oneclick-tracking/integracao-clint/) - [Integração Tintim](/pt-br/oneclick-tracking/integracao-tintim/) - [Integração Wbuy](/pt-br/oneclick-tracking/integracao-wbuy/) - [Integração Bagy](/pt-br/oneclick-tracking/integracao-bagy/) - [Integração Zouti](/pt-br/oneclick-tracking/integracao-zouti/) - [Integração BW Commerce](/pt-br/oneclick-tracking/integracao-bwcommerce/) - [Integração RD Station CRM](/pt-br/oneclick-tracking/integracao-rd-station-crm/) - [Integração Assiny](/pt-br/oneclick-tracking/integracao-assiny/) - [Integração HeroSpark](/pt-br/oneclick-tracking/integracao-herospark/) - [Integração PandaChat](/pt-br/oneclick-tracking/integracao-pandachat/) - [Integração Xgrow](/pt-br/oneclick-tracking/integracao-xgrow/) - [Integração GGCheckout](/pt-br/oneclick-tracking/integracao-ggcheckout/) - [Integração Ticto](/pt-br/oneclick-tracking/integracao-ticto/) - [Integração Cakto](/pt-br/oneclick-tracking/integracao-cakto/) - [Integração Tecimob](/pt-br/oneclick-tracking/integracao-tecimob/) ### Como solicitar integração com uma plataforma que ainda não existe? Acesse **OneClick Tracking → nova integração → Sugerir plataforma** e envie o nome. A priorização depende do **volume de solicitações** (ranking interno). > Observação: o setup do tracking funciona melhor via **computador**. Veja também o guia de [Integração Customizada](/pt-br/oneclick-tracking/integracao-customizada/) para plataformas que enviam webhooks próprios. ## Modos de atribuição Antes de finalizar a configuração, você define **como o OneClick combina** os dados do Gerenciador com as conversões rastreadas por UTM. Veja [Modos de Atribuição](/pt-br/oneclick-tracking/modos-de-atribuicao/) — são quatro opções: 100% UTM, atribuição do Gerenciador de Anúncios, por jornada (recomendada) ou personalizada. ## Configuração de UTMs Instalação do script de passagem de UTMs: Insira o script de passagem de UTMs em todas as páginas de venda para que os parâmetros sejam carregados até a página final de checkout. Você pode fazer isso via Google Tag Manager ou, preferivelmente, instalando o script diretamente no header do site. O OneClick recomenda o uso de UTMs que contenham IDs para permitir um rastreamento preciso das conversões. Exemplo padrão do OneClick: ``` utm_source=facebook-oneclick-ads&utm_content={{ad.id}}&utm_medium={{adset.id}}&utm_campaign={{campaign.id}} ``` Se você já usa um padrão de UTMs vinculado ao GA4, é possível combinar ambos. Exemplo que você já utiliza: ``` utm_source=facebook&utm_medium=cpc-{{adset.name}}&utm_campaign={{campaign.name}}&utm_content={{ad.name}} ``` Recomendações práticas: - Mantenha ao menos o `ad.id` nos parâmetros — o OneClick consegue associar a conversão corretamente quando há um ID (o `ad.id` é o mais completo, porque permite identificar também o `adset` e a `campaign`). - Uma opção híbrida sugerida (mantém suas labels legíveis e os IDs para atribuição): ``` utm_source=facebook&utm_content={{ad.id}}-{{ad.name}}&utm_medium=cpc-{{adset.name}}&utm_campaign={{campaign.name}} ``` - Se preferir unificar os dois conjuntos em um só (atenção ao limite de caracteres da Meta): ``` utm_source=facebook-oneclick-ads&utm_medium=cpc-{{adset.name}}-{{adset.id}}&utm_campaign={{campaign.name}}-{{campaign.id}}&utm_content={{ad.name}}-{{ad.id}} ``` - Observação sobre truncamento: a Meta costuma limitar o número de caracteres. Nomes muito longos podem truncar os IDs — por isso é recomendável colocar o ID em primeiro lugar quando possível. - Se o webhook não trouxer nenhum ID no evento, o OneClick não conseguirá identificar de onde a conversão veio. ### Onde inserir as UTMs no anúncio? Há **duas formas**: - inserir as UTMs diretamente no **link de destino**; ou - inserir as UTMs no campo de **Parâmetros de URL** do anúncio. > **Todos** os anúncios precisam ter UTMs corretas — caso contrário, parte das conversões ficará fora do tracking. ### Dá para editar UTMs em massa? Sim. Selecione múltiplos anúncios, edite o campo de **Parâmetros de URL** (que mostrará "valores mistos") e aplique um único valor para todos. ## Consulte seus dados com um assistente de IA O OneClick Ads expõe os dados de rastreamento via [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). Ao conectar um assistente de IA (como o Claude) à sua conta, você pode fazer perguntas em linguagem natural, por exemplo: - "Quais das minhas contas têm o tracking configurado?" - "Quantas conversões recebi nos últimos 7 dias via Hotmart?" - "Mostre as conversões desta semana com o valor de cada transação." - "Qual campanha gerou mais vendas rastreadas no mês?" - "Quanto faturei no mês passado com o OneClick Tracking?" - "Qual foi meu faturamento dos últimos 6 meses, mês a mês?" O assistente consulta seus dados em tempo real e responde com os resultados — sem precisar exportar planilhas ou abrir painéis separados. ## Configure o rastreamento com um assistente de IA Para a maioria das plataformas da lista acima, o cadastro é só colar um link de Webhook — e, para essas, você pode pedir ao seu assistente de IA para criar a integração por você, em vez de repetir o passo a passo manualmente no app. Basta dizer, por exemplo, "configura o rastreamento da minha conta pela Hotmart". O assistente cria a integração e devolve o que só você pode fazer no seu lado: o link de Webhook para colar na plataforma, os parâmetros de UTM para os anúncios e o script de passagem de UTMs para as páginas de venda. Depois de colar essas informações na plataforma e no site, volte a falar com o assistente (ou abra o app) para confirmar se as conversões já estão chegando. O assistente também cria a integração para as plataformas de CRM que pedem uma **credencial de acesso** (um token, por exemplo) — como Pipedrive, HubSpot, Kommo, Clint, GoHighLevel, PandaChat, Tintim e BW Commerce. Nesses casos, depois de informar a credencial, é preciso dizer ao assistente **quais etapas do seu funil contam como conversão** (por exemplo, "considera conversão quando o negócio entrar em 'Ganho' no funil X") — sem isso, a integração fica criada mas ainda não registra nenhuma venda. > Nuvemshop e RD Station CRM ainda são conectados pelo app, porque o processo de autorização dessas duas passa pela tela da própria plataforma. ### Dá para ajustar ou reconectar uma integração já existente pelo assistente? Sim. Depois que a integração já existe, você pode pedir ao assistente para ajustar configurações como a moeda, o modo de atribuição ou quais etapas do funil contam como conversão — sem precisar recriar a integração do zero. Um ajuste feito assim não muda nem apaga as demais configurações da integração. Se a credencial de uma integração de CRM parar de funcionar (por exemplo, um token expirado ou revogado do lado da plataforma), o app deixa de registrar conversões por ela. Nesse caso, peça ao assistente para reconectar a integração informando a nova credencial: ele confirma que ela é válida antes de salvar, e a integração volta a registrar vendas normalmente. ## Rastreamento de conversões no WhatsApp Campanhas com objetivo/fluxo de **WhatsApp** podem ser otimizadas. Para **rastrear conversões** no WhatsApp, recomenda-se utilizar uma solução dedicada que **dispare eventos para a Meta** (ex.: etapa de "reunião agendada" / "demo agendada") e então **otimizar as campanhas para esses eventos**. --- # Integração Assiny Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-assiny.md > Aprenda a conectar o OneClick Tracking à Assiny via webhook para rastrear conversões reais de infoprodutos nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na Assiny. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a Assiny como plataforma de checkout de infoprodutos. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Assiny, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar conversões. Cada conta de anúncios recebe um link único e é possível **vincular múltiplos produtos (order bumps, downsells ou upsells)**. 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. ::: ## Como Plugar o OneClick Tracking na Assiny 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto **Infoproduto** e clique em Continuar. 5. Selecione a plataforma **Assiny** e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da Assiny seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Assiny e rastreia as conversões por UTM. 6.1. Acesse sua conta [Assiny](https://assiny.com.br) e vá até **Integrações**, no menu lateral. 6.2. Cole a URL de rastreamento fornecida pelo OneClick no campo **URL do Webhook** e dê um nome para a integração. a. Ative a opção **Todos os Eventos**. O OneClick Tracking processa apenas pedidos aprovados/pagos — outros eventos são ignorados automaticamente. b. Sugerimos ativar o tracking apenas para o produto principal de cada funil. Se quiser adicionar outros produtos, repita os passos criando um novo webhook para cada produto separadamente. 6.3. Clique em **Salvar Alterações**. a. Você não precisa enviar eventos de teste — basta finalizar a configuração na Assiny. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. b. O script também deve estar presente na página de checkout da Assiny ou na landing page que antecede o checkout. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** o pixel da Meta na configuração da sua conta Assiny. - **Sugestão**: Evite enviar dados de order bumps ou upsells para manter a otimização limpa do produto de entrada. De qualquer modo, você pode criar webhooks também para produtos adicionais apontando para o mesmo link. - O script de passagem de UTMs **deve estar presente** na página de checkout da Assiny ou na landing page que antecede o checkout para garantir que os parâmetros UTM sejam capturados corretamente. - 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. - Se quiser, você pode vincular múltiplos produtos apontando para o mesmo link de Webhook fornecido pelo OneClick Ads. --- # Integração Bagy Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-bagy.md > Aprenda a conectar o OneClick Tracking à Bagy para rastrear conversões de vendas de e-commerce nas suas campanhas Meta Ads com base nas UTMs. > Aprenda a configurar o OneClick Tracking na Bagy. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a Bagy como plataforma de e-commerce. Ele oferece um rastreamento de conversões imediato e preciso. **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. ::: ## Como Plugar o OneClick Tracking na Bagy 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "E-Commerce" e clique em Continuar. 5. Selecione a plataforma "Bagy" e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da plataforma seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Bagy e rastreia a origem das conversões. ## Configuração do Webhook na Bagy 6.1. Acesse sua conta **Bagy**. a. No painel administrativo da Bagy, vá até **Configurações > APIs e Webhooks**. 6.2. Crie um novo Webhook. a. Clique em **Adicionar Webhook** ou **Novo Webhook**. b. Cole a URL de rastreamento fornecida pelo OneClick no campo de URL. c. Selecione o evento de **Pedidos** — este é o evento que representa uma venda confirmada. > 💡 **Dica:** Se ficou com dúvidas em como criar o webhook, [assista este vídeo da Bagy](https://youtu.be/pXbJ1E89P48) que mostra passo a passo como configurar. d. Clique em **Salvar**. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Evento correto:** Certifique-se de que o webhook está configurado para o evento de **Pedidos**. Este é o evento que representa uma conversão confirmada na Bagy. - **UTMs nos anúncios:** As UTMs devem estar presentes nas URLs dos anúncios e ser passadas até a página de checkout via o Script de Passagem de UTMs para que o rastreamento funcione corretamente. - **Formato do payload:** A Bagy envia os dados do webhook no formato `application/x-www-form-urlencoded`. Isso é tratado automaticamente pelo OneClick Tracking. --- # Integração BW Commerce Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-bwcommerce.md > Aprenda a conectar o OneClick Tracking à BW Commerce para rastrear conversões de vendas de e-commerce nas suas campanhas Meta Ads com base nas UTMs. > Aprenda a configurar o OneClick Tracking na BW Commerce. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a BW Commerce como plataforma de e-commerce. Ele oferece um rastreamento de conversões imediato e preciso. **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. ::: ## Como Plugar o OneClick Tracking na BW Commerce 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "E-Commerce" e clique em Continuar. 5. Selecione a plataforma "BW Commerce" e clique em Continuar. 6. Informe o **Endereço da sua loja BW Commerce** e o **Token da API da BW Commerce**, e clique em **Conectar BW Commerce**. Com esses dois dados, o OneClick cria o webhook na sua loja automaticamente — você não precisa configurar nada dentro da BW Commerce. :::note[Por que o endereço da loja é necessário] A BW Commerce atende cada loja em um endereço próprio de API. Por isso, além do token, o OneClick precisa saber qual é a sua loja. Todos estes formatos funcionam: - `sualoja.com.br` - `https://www.sualoja.com.br/` - `sualoja.api.bwcommerce.com.br` Nos três casos o OneClick vai acessar sua loja em `https://sualoja.api.bwcommerce.com.br`. **Confira se o nome da loja nesse endereço é o mesmo que aparece no painel da BW Commerce** — se a sua loja usa um domínio próprio diferente do nome dela na plataforma, informe o endereço que aparece no painel. ::: ## Como obter o Token da API da BW Commerce 6.1. Acesse sua conta **BW Commerce**. 6.2. No painel administrativo, vá até **Configurações > Integrações** e gere um token da API. O passo a passo oficial da BW Commerce está em [Como criar e obter o token da API para integração](https://ajuda.bwcommerce.com.br/artigo/como-criar-e-obter-o-token-da-api-para-integracao-). 6.3. Copie o token e cole no campo **"Token da API da BW Commerce"** dentro do OneClick Tracking. :::tip[O token fica guardado com segurança] O token é armazenado cifrado do lado do OneClick e **nunca volta para o navegador**. Ao reeditar a integração, o campo aparece vazio — deixe-o vazio para manter o token atual, ou cole um novo para substituí-lo. O endereço da loja, por não ser secreto, aparece preenchido ao reeditar. Se precisar **alterar o endereço**, cole o token da API novamente junto com o novo endereço. ::: 6.4. Ao clicar em **Concluir**, no fim da configuração, o OneClick registra na sua loja o webhook do tipo **"Alteração de status de pedido"** — é esse evento que a BW Commerce dispara sempre que um pedido muda de status (incluindo quando é pago/aprovado), e é ele que o OneClick Tracking usa para identificar uma conversão confirmada. Se você já tinha conectado essa loja antes, o webhook existente é **atualizado**, não duplicado. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Webhook automático:** o webhook de **"Alteração de status de pedido"** é criado pelo OneClick com o token que você forneceu. Não é necessário — nem recomendado — criar um webhook manualmente no painel da BW Commerce apontando para a mesma URL: dois webhooks entregariam o mesmo pedido duas vezes. - **Token revogado:** se você revogar ou regenerar o token na BW Commerce, o rastreamento para de funcionar. Reedite a integração no OneClick Tracking e cole o novo token. - **Origem da conversão:** a BW Commerce não envia campos `utm_*` no pedido. As UTMs são lidas da **URL de origem do pedido**, que é a URL pela qual o cliente chegou à loja — por isso o Script de Passagem de UTMs é obrigatório. - **UTMs nos anúncios:** As UTMs devem estar presentes nas URLs dos anúncios e ser passadas até a página de checkout via o Script de Passagem de UTMs para que o rastreamento funcione corretamente. - **Disponibilidade:** Esta integração está em lançamento gradual e pode não estar visível para todas as contas. --- # Integração Cakto Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-cakto.md > Aprenda a conectar o OneClick Tracking à Cakto via webhook para rastrear conversões reais de infoprodutos nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na Cakto. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a Cakto como plataforma de checkout e pagamento de produtos digitais. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Cakto, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar conversões. 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, Cakto e Hotmart 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. ::: ## Como Plugar o OneClick Tracking na Cakto 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto **Infoproduto** e clique em Continuar. 5. Selecione a plataforma **Cakto** e clique em Continuar. 6. Copie a URL do Webhook gerada pelo OneClick e cadastre-a dentro da Cakto seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Cakto e rastreia as conversões por UTM. 6.1. Acesse o painel da sua conta Cakto e abra **Integrações**. Dentro de Integrações, clique em **Webhooks**. 6.2. Clique em **Adicionar** para criar um novo webhook. 6.3. Dê um **nome** ao webhook (por exemplo, "OneClick Tracking") para identificá-lo depois. 6.4. Em **URL**, cole a URL de rastreamento fornecida pelo OneClick. 6.5. Em **eventos**, marque **"Venda Aprovada"**. É esse o evento que gera a conversão. 6.6. Em **produtos**, selecione os produtos que devem enviar eventos para esta URL. 6.7. Salve o webhook. :::note[Os demais eventos podem ficar marcados sem problema] O OneClick Tracking processa **apenas a venda aprovada**. Se você marcar também eventos como Abandono de Checkout, Pix Gerado, Boleto Gerado, Venda Recusada, Reembolso, Chargeback ou os eventos de assinatura, eles são recebidos e simplesmente ignorados — não geram conversão nem duplicam vendas. ::: :::tip[Não há token a informar ao OneClick] A Cakto envia um campo **secret** junto de cada webhook (e uma assinatura no cabeçalho). Você não precisa informá-los ao OneClick: não há campo para eles na nossa configuração e não há nada a configurar do seu lado. ::: 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. b. O script também deve estar presente na landing page que antecede o checkout da Cakto. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** o pixel da Meta na configuração da sua conta Cakto. - O OneClick Tracking registra a venda pelo **valor cobrado no pedido aprovado**, já com desconto aplicado, na moeda da sua conta de anúncios. - **Funciona para produtor, coprodutor e afiliado.** A Cakto envia um único webhook por venda, com a participação de cada pessoa envolvida, e o OneClick Tracking registra a conversão qualquer que seja o seu papel — você não precisa ser o produtor do produto para rastrear os seus anúncios. O valor registrado é sempre o **valor do pedido**, e não a sua comissão. - Apenas a **primeira cobrança** de uma assinatura é registrada como conversão. As renovações seguintes são recebidas e ignoradas, para não contar a mesma venda várias vezes. - O script de passagem de UTMs **deve estar presente** na landing page que antecede o checkout da Cakto para garantir que os parâmetros UTM sejam capturados corretamente. - 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. - Mantenha ao menos um identificador de anúncio (`ad.id`) nos parâmetros de UTM — é o que permite ao OneClick Tracking associar a conversão à campanha, ao conjunto e ao anúncio corretos. Se o cliente não vier de um link rastreado, a Cakto envia as UTMs vazias e a venda não pode ser atribuída. --- # Integração Chatwoot Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-chatwoot.md > Aprenda a conectar o OneClick Tracking ao Chatwoot para rastrear conversões de leads nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking no Chatwoot. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam o Chatwoot como CRM. Ele oferece um rastreamento de leads qualificados de forma precisa. Essa solução **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 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "Geração de leads" e clique em Continuar. 5. Selecione a plataforma "Chatwoot" e clique em Continuar. 5.1. Insira as etiquetas que você quer rastrear. ![image2](../../../../../public/oneclick-tracking/chatwoot/image-1.png) ![image3](../../../../../public/oneclick-tracking/chatwoot/image-2.png) 6. Copie a URL do Webhook e insira dentro do Chatwoot seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta e rastreia as conversões por UTM. c. No Chatwoot, acesse "Settings >> Integrações >> Webhooks >> Configurar". ![image4](../../../../../public/oneclick-tracking/chatwoot/image-3.png) **d. Adicione os triggers do print.** ![image5](../../../../../public/oneclick-tracking/chatwoot/image-4.png) 7. Vá para o próximo passo da integração e copie o Script de UTM gerado dentro do OneClick Tracking. ![image6](../../../../../public/oneclick-tracking/common/image-2.png) 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image7](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs 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. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image8](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image9](../../../../../public/oneclick-tracking/common/image-5.png) ![image10](../../../../../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. ![image11](../../../../../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. --- # Integração Clint Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-clint.md > Aprenda a conectar o OneClick Tracking à Clint para rastrear conversões de vendas e leads nas suas campanhas Meta Ads com precisão. OneClick Tracking — Integração com a Clint :::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. ::: ## 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? 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) 1. O lead clica no anúncio e as UTMs são capturadas. 2. O lead preenche um formulário e entra como negócio na **Clint**. 3. Dentro do OneClick Tracking, você conecta sua conta da Clint (via token de API) e escolhe **quais estágios, em cada funil (origem), contam como conversão**. Essa seleção acontece no próprio OneClick, não na Clint. 4. Quando um negócio avança até uma dessas etapas, a Clint dispara automaticamente um webhook para a URL gerada pelo OneClick Tracking. 5. O OneClick Tracking recebe o evento, confirma que a etapa/origem informadas correspondem ao que você selecionou no Passo 1, identifica as UTMs associadas e registra a conversão. --- ## Passo 1 — Conectar a Clint e escolher os estágios de conversão 1. Acesse o **OneClick Tracking** dentro da OneClick Ads. 2. Selecione a conta de anúncios correspondente. 3. Clique em **Nova integração** (ou **Novo tracking**). 4. Selecione o tipo de produto **"Geração de leads"** e clique em Continuar. 5. Selecione **Clint** como plataforma de origem. 6. Informe o **token de acesso da API da Clint** (veja o Passo 1.5 para obtê-lo) e clique em **Conectar**. 7. Com a conexão feita, o OneClick Tracking lista as suas origens (funis) da Clint com os respectivos estágios. Para cada origem que você quer rastrear, **selecione o(s) estágio(s) que representam uma conversão real** (ex: "Venda fechada"). É essa seleção — feita aqui, dentro do OneClick — que decide quais eventos da Clint contam como conversão; não é configurada na Clint. 8. Clique em Continuar. Na etapa seguinte de configuração do webhook, copie a **URL de webhook** gerada — você irá usá-la na configuração da Clint (Passo 2). :::tip Se você tem mais de um funil ativo, repita a seleção de estágio para cada origem que deve ser rastreada. Uma origem sem nenhum estágio selecionado não gera conversões. ::: --- ## Passo 1.5 — Obter o Token da API da Clint Para conectar no passo anterior, você precisará do token da API da Clint. Siga as instruções na documentação oficial: [Como funciona a API da Clint](https://ajuda.clint.digital/pt-BR/articles/11200658-como-funciona-a-api-da-clint). Cole esse token na tela de conexão do OneClick Tracking (Passo 1) — ele não é inserido na Clint. --- ## 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](https://ajuda.clint.digital/pt-BR/articles/6495685-como-integrar-a-clint-com-outras-plataformas-via-webhook). 1. Acesse sua conta na **Clint** e vá até o **funil** (pipeline) que deseja monitorar. 2. No menu superior, clique na aba **Integrações**. 3. Clique em criar uma nova integração e escolha a opção de integração via **webhook**. 4. 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). 5. Salve a configuração. --- ## 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` | | Email | `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: ![Mapeamento de campos na Clint](https://github.com/user-attachments/assets/8246a5c2-bbab-4800-a068-8e1f0b3321d3) --- ## Notas 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 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. --- # Integração Customizada Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-customizada.md > 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. --- # Integração Eduzz Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-eduzz.md > Aprenda a conectar o OneClick Tracking à Eduzz via webhook para rastrear conversões reais nas suas campanhas Meta Ads com base nas UTMs. > Aprenda a configurar o OneClick Tracking na Eduzz. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Eduzz como gateway de pagamento. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Eduzz, o OneClick considera dados das UTM’s, bem como os da Meta, sem duplicar conversões. Cada conta de anúncios recebe um link único e é possível **vincular múltiplos produtos (order bumps, downsells ou upsells)**. 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. ::: ## Como Plugar o OneClick Tracking na Eduzz 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto e clique em Continuar. a. Infoproduto b. E-Commerce 5. Selecione a plataforma e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da Eduzz seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Eduzz e rastreia as conversões por UTM. 6.1. Acesse sua conta [Eduzz](https://orbita.eduzz.com/producer/webhook). a. Vá ao menu lateral esquerdo em Avançado > [Webhooks](https://orbita.eduzz.com/producer/webhook) dentro da Orbita Eduzz. ![image2](../../../../../public/oneclick-tracking/eduzz/image-1.png) 6.2. Crie um **novo Webhook**. a. Escolha um único produto que deseja rastrear. Sugerimos sempre que você ative o tracking apenas para o produto principal de cada funil. Se quiser adicionar outros produtos, repita os passos 6.1 a 6.4 (criando um novo webhook para cada produto separadamente!). b. Cole o link de rastreamento fornecido pelo OneClick (passo 7) no campo "URL para envio de dados". ![image3](../../../../../public/oneclick-tracking/eduzz/image-2.png) 6.3. Clique em "validar URL" e salve a configuração. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image4](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image5](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image6](../../../../../public/oneclick-tracking/common/image-5.png) ![image7](../../../../../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. ![image8](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** seu pixel na configuração do Produto na Eduzz. - **Sugestão**: Evite enviar dados de order bumps ou upsells, para manter a otimização limpa do produto de entrada. De qualquer modo, você pode, se ainda preferir, criar webhooks também para produtos adicionais. - 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. - Se quiser, você pode vincular múltiplos produtos apontando para o mesmo link de Webhook fornecido pelo OneClick Ads. --- # Integração GGCheckout Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-ggcheckout.md > Aprenda a conectar o OneClick Tracking à GGCheckout via webhook para rastrear conversões reais de infoprodutos nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na GGCheckout. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a GGCheckout como plataforma de checkout e pagamento de produtos digitais. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta GGCheckout, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar conversões. 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, GGCheckout e Hotmart 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. ::: ## Como Plugar o OneClick Tracking na GGCheckout 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto **Infoproduto** e clique em Continuar. 5. Selecione a plataforma **GGCheckout** e clique em Continuar. 6. Copie a URL do Webhook gerada pelo OneClick e cadastre-a dentro da GGCheckout seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à GGCheckout e rastreia as conversões por UTM. 6.1. Acesse o painel da sua conta GGCheckout e vá até **Configurações → Webhooks**. 6.2. Clique em **Adicionar Webhook** e cole a URL de rastreamento fornecida pelo OneClick no campo de URL. 6.3. Selecione os eventos de **pagamento aprovado** — `pix.paid` (PIX confirmado) e `card.paid` (cartão aprovado). São eles que a GGCheckout dispara quando o pagamento é confirmado. 6.4. Salve o webhook. a. Você não precisa enviar eventos de teste — basta finalizar a configuração na GGCheckout. :::note[Os demais eventos podem ficar marcados sem problema] O OneClick Tracking processa **apenas pagamentos aprovados**. Se você selecionar também eventos como `pix.generated`, `pix.expired`, `pix.failed`, `card.pending`, `card.failed` ou os eventos de reembolso, eles são recebidos e simplesmente ignorados — não geram conversão nem duplicam vendas. ::: :::tip[O campo Secret é opcional] Se a GGCheckout pedir um **Secret** ao criar o webhook, você pode deixá-lo em branco — o OneClick Tracking não exige esse valor e não há nada para configurar do nosso lado. ::: 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. b. O script também deve estar presente na página de checkout da GGCheckout ou na landing page que antecede o checkout. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** o pixel da Meta na configuração da sua conta GGCheckout. - O OneClick Tracking registra a venda pelo **valor do pagamento aprovado**, na moeda da sua conta de anúncios. - Como a GGCheckout trabalha com **order bump, upsell e downsell**, cada pagamento aprovado é registrado como uma conversão própria, com o valor efetivamente pago naquele pagamento. - O script de passagem de UTMs **deve estar presente** na página de checkout da GGCheckout ou na landing page que antecede o checkout para garantir que os parâmetros UTM sejam capturados corretamente. - 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. - Mantenha ao menos um identificador de anúncio (`ad.id`) nos parâmetros de UTM — é o que permite ao OneClick Tracking associar a conversão à campanha, ao conjunto e ao anúncio corretos. Se o cliente não vier de um link rastreado, a GGCheckout envia as UTMs vazias e a venda não pode ser atribuída. --- # Integração GoHighLevel Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-gohighlevel.md > Aprenda a conectar o OneClick Tracking ao GoHighLevel para rastrear conversões de leads e vendas nas suas campanhas Meta Ads com precisão via UTM. > Aprenda a configurar o OneClick Tracking. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a GoHighLevel como CRM. Ele oferece um rastreamento de leads qualificados de forma precisa. Essa solução **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 a GoHighLevel para gerar um Token de Longa Duração Antes de integrar o ONECLICK Tracking com a GoHighLevel, é necessário criar uma integração e gerar um **token de longa duração**. Siga o passo a passo a partir do [vídeo](https://youtu.be/ssDO6tz6b1w?t=96) (selecione os escopos de permissão: "opportunities.readonly" e "contacts.readonly") **Atenção:** o token de longa duração é exibido apenas uma vez. - Copie o token gerado - Guarde-o em local seguro - Utilize esse token no aplicativo do **ONECLICK Tracking** --- ## Configurando o OneClick Tracking 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "Geração de leads" e clique em Continuar. 5. Selecione a plataforma "GoHighLevel" e clique em Continuar. 5.1. Insira o seu token de API de longa duração e clique em Conectar. ![image2](../../../../../public/oneclick-tracking/gohighlevel/image-4.png) 5.2. Agora abra o funil e a respectiva etapa na qual a conversão será disparada. Se você marcar, como no exemplo abaixo, a conversão para acontecer em "link de pagamento enviado", o OneClick Tracking irá registrar essa conversão no seu gerenciador de anúncios quando um lead for colocado nesta etapa. 6. Copie a URL do Webhook e insira dentro da GoHighLevel seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta e rastreia as conversões por UTM. c. Na GoHighLevel, acesse "Settings >> Automation >> Create Workflow" (exemplo no [vídeo](https://youtu.be/bz_d6EkC6cc)). **d. Adicione um trigger com o evento "Opportunity Stage Changed"** para capturar sempre que uma oportunidade for movida entre estágios dentro de um pipeline. Esse evento é responsável por informar mudanças no funil, como quando um lead avança de etapa, retorna para um estágio anterior ou é marcado como **Won** ou **Lost**. Caso queira também registrar o momento em que um lead entra no pipeline pela primeira vez, você pode adicionar **outro trigger** com o evento **"Opportunity Created"**. Assim você garante que seu sistema receba tanto a **criação da oportunidade** quanto **todas as movimentações entre estágios**. ![image3](../../../../../public/oneclick-tracking/gohighlevel/image-1.png) e. Adicione o webhook com o link mostrado na configuração do tracking. ![image4](../../../../../public/oneclick-tracking/gohighlevel/image-2.png) ![image5](../../../../../public/oneclick-tracking/gohighlevel/image-3.png) 7. Vá para o próximo passo da integração e copie o Script de UTM gerado dentro do OneClick Tracking. ![image6](../../../../../public/oneclick-tracking/common/image-2.png) 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image7](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs 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. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image8](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image9](../../../../../public/oneclick-tracking/common/image-5.png) ![image10](../../../../../public/oneclick-tracking/common/image-6.png) --- ## Pronto! ![image11](../../../../../public/oneclick-tracking/common/image-7.png) 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. --- ## 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. --- # Integração Greenn Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-greenn.md > Aprenda a conectar o OneClick Tracking à Greenn via webhook de vendas para rastrear conversões pagas nas campanhas Meta Ads com base em UTM. > Aprenda a configurar o OneClick Tracking na Greenn. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Greenn como plataforma de vendas de infoprodutos. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Greenn, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar conversões. Cada conta de anúncios recebe um link único. 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. ::: ## Como Plugar o OneClick Tracking na Greenn 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "Infoproduto" e clique em Continuar. 5. Selecione a plataforma "Greenn" e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da Greenn seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Greenn e rastreia as conversões por UTM. 6.1. Acesse sua conta [Greenn](https://app.greenn.com.br). a. Vá até **Configurações >> Integrações >> Webhooks** no menu da Greenn. 6.2. Crie um novo Webhook. a. Cole a URL de rastreamento fornecido pelo OneClick (passo 6) no campo "URL do webhook". b. Selecione o evento **Venda aprovada** (event = saleUpdated, status = paid). c. Salve a configuração. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image3](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image4](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image5](../../../../../public/oneclick-tracking/common/image-5.png) ![image6](../../../../../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. ![image7](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Rastreie apenas vendas aprovadas**: A integração com Greenn considera apenas o evento `saleUpdated` com status `paid`. Vendas recusadas, pendentes ou com status `error` não geram conversão. - **Webhooks de contrato não são processados**: Apenas eventos de venda (`type = sale`) geram conversões. Eventos de contrato (`type = contract`) são ignorados. - **Origem baseada em UTM**: As UTMs são extraídas a partir dos metadados de venda e dos parâmetros capturados na primeira interação do usuário. - **Sugestão**: Se você oferece múltiplos produtos ou funnels, considere usar webhooks separados para cada fluxo principal, mantendo a otimização limpa. - 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. --- # Integração Guru Digital Manager Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-guru-digital-manager.md > Aprenda a conectar o OneClick Tracking à Guru Digital Manager via webhook para rastrear conversões precisas nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na Guru Digital Manager. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Guru Digital Manager como gateway de pagamento. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Guru Digital Manager, o OneClick considera dados das UTM’s, bem como os da Meta, sem duplicar conversões. Cada conta de anúncios recebe um link único e é possível **vincular múltiplos produtos (order bumps, downsells ou upsells)**. 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. ::: ## Como Plugar o OneClick Tracking na Guru Digital Manager 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "Infoproduto" e clique em Continuar. 5. Selecione a plataforma "Manager Guru" e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da Guru Digital Manager seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Guru Digital Manager e rastreia as conversões por UTM. 6.1. Acesse sua conta [Guru Digital Manager](https://digitalmanager.guru/admin). a. Vá até Configurações > Webhooks. ![image2](../../../../../public/oneclick-tracking/guru/image-1.png) 6.2. Crie um novo Webhook. a. Escolha um único produto que deseja rastrear. Sugerimos sempre que você ative o tracking apenas para o produto principal de cada funil. Se quiser adicionar outros produtos, repita os passos 6.1 a 6.4 (criando um novo webhook para cada produto separadamente!). b. Cole o link de rastreamento fornecido pelo OneClick (passo 7) no campo de URL (URL DO WEBHOOK). ![image3](../../../../../public/oneclick-tracking/guru/image-2.png) 6.3. Selecione os eventos que devem disparar o Webhook. a. Marque "Selecionar todos". ![image4](../../../../../public/oneclick-tracking/guru/image-3.png) 6.4. Aceite os termos e salve a configuração. a. Você não precisa enviar "eventos de teste", portanto, basta finalizar o processo na Guru Digital Manager. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) ## Notas Importantes - **Instale e mantenha** seu pixel na configuração da Guru Digital Manager. - **Sugestão**: Evite enviar dados de order bumps ou upsells, para manter a otimização limpa do produto de entrada. De qualquer modo, você pode, se ainda preferir, criar webhooks também para produtos adicionais. - 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. - Se quiser, você pode vincular múltiplos produtos apontando para o mesmo link de Webhook fornecido pelo OneClick Ads. --- # Integração HeroSpark Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-herospark.md > Aprenda a conectar o OneClick Tracking à HeroSpark via webhook para rastrear conversões reais de infoprodutos nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na HeroSpark. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a HeroSpark como plataforma de infoprodutos, cursos online e área de membros. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta HeroSpark, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar conversões. 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. ::: ## Como Plugar o OneClick Tracking na HeroSpark 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto **Infoproduto** e clique em Continuar. 5. Selecione a plataforma **HeroSpark** e clique em Continuar. 6. Copie a URL do Webhook gerada pelo OneClick e cadastre-a dentro da HeroSpark seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à HeroSpark e rastreia as conversões por UTM. 6.1. Acesse sua conta HeroSpark e vá até **Automações → Webhook**. 6.2. Crie uma nova automação de webhook com **Método POST** e o header **`Content-Type: application/json`**. 6.3. Cole a URL de rastreamento fornecida pelo OneClick no campo de URL do webhook. 6.4. Selecione o evento **Compra Aprovada** (`PURCHASE_APPROVED`) como gatilho. O OneClick Tracking processa apenas pedidos aprovados/pagos — outros eventos (boleto/Pix gerado, recusado, reembolsado, chargeback, cancelamento de assinatura, etc.) são ignorados automaticamente. 6.5. Salve a automação. a. Você não precisa enviar eventos de teste — basta finalizar a configuração na HeroSpark. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. b. O script também deve estar presente na página de checkout da HeroSpark ou na landing page que antecede o checkout. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** o pixel da Meta na configuração da sua conta HeroSpark. - O script de passagem de UTMs **deve estar presente** na página de checkout da HeroSpark ou na landing page que antecede o checkout para garantir que os parâmetros UTM sejam capturados corretamente. - 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. - Mantenha ao menos um identificador de anúncio (`ad.id`) nos parâmetros de UTM — é o que permite ao OneClick Tracking associar a conversão à campanha, ao conjunto e ao anúncio corretos. --- # Integração Hotmart Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-hotmart.md > Aprenda a conectar o OneClick Tracking à Hotmart via webhook para rastrear conversões reais nas suas campanhas Meta Ads com base nas UTMs. > Aprenda a configurar o OneClick Tracking na Hotmart. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Hotmart como gateway de pagamento. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Hotmart, o OneClick considera dados das UTM’s, bem como os da Meta, sem duplicar conversões. Cada conta de anúncios recebe um link único e é possível **vincular múltiplos produtos (order bumps, downsells ou upsells)**. 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. ::: ## Como Plugar o OneClick Tracking na Hotmart 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "Infoproduto" e clique em Continuar. 5. Selecione a plataforma "Hotmart" e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da Hotmart seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Hotmart e rastreia as conversões por UTM. 6.1. Acesse sua conta [Hotmart](https://app.hotmart.com/tools/webhook). a. Vá até Ferramentas > Ver Todas > [Webhooks](https://app.hotmart.com/tools/webhook) no menu da Hotmart. ![image2](../../../../../public/oneclick-tracking/hotmart/image-1.png) 6.2. Crie um novo Webhook. a. Escolha um único produto que deseja rastrear. Sugerimos sempre que você ative o tracking apenas para o produto principal de cada funil. Se quiser adicionar outros produtos, repita os passos 6.1 a 6.4 (criando um novo webhook para cada produto separadamente!). b. Cole o link de rastreamento fornecido pelo OneClick (passo 7) no campo de URL. ![image3](../../../../../public/oneclick-tracking/hotmart/image-2.png) 6.3. Selecione os eventos que devem disparar o Webhook. a. Marque "todos os eventos" de compra. ![image4](../../../../../public/oneclick-tracking/hotmart/image-3.png) 6.4. Aceite os termos e salve a configuração. a. Você não precisa enviar "eventos de teste", portanto, basta finalizar o processo na Hotmart. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** seu pixel na configuração da Hotmart. - **Sugestão**: Evite enviar dados de order bumps ou upsells, para manter a otimização limpa do produto de entrada. De qualquer modo, você pode, se ainda preferir, criar webhooks também para produtos adicionais. - 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. - Se quiser, você pode vincular múltiplos produtos apontando para o mesmo link de Webhook fornecido pelo OneClick Ads. --- # Integração HubSpot Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-hubspot.md > Aprenda a conectar o OneClick Tracking ao HubSpot para rastrear conversões de leads e negócios fechados nas suas campanhas Meta Ads com base nas UTMs. > Aprenda a configurar o OneClick Tracking. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a HubSpot como CRM. Ele oferece um rastreamento de leads qualificados de forma precisa. Essa solução **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 a HubSpot para gerar um Token de Longa Duração Antes de integrar o ONECLICK Tracking com a HubSpot, é necessário criar uma integração e gerar um **token de longa duração**. Siga o passo a passo abaixo. - **Acessando a área de integrações da HubSpot** Você precisa ter **permissão de administrador** na conta da HubSpot. - Acesse a sua conta da HubSpot - Vá em configurações -> Integrações -> 'Legacy Apps' ![image1](../../../../../public/oneclick-tracking/hubspot/image-1.png) - * **Criando a integração** Na tela de criação da integração, preencha os campos conforme abaixo: ![image2](../../../../../public/oneclick-tracking/hubspot/image-2.png) * **Crie uma integração privada** * Adicione um nome e uma descrição para a integração Exemplo: `OneClick Tracking` ![image3](../../../../../public/oneclick-tracking/hubspot/image-3.png) * Na aba de 'Scopes' adicione os itens de leitura ('read') para dar permissões da API ao seu token: ![image4](../../../../../public/oneclick-tracking/hubspot/image-4.png) ![image5](../../../../../public/oneclick-tracking/hubspot/image-5.png) - Na aba de Webhooks adicione a url de webhook que foi copiada da **Etapa 3** na configuração de Tracking no app do OneClick: ![image6](../../../../../public/oneclick-tracking/hubspot/image-6.png) ![image7](../../../../../public/oneclick-tracking/hubspot/image-7.png) - Agora crie uma Subscription para esse webhook e adicione esses parâmetros: ![image8](../../../../../public/oneclick-tracking/hubspot/image-8.png) - Selecione todos os eventos e crie a subscription no botão superior direito ('Create App'): ![image9](../../../../../public/oneclick-tracking/hubspot/image-9.png) ![image10](../../../../../public/oneclick-tracking/hubspot/image-10.png) - **Gerando o Token de Longa Duração** Depois de criar a integração você consegue acessar o seu token na aba 'Auth': ![image11](../../../../../public/oneclick-tracking/hubspot/image-11.png) - Clique em 'Show token' - Copie e cole na etapa 2.1: ![image12](../../../../../public/oneclick-tracking/hubspot/image-12.png) --- ## Configurando o OneClick Tracking 1. Acesse sua conta OneClick Ads. 2. Vá até a aba "OneClick Tracking", conforme disponível no menu lateral esquerdo do [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking). ![image13](../../../../../public/oneclick-tracking/common/image-1.png) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "Geração de leads" e clique em Continuar. 5. Selecione a plataforma "HubSpot" e clique em Continuar. 5.1. Insira o seu token de API de longa duração e clique em Conectar. 5.2. Agora abra o funil e a respectiva etapa na qual a conversão será disparada. Se você marcar, como no exemplo abaixo, a conversão para acontecer em "segunda-etapa", o OneClick Tracking irá registrar essa conversão no seu gerenciador de anúncios quando um lead for colocado nesta etapa. ![image14](../../../../../public/oneclick-tracking/hubspot/image-13.png) 6. Copie a URL do Webhook e insira dentro da HubSpot seguindo o passo-a-passo da parte de cima do documento. 7. Vá para o próximo passo da integração e copie o Script de UTM gerado dentro do OneClick Tracking. ![image15](../../../../../public/oneclick-tracking/common/image-2.png) 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image16](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs 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. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image17](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image18](../../../../../public/oneclick-tracking/common/image-5.png) ![image19](../../../../../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. ![image20](../../../../../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. --- # Integração Kiwify Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-kiwify.md > Aprenda a conectar o OneClick Tracking à Kiwify via webhook para rastrear conversões reais de infoprodutos nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na Kiwify. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Kiwify como gateway de pagamento. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Kiwify, o OneClick considera dados das UTM’s, bem como os da Meta, sem duplicar conversões. Cada conta de anúncios recebe um link único e é possível **vincular múltiplos produtos (order bumps, downsells ou upsells)**. 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. ::: ## Como Plugar o OneClick Tracking na Kiwify 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto e clique em Continuar. a. Infoprodutos b. E-commerce c. Geração de Leads 5. Selecione a plataforma e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da Kiwify seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Kiwify e rastreia as conversões por UTM. 6.1. Acesse sua conta [Kiwify](https://dashboard.kiwify.com/apps/webhooks/integrations). a. Vá até Apps > Webhooks. ![image2](../../../../../public/oneclick-tracking/kiwify/image-1.png) 6.2. Crie um novo Webhook. a. Escolha um único produto que deseja rastrear. Sugerimos sempre que você ative o tracking apenas para o produto principal de cada funil. Se quiser adicionar outros produtos, repita os passos 6.1 a 6.4 (criando um novo webhook para cada produto separadamente!). b. Cole o link de rastreamento fornecido pelo OneClick (passo 7) no campo de URL (URL DO WEBHOOK). ![image3](../../../../../public/oneclick-tracking/kiwify/image-2.png) 6.3. Selecione os eventos que devem disparar o Webhook. a. Marque "Selecionar todos". ![image4](../../../../../public/oneclick-tracking/kiwify/image-3.png) 6.4. Aceite os termos e salve a configuração. a. Você não precisa enviar "eventos de teste", portanto, basta finalizar o processo na Kiwify. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** seu pixel na configuração da Kiwify. - **Sugestão**: Evite enviar dados de order bumps ou upsells, para manter a otimização limpa do produto de entrada. De qualquer modo, você pode, se ainda preferir, criar webhooks também para produtos adicionais. - 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. - Se quiser, você pode vincular múltiplos produtos apontando para o mesmo link de Webhook fornecido pelo OneClick Ads. --- # Integração Kommo Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-kommo.md > Aprenda a conectar o OneClick Tracking ao Kommo CRM para rastrear conversões de leads e negócios fechados nas suas campanhas Meta Ads via UTM. > Aprenda a configurar o OneClick Tracking. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Kommo como CRM. Ele oferece um rastreamento de leads qualificados de forma precisa. Essa solução **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 a Kommo para gerar um Token de Longa Duração Antes de integrar o ONECLICK Tracking com a Kommo, é necessário criar uma integração e gerar um **token de longa duração**. Siga o passo a passo abaixo. - **Acessando a área de integrações da Kommo** Você precisa ter **permissão de administrador** na conta da Kommo. - Acesse a sua conta da Kommo pelo navegador: `https://{seu-subdominio}.kommo.com/home/` - No menu principal, vá em: - **Configurações** - **Central de Integrações** - Clique em **Criar integração**. ![image1](../../../../../public/oneclick-tracking/kommo/image-1.png) ![image2](../../../../../public/oneclick-tracking/kommo/image-2.png) - * **Criando a integração** Na tela de criação da integração, preencha os campos conforme abaixo: * **Nome da integração** Exemplo: `ONECLICK TRACKING` * **URL de redirecionamento (Redirect URL)** Informe a URL do aplicativo ONECLICK: `https://app.oneclickads.com.br/` * Após preencher os dados, clique em **Salvar**. * **Gerando o Token de Longa Duração** Com a integração criada, siga os passos abaixo: ![image3](../../../../../public/oneclick-tracking/kommo/image-3.png) * Dentro da integração, acesse a aba: * **Chaves e escopo** * Clique em **Gerar token de longa duração**. * Defina a **data de expiração**: * A Kommo permite tokens de até **5 anos** * Selecione a **maior data possível** * Clique em **Salvar / Gerar token**. * **Salvando o token** **Atenção:** o token de longa duração é exibido apenas uma vez. * Copie o token gerado * Guarde-o em local seguro * Utilize esse token no aplicativo do **ONECLICK Tracking** --- ## Configurando o OneClick Tracking 1. Acesse sua conta OneClick Ads. 2. Vá até a aba "OneClick Tracking", conforme disponível no menu lateral esquerdo do [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking). ![image4](../../../../../public/oneclick-tracking/common/image-1.png) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "Geração de leads" e clique em Continuar. 5. Selecione a plataforma "Kommo" e clique em Continuar. 5.1. Insira o seu token de API de longa duração e clique em Conectar. 5.2. Agora abra o funil e a respectiva etapa na qual a conversão será disparada. Se você marcar, como no exemplo abaixo, a conversão para acontecer em "link de pagamento enviado", o OneClick Tracking irá registrar essa conversão no seu gerenciador de anúncios quando um lead for colocado nesta etapa. ![image5](../../../../../public/oneclick-tracking/kommo/image-4.png) 6. Copie a URL do Webhook e insira dentro da Kommo seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta e rastreia as conversões por UTM. c. Na Kommo, acesse "Configurações >> Central de integrações >> Webhooks". d. Clique em "+ Webhook" no canto superior direito da tela. e. Configure o Webhook: Ação do evento = ex: Status do lead alterado / Nome do Webhook = OneClick Tracking. f. Cole a URL do webhook gerado dentro do OneClick Tracking no campo "URL do ponto de extremidade". Clique em Salvar. ![image6](../../../../../public/oneclick-tracking/kommo/image-5.png) 7. Vá para o próximo passo da integração e copie o Script de UTM gerado dentro do OneClick Tracking. ![image7](../../../../../public/oneclick-tracking/common/image-2.png) 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image8](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs 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. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image9](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image10](../../../../../public/oneclick-tracking/common/image-5.png) ![image11](../../../../../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. ![image12](../../../../../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. --- # Integração Nuvemshop Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-nuvemshop.md > Aprenda a conectar o OneClick Tracking à Nuvemshop para rastrear conversões de vendas de e-commerce nas suas campanhas Meta Ads com precisão via UTM. > Aprenda a configurar o OneClick Tracking na Nuvemshop. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a Nuvemshop como plataforma de e-commerce. Ele oferece um rastreamento de conversões imediato e preciso, conectando sua loja diretamente à sua conta de anúncios. **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. ::: ## Como Plugar o OneClick Tracking na Nuvemshop 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "E-Commerce" e clique em Continuar. 5. Selecione a plataforma "Nuvemshop" e clique em Continuar. 6. Clique em **"Instalar app na Nuvemshop"**. - Você será redirecionado para a Nuvemshop para autorizar o acesso do OneClick Ads à sua loja. - Após confirmar as permissões, você voltará automaticamente para o OneClick Tracking. :::tip[Webhook criado automaticamente] Diferente de outras plataformas, **não é necessário configurar o webhook manualmente**. O OneClick cria o webhook de pedidos pagos na sua loja Nuvemshop automaticamente durante a autorização. ::: 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image2](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image3](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image4](../../../../../public/oneclick-tracking/common/image-5.png) ![image5](../../../../../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. ![image6](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - O rastreamento funciona com base nos pedidos com status **pago** (`payment_status: paid`) enviados pela Nuvemshop via webhook. - Caso precise reconectar sua loja (por exemplo, após troca de credenciais), basta criar uma nova integração e passar pelo fluxo de autorização novamente. --- # Integração PandaChat Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-pandachat.md > Aprenda a conectar o OneClick Tracking ao PandaChat para rastrear conversões de leads do WhatsApp nas suas campanhas Meta Ads com precisão. OneClick Tracking — Integração com o PandaChat :::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. ::: ## 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. No caso do PandaChat, o lead chega pelo WhatsApp — normalmente por um anúncio de **Click to WhatsApp**. Quando isso acontece, o PandaChat guarda junto do lead a informação de **qual anúncio o trouxe** (campanha, conjunto e anúncio da Meta). É esse dado que o OneClick Tracking usa para ligar a conversão ao anúncio certo, tornando o CPA e o ROAS das suas campanhas muito mais precisos. --- ## 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: - O **PandaChat** é quem **envia** o webhook (com os dados do lead) quando ele muda de etapa no funil. - O **OneClick Tracking** é quem **recebe** esses dados e registra a conversão. --- ## Como funciona a integração (visão geral) 1. O lead clica no seu anúncio de Click to WhatsApp e inicia uma conversa. 2. O PandaChat registra o lead e guarda a atribuição do anúncio de origem. 3. Dentro do OneClick Tracking, você conecta seu workspace do PandaChat (com a chave de API) e escolhe **quais etapas do funil contam como conversão**. Essa seleção acontece no próprio OneClick, não no PandaChat. 4. Você envia a sua URL de webhook ao PandaChat, e eles ativam o envio para a sua conta (veja o Passo 3 — **esse passo é obrigatório**). 5. Quando um lead entra em uma dessas etapas, o PandaChat dispara o evento `lead.stage_changed` para a URL do OneClick Tracking. 6. O OneClick Tracking recebe o evento, confirma que a etapa corresponde ao que você selecionou, identifica o anúncio de origem e registra a conversão. --- ## O funil do PandaChat O PandaChat usa um funil fixo de **8 etapas**, iguais para todos os workspaces. O lead caminha por elas conforme o atendimento avança: | # | Etapa | Significado | | --- | ---------------------- | -------------------------------------------- | | 1 | Novo lead | Chamou no WhatsApp, ainda não qualificado | | 2 | Em atendimento | IA ou atendente conversando | | 3 | Pediu preço | Chegou na parte de valor/oferta | | 4 | Parou após preço | Recebeu o valor e parou de responder | | 5 | Interesse alto | Perguntou detalhes importantes | | 6 | Dados incompletos | Começou a passar dados, falta algo | | 7 | Aguardando confirmação | Passou os dados, não confirmou | | 8 | **Pedido agendado** | Pedido confirmado/agendado — **a conversão** | Na maioria dos casos a etapa que representa a conversão é **"Pedido agendado"**. Você pode selecionar mais de uma etapa se fizer sentido para o seu negócio — por exemplo, acompanhar também "Interesse alto" como um sinal intermediário. --- ## Passo 1 — Obter a chave de API do PandaChat A chave de API é **única por workspace** e fica disponível direto no seu painel do PandaChat — não é preciso falar com o suporte. 1. No painel do PandaChat, acesse a seção **Integração / API**. 2. Em **Sua chave de integração**, clique no ícone do olho para revelar a chave (ou use o botão **Copiar** para copiar sem revelar). Guarde essa chave — ela será colada no OneClick Tracking no próximo passo, e não é configurada em nenhum lugar dentro do PandaChat. :::tip[A chave é só sua e é somente leitura] Segundo o próprio PandaChat, essa chave dá acesso **somente de leitura** aos seus funis e estágios — ela não permite alterar nada na sua conta. Não a compartilhe publicamente. Se desconfiar que alguém teve acesso a ela, gere uma nova chave na mesma tela do PandaChat e reconecte a integração no OneClick com a chave nova. ::: --- ## Passo 2 — Conectar o PandaChat e escolher as etapas de conversão 1. Acesse o **OneClick Tracking** dentro da OneClick Ads. 2. Selecione a conta de anúncios correspondente. 3. Clique em **Nova integração** (ou **Novo tracking**). 4. Selecione o tipo de produto **"Geração de leads"** e clique em Continuar. 5. Selecione **PandaChat** como plataforma de origem. 6. Cole a **chave de API** obtida no Passo 1 e clique em **Conectar PandaChat**. 7. Com a conexão feita, o OneClick Tracking lista o seu funil e as 8 etapas. **Selecione a(s) etapa(s) que representam uma conversão real** — normalmente "Pedido agendado". É essa seleção, feita aqui dentro do OneClick, que decide quais eventos do PandaChat contam como conversão. 8. Clique em Continuar. Na etapa seguinte, copie a **URL de webhook** gerada — você vai precisar dela no Passo 3. :::caution[A chave é validada na hora] Se a chave estiver incorreta ou já não for aceita pelo PandaChat, a conexão falha imediatamente e nada é salvo. Confira a chave com o suporte deles e tente novamente. ::: --- ## Passo 3 — Enviar a sua URL de webhook ao PandaChat **Este passo é obrigatório e não pode ser feito pelo OneClick.** O PandaChat não tem uma tela de autoatendimento para cadastrar webhooks: a ativação é feita por eles, a pedido, para cada workspace. 1. Copie a **URL de webhook** gerada no Passo 2. Ela é **exclusiva da sua conta de anúncios** — não reutilize a URL de outra conta. 2. Envie essa URL ao suporte do PandaChat e peça para ativarem o envio do evento **`lead.stage_changed`** para ela. 3. Aguarde a confirmação de que o webhook foi ativado. :::danger[Sem este passo, nenhuma conversão é registrada] Enquanto o PandaChat não ativar o envio para a sua URL, a integração aparece configurada no OneClick mas **não recebe nada** — e não há como o OneClick detectar isso sozinho. Se depois de alguns dias você não vir conversões chegando, confirme com o suporte do PandaChat se o webhook foi mesmo ativado para a sua URL. ::: --- ## Notas Importantes - Cada conta de anúncios tem uma URL de webhook diferente. Se você gerencia múltiplas contas, crie uma integração separada para cada uma e envie **cada URL** ao PandaChat. - O webhook só é disparado quando o lead **entra** em uma etapa, e cada combinação de lead + etapa é enviada uma única vez. Um lead que volta para uma etapa anterior e avança de novo não gera conversão duplicada. - Uma etapa que você não selecionou no Passo 2 continua sendo enviada pelo PandaChat, mas é descartada pelo OneClick — só as etapas selecionadas viram conversão. - Para leads de WhatsApp, a atribuição usa o dado nativo de **Click to WhatsApp** do PandaChat, que é mais confiável que UTM. As UTMs clássicas no PandaChat são capturadas apenas em vendas por checkout, então podem não existir para um lead que veio direto pelo WhatsApp — isso é esperado e não impede o rastreamento. - Um lead que chegou por um canal sem nenhuma atribuição de anúncio (por exemplo, alguém que salvou o seu número e chamou espontaneamente) não gera conversão rastreada, porque não há anúncio ao qual atribuí-la. - Após configurar a integração, aguarde o próximo lead chegar à etapa de conversão para verificar se os dados estão chegando corretamente no OneClick Tracking. --- ## Resultado esperado Após a configuração — e com o webhook ativado pelo PandaChat — cada vez que um lead avançar até a etapa que você selecionou, o PandaChat enviará automaticamente os dados para o OneClick Tracking. O sistema registra a conversão e a associa ao anúncio de Click to WhatsApp que trouxe aquele lead, permitindo que você veja o CPA e o ROAS reais das suas campanhas diretamente na OneClick Ads. --- # Integração Perfect Pay Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-perfect-pay.md > Aprenda a conectar o OneClick Tracking à Perfect Pay via webhook para rastrear conversões reais de infoprodutos nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na Perfect Pay. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a Perfect Pay como gateway de pagamento de infoprodutos. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Perfect Pay, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar conversões. Cada conta de anúncios recebe um link único e é possível **vincular múltiplos produtos (order bumps, downsells ou upsells)**. 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. ::: ## Como Plugar o OneClick Tracking na Perfect Pay 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "Infoprodutos" e clique em Continuar. 5. Selecione a plataforma **Perfect Pay** e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da Perfect Pay seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Perfect Pay e rastreia as conversões por UTM. 6.1. Acesse sua conta [Perfect Pay](https://app.perfectpay.com.br). No menu lateral esquerdo, vá até **Ferramentas > Webhook - Vendas**. > Consulte também a documentação oficial da Perfect Pay sobre integração via Postback/Webhook ([artigo 597](https://help.perfectpay.com.br/article/597-integracao-via-webhook-com-a-perfect-pay) ou [artigo 72](https://support.perfectpay.com.br/doc/perfectpay/postback/integracao-via-webhook-com-a-perfect-pay)) para mais detalhes sobre a tela de configuração. 6.2. Clique em **Adicionar** para cadastrar um novo webhook. a. Em **Produtos**, selecione o produto que deseja rastrear. Sugerimos sempre que você ative o tracking apenas para o produto principal de cada funil. Se quiser adicionar outros produtos, repita os passos criando um novo webhook para cada produto separadamente. b. Em **URL**, cole a URL de rastreamento fornecida pelo OneClick. c. Em **Eventos**, marque pelo menos o evento **Aprovado** (você também pode marcar todos os eventos disponíveis — Pendente, Aprovado, Em processo, Em mediação, Rejeitado, Cancelado, Devolvido, Autorizado, Enviado de Volta, Completo, Erro no Checkout, Pré Checkout — o OneClick Tracking processa apenas o evento de venda **aprovada** e ignora automaticamente todos os demais, incluindo reembolsos, chargebacks, carrinhos abandonados e cobranças recorrentes de assinatura). d. O campo de **delay** (tempo de espera entre o evento ocorrer e o envio do Postback) pode ficar no valor padrão — não é necessário configurar um atraso para o OneClick Tracking funcionar. 6.3. Em **Formato do Postback**, selecione o formato **Perfect Pay** (o formato nativo da própria plataforma). :::caution[O formato do Postback precisa ser "Perfect Pay"] A Perfect Pay permite emular o formato de postback de outras plataformas (para compatibilidade com ferramentas que não integram nativamente com ela). O OneClick Tracking espera o formato **nativo da Perfect Pay** — se um formato diferente for selecionado, os campos do payload não serão reconhecidos e nenhuma conversão será registrada, sem nenhum erro visível na tela da Perfect Pay. ::: 6.4. Salve a configuração. a. Você não precisa enviar eventos de teste — basta finalizar a configuração na Perfect Pay. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. b. O script também deve estar presente na página de checkout da Perfect Pay ou na landing page que antecede o checkout. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Formato do Postback**: sempre selecione o formato **Perfect Pay** (nativo) ao cadastrar o webhook. Selecionar o formato de outra plataforma faz o webhook ser enviado normalmente, mas com campos que o OneClick Tracking não reconhece — as conversões simplesmente não aparecem, sem nenhum aviso de erro. - **Instale e mantenha** seu pixel na configuração da Perfect Pay. - **Sugestão**: Evite enviar dados de order bumps ou upsells, para manter a otimização limpa do produto de entrada. De qualquer modo, você pode, se ainda preferir, criar webhooks também para produtos adicionais. - **Apenas a venda aprovada conta como conversão**: reembolsos, chargebacks, carrinhos abandonados e cobranças recorrentes de uma assinatura (a partir da segunda cobrança) não são contabilizados pelo OneClick Tracking. - 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. - Se quiser, você pode vincular múltiplos produtos apontando para o mesmo link de Webhook fornecido pelo OneClick Ads. --- # Integração Pipedrive Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-pipedrive.md > Aprenda a conectar o OneClick Tracking ao Pipedrive CRM para rastrear conversões de negócios fechados nas suas campanhas Meta Ads com base nas UTMs. > Aprenda a configurar o OneClick Tracking. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Pipedrive como CRM. Ele oferece um rastreamento de leads qualificados de forma precisa. Essa solução **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 Pipedrive para receber UTMs Antes de configurar o OneClick Tracking, é necessário preparar o Pipedrive para receber as UTMs. Siga o passo a passo abaixo: - Você precisa garantir que tenha o acesso de "Administrador" da sua conta do [Pipedrive](https://www.pipedrive.com/pt/gettingstarted-crm). - Criando campos personalizados no Pipedrive: - No Pipedrive, clique no seu nome/ícone no canto superior direito. - Entre em Configurações da empresa (Company settings). - Abra a área de campos - Vá em Campos de dados (Data fields). - Crie um Grupo de Campos (para organizar) - Em Grupo de campo, crie um novo grupo chamado Marketing. - Salvar. - Crie os campos personalizados (tipo Texto) dentro do grupo “Marketing” --- Para cada campo a ser criado: - Clique em Adicionar campo personalizado - Defina o nome do campo - Selecione o tipo Texto - Escolha o grupo Marketing - Salvar --- Campos a criar: - utm_source (Texto → Marketing) - utm_medium (Texto → Marketing) - utm_campaign (Texto → Marketing) - utm_content (Texto → Marketing) - utm_term (Texto → Marketing) Pronto! Agora você tem campos personalizados que documentam as UTMs dentro dos Negócios (deals) criados no Pipedrive. --- 3. Garantindo que as UTMs sejam preenchidas dentro de cada Negócio: - **Usando formulário nativo do Pipedrive**: basta criar o formulário e instalá-lo no seu site, de acordo com [o tutorial](https://youtu.be/8muF6oOrcJs?si=QT1dfLv7n0iK7V2j&t=305). - [Toque aqui](https://youtu.be/8muF6oOrcJs?si=QT1dfLv7n0iK7V2j&t=305) para acessar o tutorial. - **Usando formulário no Wordpress/Elementor**: siga [este tutorial](https://www.youtube.com/watch?v=YLDGQ1FqvK4) passo a passo para criar campos ocultos no formulário do site. - Primeiro, [toque aqui](https://www.youtube.com/watch?v=YLDGQ1FqvK4) para acessar o tutorial da criação dos campos ocultos. - Depois, você precisa enviar as informações do formulário para o Pipedrive utilizando a integração direta com o Pipedrive (Acesse Marketplace > Pesquise por "elementor"). ![image1](../../../../../public/oneclick-tracking/pipedrive/image-1.png) - **Usando outras fontes de geração de dados (formulário nativo da Meta, etc..)**: siga [este tutorial](https://www.youtube.com/watch?v=IzyC07e6S4w) para utilizar ferramentas de integração como [Make](https://www.make.com/) ou [N8N](https://n8n.io/). - [Toque aqui](https://www.youtube.com/watch?v=IzyC07e6S4w) para acessar o tutorial. --- ## Configurando o OneClick Tracking 1. Acesse sua conta OneClick Ads. 2. Vá até a aba "OneClick Tracking", conforme disponível no menu lateral esquerdo do [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking). ![image2](../../../../../public/oneclick-tracking/common/image-1.png) _(toque na imagem para abrir)_ 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "Geração de leads" e clique em Continuar. 5. Selecione a plataforma "Pipedrive" e clique em Continuar. 5.1. Insira o seu token de API e clique em Conectar. Você pode encontrar seu token nas configurações da sua conta Pipedrive em Configurações → Minha Conta → Preferências Pessoais → API → Seu Token de API Pessoal. 5.2. Agora abra o funil e a respectiva etapa na qual a conversão será disparada. Se você marcar, como no exemplo abaixo, a conversão para acontecer em "link de pagamento enviado", o OneClick Tracking irá registrar essa conversão no seu gerenciador de anúncios quando um lead for colocado nesta etapa. ![image3](../../../../../public/oneclick-tracking/pipedrive/image-2.png) 6. Copie a URL do Webhook e insira dentro do Pipedrive seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta e rastreia as conversões por UTM. c. No Pipedrive, acesse "Mais >> Automações >> Webhooks". d. Clique em "+ Webhook" no canto superior direito da tela, em seguida, selecione "webhook" novamente. e. Configure o Webhook: Ação do evento = change / Objetivo do evento = deal / Nome do Webhook = OneClick Tracking. f. Cole a URL do webhook gerado dentro do OneClick Tracking no campo "URL do ponto de extremidade". Clique em Salvar. ![image4](../../../../../public/oneclick-tracking/pipedrive/image-3.png) 7. Vá para o próximo passo da integração e copie o Script de UTM gerado dentro do OneClick Tracking. ![image5](../../../../../public/oneclick-tracking/common/image-2.png) 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image6](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs 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. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image7](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image8](../../../../../public/oneclick-tracking/common/image-5.png) ![image9](../../../../../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. ![image10](../../../../../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. --- # Integração RD Station CRM Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-rd-station-crm.md > Aprenda a conectar o OneClick Tracking ao RD Station CRM para rastrear conversões de negociações nas suas campanhas Meta Ads com precisão. OneClick Tracking — Integração com o RD Station CRM :::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. ::: ## 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 a abertura de uma negociação no CRM. O OneClick Tracking captura esses dados e, quando a negociação avança até a etapa definida como conversão dentro do seu CRM (neste caso, o **RD Station CRM**), 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? 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: - O **RD Station CRM** é quem **envia** o webhook (com os dados da negociação) quando ela é atualizada. - O **OneClick Tracking** é quem **recebe** esses dados e registra a conversão. **Você não precisa criar esse webhook manualmente.** Diferente da maioria das integrações de CRM, aqui o OneClick Tracking cria o webhook na sua conta do RD Station CRM automaticamente, no momento em que você autoriza o acesso. --- ## Antes de começar — o que sua conta precisa ter - Uma conta no **RD Station CRM** com plano **Basic, Pro ou Advanced**. Webhooks não estão disponíveis no plano gratuito. - Um usuário com permissão de **administrador**, para conseguir autorizar o acesso da OneClick Ads. Se a criação do webhook falhar, o OneClick Tracking avisa na tela e **não** salva a integração pela metade — assim você não fica com uma integração que parece conectada mas nunca registra conversões. --- ## Como funciona a integração (visão geral) 1. O lead clica no anúncio e as UTMs são capturadas. 2. O lead preenche um formulário e entra como negociação no **RD Station CRM**. 3. Dentro do OneClick Tracking, você conecta sua conta do RD Station CRM com um clique (autorização) e escolhe **quais etapas, em cada funil, contam como conversão**. Essa seleção acontece no próprio OneClick, não no RD Station. 4. Quando uma negociação é atualizada, o RD Station CRM dispara automaticamente um webhook para a URL do OneClick Tracking. 5. O OneClick Tracking recebe o evento, confirma que o funil e a etapa correspondem ao que você selecionou, identifica as UTMs associadas e registra a conversão. --- ## Passo 1 — Conectar o RD Station CRM 1. Acesse o **OneClick Tracking** dentro da OneClick Ads. 2. Selecione a conta de anúncios correspondente. 3. Clique em **Nova integração** (ou **Novo tracking**). 4. Selecione o tipo de produto **"Geração de leads"** e clique em Continuar. 5. Selecione **RD Station CRM** como plataforma de origem. 6. Clique em **Conectar RD Station CRM**. Você será levado para uma tela do RD Station pedindo autorização. 7. Confirme a autorização. Você volta automaticamente para o OneClick Tracking, já conectado — e o webhook de negociações já terá sido criado na sua conta. --- ## Passo 2 — Escolher as etapas de conversão Com a conexão feita, o OneClick Tracking lista os seus funis do RD Station CRM com as respectivas etapas. 1. Clique no funil que você quer rastrear para expandi-lo. 2. **Selecione a(s) etapa(s) que representam uma conversão real** para o seu negócio (por exemplo, "Venda ganha"). 3. Repita para cada funil que deve ser rastreado. 4. Clique em **Continuar**. :::tip Um funil sem nenhuma etapa selecionada não gera conversões. Se você tem mais de um funil ativo, repita a seleção para cada um. ::: É essa seleção — feita aqui, dentro do OneClick — que decide quais negociações contam como conversão. Você pode voltar e alterá-la quando quiser: a mudança vale imediatamente e **não** exige reconectar a conta nem mexer em nada no RD Station. A seleção é feita pelo identificador interno da etapa, não pelo nome. Renomear uma etapa no RD Station **não** quebra o rastreamento. --- ## Passo 3 — Garantir que as UTMs chegam à negociação Para que a atribuição funcione, os parâmetros de UTM precisam estar gravados na negociação dentro do RD Station CRM. O RD Station CRM não tem campos de UTM próprios, então o caminho usual é criar **campos personalizados** na negociação com os nomes padrão e preenchê-los a partir do seu formulário de captura: - `utm_source` - `utm_medium` - `utm_campaign` - `utm_content` - `utm_term` > **Atenção:** as UTMs são **essenciais** para que o OneClick Tracking consiga identificar o anúncio que gerou a conversão. Confirme que os formulários de captura estão enviando esses dados para o RD Station CRM. --- ## Notas Importantes - O webhook é criado automaticamente e cobre **todos** os funis e etapas da conta. O filtro do que conta como conversão é a sua seleção no Passo 2 — por isso mudar a seleção não exige nenhuma alteração no RD Station. - Cada conta de anúncios tem a sua própria integração. Se você gerencia múltiplas contas, repita o processo para cada uma. - Se a autorização expirar, o OneClick Tracking avisa com a mensagem "Sua conexão com o RD Station CRM expirou. Conecte novamente." — basta refazer o Passo 1. - Após configurar a integração, aguarde a próxima negociação chegar à etapa selecionada para verificar se os dados estão chegando corretamente. --- ## Resultado esperado Após a configuração, cada vez que uma negociação no RD Station CRM avançar até uma das etapas que você selecionou, o RD Station 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. --- # Integração Shopify Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-shopify.md > Aprenda a conectar o OneClick Tracking à Shopify para rastrear conversões de vendas de e-commerce nas suas campanhas Meta Ads com precisão via UTM. > Aprenda a configurar o OneClick Tracking na Shopify. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Shopify como gateway de pagamento. Ele oferece um rastreamento de conversões imediato e preciso. **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. ::: ## Como Plugar o OneClick Tracking na Shopify 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "E-Commerce" e clique em Continuar. 5. Selecione a plataforma "Shopify" e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da plataforma seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Shopify e rastreia a origem das conversões. 6.1. Acesse sua conta **Shopify**. a. Vá até **Configurações >> Webhooks >> Criar Webhook** no menu da Shopify. 6.2. Crie um novo Webhook. a. Escolha o evento "Atualização de Pedido" ou "Order Update". b. Cole a URL de rastreamento fornecido pelo OneClick no campo de URL. c. Selecione o formato "JSON". d. Clique em "Salvar". ![image2](../../../../../public/oneclick-tracking/shopify/image-1.png) 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image3](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image4](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image5](../../../../../public/oneclick-tracking/common/image-5.png) ![image6](../../../../../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. ![image7](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** seu pixel na configuração da Shopify. - Apenas pedidos com status de pagamento **"Paid"** (pago) são considerados conversão. Pedidos pendentes, cancelados ou reembolsados não são contabilizados pelo OneClick Tracking. --- # Integração Tecimob Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-tecimob.md > Aprenda a conectar o OneClick Tracking ao Tecimob via webhook para atribuir os leads do seu site imobiliário às suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking no Tecimob. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que captam leads pelo site e pelo CRM do Tecimob. Ele conecta cada lead capturado à campanha que o originou, entregando um rastreamento de conversões imediato e preciso. Essa solução **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 leads reais por período, facilitando uma auditoria rápida e clara, sem a necessidade de dashboards complicados de serem mantidos atualizados.** A partir do webhook da sua conta Tecimob, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar leads. 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. 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 lead à campanha certa é feita pela **UTM**, e não pela plataforma. Por isso, se uma campanha capta leads por uma plataforma e outras campanhas captam por outra, cada lead é ligado automaticamente à campanha de origem. O cenário recomendado é **cada campanha atender a uma única plataforma**. ::: ## Como Plugar o OneClick Tracking no Tecimob 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto **Leads** e clique em Continuar. 5. Selecione a plataforma **Tecimob** e clique em Continuar. 6. Copie a URL do Webhook gerada pelo OneClick e cadastre-a dentro do Tecimob seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta ao Tecimob e rastreia os leads por UTM. 6.1. Acesse o painel da sua conta Tecimob e clique no ícone de **engrenagem** para abrir os **Ajustes gerais**. 6.2. No menu lateral, abra a área **Webhooks**. 6.3. Clique em **Adicionar Webhook**. 6.4. No campo **URL do Webhook**, cole a URL de rastreamento fornecida pelo OneClick. 6.5. Deixe os campos **Nome do Parâmetro do Header** e **Valor do Parâmetro do Header** em branco — veja a observação abaixo. 6.6. Clique em **Cadastrar** para confirmar. :::tip[Não há token a informar ao OneClick] O Tecimob permite enviar um header personalizado junto de cada webhook. Ele é **opcional e não é necessário** para o OneClick Tracking: não há campo para ele na nossa configuração e não há nada a configurar do seu lado. Se você já preencheu esses campos por outro motivo, pode deixá-los como estão — o envio continua funcionando. ::: :::note[Conferindo se os envios estão chegando] Na lista de webhooks do Tecimob há um ícone que abre o **registro de eventos**, com o histórico dos envios feitos para aquela URL. É por ali que você confirma que o Tecimob está disparando para o OneClick. Para editar a URL depois, use o ícone de lápis e confirme em **Editar**. ::: 6.7. De volta ao OneClick, informe as **etapas do funil** que devem contar como conversão — uma por campo, escritas como aparecem no seu funil do Tecimob. :::tip[Deixar em branco conta todo lead] Se você não informar nenhuma etapa, **todo lead recebido é contado** como conversão. Informe etapas apenas se quiser contar somente os leads que já avançaram no funil — por exemplo, contar só quem chegou em "Visita agendada" em vez de todo contato que preencheu o formulário. Maiúsculas, acentos e espaços não precisam ser idênticos: "visita agendada" e "Visita Agendada" são tratadas como a mesma etapa. ::: :::note[Se o Tecimob não enviar a etapa] Quando o envio do Tecimob não traz a etapa do lead, o OneClick registra o lead normalmente em vez de descartá-lo — assim uma configuração de etapas nunca faz você deixar de contar conversões sem perceber. ::: 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as páginas do seu site Tecimob, para que as UTMs sejam carregadas até o formulário em que o lead é capturado: a. Você pode instalar via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. b. O script precisa estar presente na página do imóvel e em qualquer landing page que anteceda o formulário de contato. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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 leads) passarão a registrar as conversões dentro do próprio gerenciador de anúncios. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** o pixel da Meta nas páginas do seu site Tecimob. - Um lead é registrado como **conversão sem valor**: diferente de uma venda, um lead não tem preço nem status de pagamento, então o OneClick Tracking conta o volume de leads e não uma receita. - **As etapas são informadas à mão.** O Tecimob não oferece uma forma de o OneClick ler a lista de funis e etapas da sua conta, então elas são digitadas na configuração. Se você renomear uma etapa no Tecimob, atualize-a aqui também. - **Cada lead é contado uma única vez.** Se o mesmo lead avançar de etapa no funil do Tecimob e isso gerar novos envios, eles são reconhecidos como o mesmo lead e não somam conversões duplicadas. - O script de passagem de UTMs **deve estar presente** em todas as páginas que antecedem o formulário de contato — é ele que carrega os parâmetros da campanha até o momento em que o lead é enviado. - 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. - Mantenha ao menos um identificador de anúncio (`ad.id`) nos parâmetros de UTM — é o que permite ao OneClick Tracking associar o lead à campanha, ao conjunto e ao anúncio corretos. Um lead que não veio de um link rastreado chega sem esses parâmetros e não pode ser atribuído a nenhuma campanha. --- # Integração Ticto Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-ticto.md > Aprenda a conectar o OneClick Tracking à Ticto via webhook para rastrear conversões reais de infoprodutos nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na Ticto. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a Ticto como plataforma de checkout e pagamento de produtos digitais. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Ticto, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar conversões. 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, Ticto e Hotmart 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. ::: ## Como Plugar o OneClick Tracking na Ticto 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto **Infoproduto** e clique em Continuar. 5. Selecione a plataforma **Ticto** e clique em Continuar. 6. Copie a URL do Webhook gerada pelo OneClick e cadastre-a dentro da Ticto seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Ticto e rastreia as conversões por UTM. 6.1. Acesse o painel da sua conta Ticto, abra o menu lateral esquerdo e clique em **Tictools**. Dentro de Tictools, clique no card **Webhooks**. 6.2. Abra a pasta em que deseja criar o webhook (ou crie uma nova em **"+ nova pasta"**) e clique em **"+ adicionar"**. 6.3. Em **URL**, cole a URL de rastreamento fornecida pelo OneClick. 6.4. Em **Versão**, selecione a **2.0**. O OneClick Tracking lê o payload da versão 2.0 — a versão 1.0 não é suportada. 6.5. Em **Formato de Envio**, selecione **JSON**. 6.6. Em **Produtos**, selecione os produtos que devem enviar eventos para esta URL. 6.7. Em **Selecione os eventos**, marque **"Venda Realizada"** (pagamento aprovado). É esse o evento que gera a conversão. 6.8. Salve o webhook. :::caution[Em "Itens a serem enviados", escolha enviar tudo junto] A Ticto pergunta se order bump e combo devem ser enviados **junto com a oferta principal** ou **separadamente**. Escolha **junto com a oferta principal**: a opção "separadamente" dispara um payload por item da mesma venda, e o OneClick Tracking registra uma conversão por pedido — então os itens separados não viram conversões adicionais. ::: :::note[Os demais eventos podem ficar marcados sem problema] O OneClick Tracking processa **apenas a venda aprovada**. Se você marcar também eventos como Abandono de Carrinho, Pix Gerado, Boleto Impresso, Aguardando Pagamento, Venda Recusada, Reembolso, Chargeback ou os eventos de assinatura, eles são recebidos e simplesmente ignorados — não geram conversão nem duplicam vendas. ::: :::tip[O campo Token é opcional para o OneClick] Ao criar o webhook a Ticto gera um **Token** que acompanha cada postback. Você não precisa informá-lo ao OneClick: não há campo para ele na nossa configuração e não há nada a configurar do nosso lado. ::: :::note[A Ticto testa a URL antes de salvar] Ao cadastrar a URL, a Ticto dispara um teste automático e só permite salvar se ele passar. A URL do OneClick responde a esse teste normalmente — se o teste falhar, confira se a URL foi colada por inteiro, sem espaços no início ou no fim. ::: 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. b. O script também deve estar presente na página de checkout da Ticto ou na landing page que antecede o checkout. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** o pixel da Meta na configuração da sua conta Ticto. - O OneClick Tracking registra a venda pelo **valor do pedido aprovado**, na moeda da sua conta de anúncios. - **Funciona para produtor, coprodutor e afiliado.** A Ticto envia o postback para cada participante da venda, e o OneClick Tracking registra a conversão qualquer que seja o seu papel — você não precisa ser o produtor do produto para rastrear os seus anúncios. O valor registrado é sempre o **valor do pedido**, e não a sua comissão. - Apenas a **primeira cobrança** de uma assinatura é registrada como conversão. As renovações seguintes são recebidas e ignoradas, para não contar a mesma venda várias vezes. - O script de passagem de UTMs **deve estar presente** na página de checkout da Ticto ou na landing page que antecede o checkout para garantir que os parâmetros UTM sejam capturados corretamente. - 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. - Mantenha ao menos um identificador de anúncio (`ad.id`) nos parâmetros de UTM — é o que permite ao OneClick Tracking associar a conversão à campanha, ao conjunto e ao anúncio corretos. Se o cliente não vier de um link rastreado, a Ticto envia as UTMs com o valor "Não Informado" e a venda não pode ser atribuída. --- # Integração Tintim Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-tintim.md > Aprenda a conectar o OneClick Tracking ao Tintim CRM para rastrear conversões de leads nas suas campanhas Meta Ads com precisão. OneClick Tracking — Integração com o Tintim :::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. ::: ## 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 criação de um lead no CRM. O OneClick Tracking captura esses dados e, quando o lead avança até o status definido como conversão dentro do Tintim, 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? 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: - O **Tintim** é quem **envia** o webhook (com os dados do lead) quando um novo lead é criado ou quando o status de um lead já existente é atualizado. - O **OneClick Tracking** é quem **recebe** esses dados e registra a conversão caso o status do lead corresponda a um dos status selecionados como conversão. --- ## Como funciona a integração (visão geral) Esta integração utiliza um **fluxo híbrido**: 1. O app OneClick Ads usa a **API do Tintim** (com `accountCode` e `accountToken`) para listar os lead statuses disponíveis na sua conta. 2. Você seleciona, dentro do OneClick Ads, quais statuses devem ser considerados conversão. 3. O **Tintim** dispara um webhook para o OneClick Tracking sempre que um lead é criado (evento `lead.create`) ou quando o status de um lead já existente é atualizado (evento `lead_source.update`). 4. O OneClick Tracking verifica se o status do lead corresponde a um dos selecionados — seja no momento da criação, seja em uma atualização posterior — e, em caso positivo, registra a conversão associando-a ao anúncio correto pelas UTMs. --- ## Passo 1 — Obter as credenciais de API do Tintim Para que o OneClick Ads consiga listar os lead statuses da sua conta Tintim, você precisará de duas credenciais: - **Código da Conta** (`accountCode`): identificador único da sua conta no Tintim. - **Token da Conta** (`accountToken`): chave de autenticação para acesso à API. Consulte a [documentação oficial da API do Tintim](https://tintim.app/documentacao/documentacao-de-api/) para localizar essas informações no painel da sua conta. --- ## Passo 2 — Configurar a integração no OneClick Tracking 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em **Nova Integração**. 4. Selecione o tipo de produto **Geração de leads** e clique em Continuar. 5. Selecione a plataforma **Tintim** e clique em Continuar. 6. Insira o **Código da Conta** e o **Token da Conta** do Tintim e clique em **Conectar**. Após a conexão, o OneClick Ads listará automaticamente todos os **lead statuses** disponíveis na sua conta Tintim. 7. Selecione quais statuses devem ser considerados **conversão** no seu negócio (por exemplo: "Qualificado", "Proposta Enviada", "Venda Fechada"). > **Importante:** um lead é registrado como conversão sempre que seu status coincidir com um dos statuses selecionados — seja no momento da criação, seja em uma atualização posterior do lead. 8. Ao finalizar, o sistema irá gerar uma **URL de webhook** exclusiva para essa integração. 9. **Copie essa URL** — você irá usá-la no próximo passo. --- ## Passo 3 — Configurar o webhook no Tintim O Tintim precisa ser configurado para enviar o evento `lead.create` (e, opcionalmente, `lead_source.update`) para a URL gerada pelo OneClick Tracking. Consulte a [documentação oficial de webhooks do Tintim](https://tintim.app/documentacao/documentacao-de-webhooks/) para o passo a passo completo. Em linhas gerais: 1. Acesse sua conta no **Tintim** e vá até a área de **Configurações de Webhooks** (ou Integrações). 2. Crie um novo webhook e selecione o evento **`lead.create`**. Se você também quiser capturar conversões quando o status de um lead já existente mudar (não apenas na criação), selecione também o evento **`lead_source.update`**. 3. Cole a **URL de webhook** gerada no Passo 2 no campo de URL de destino. 4. Salve a configuração. > **Atenção:** o OneClick Tracking processa os eventos `lead.create` e `lead_source.update`. Selecione o(s) evento(s) correspondente(s) ao configurar o webhook no Tintim, de acordo com o que você deseja rastrear. --- ## Passo 4 — Configurar as UTMs nos anúncios 1. Copie o **Script de UTM** gerado dentro do OneClick Tracking. ![image2](../../../../../public/oneclick-tracking/common/image-2.png) 2. Insira no campo **Parâmetros de URL** dentro de **todos** os seus anúncios no gerenciador de anúncios: ![image3](../../../../../public/oneclick-tracking/common/image-3.png) --- ## Passo 5 — Instalar o Script de Passagem de UTMs Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas automaticamente para dentro dos leads criados no Tintim. - Você pode instalar no seu site via **Google Tag Manager** ou, preferivelmente, instalando diretamente no **header** do seu site. --- ## Passo 6 — Definir o Modo de Atribuição e Nomenclatura 1. Defina o **Modo de Atribuição**. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image4](../../../../../public/oneclick-tracking/common/image-4.png) 2. 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. ::: ![image5](../../../../../public/oneclick-tracking/common/image-5.png) ![image6](../../../../../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. ![image7](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - O OneClick Tracking processa os eventos **`lead.create`** e **`lead_source.update`** do Tintim — ou seja, tanto a criação de um lead quanto uma atualização posterior do seu status podem gerar uma conversão. Eventos de exclusão de leads não são processados. - Um lead é registrado como conversão sempre que seu status corresponder a um dos statuses selecionados, seja no momento da criação, seja em uma atualização posterior. - As UTMs precisam estar presentes nos leads do Tintim para que a atribuição funcione. Confirme que os formulários de captura de lead estão enviando esses dados corretamente. - Cada conta de anúncios possui uma URL de webhook exclusiva. Se você gerencia múltiplas contas, crie uma integração separada para cada uma. - 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. --- ## Referências - [Documentação de Webhooks do Tintim](https://tintim.app/documentacao/documentacao-de-webhooks/) - [Documentação de API do Tintim](https://tintim.app/documentacao/documentacao-de-api/) --- # Integração Wbuy Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-wbuy.md > Aprenda a conectar o OneClick Tracking à Wbuy para rastrear conversões de vendas de e-commerce nas suas campanhas Meta Ads com base nas UTMs. > Aprenda a configurar o OneClick Tracking na Wbuy. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Wbuy como plataforma de e-commerce. Ele oferece um rastreamento de conversões imediato e preciso. **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. ::: ## Como Plugar o OneClick Tracking na Wbuy 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "E-Commerce" e clique em Continuar. 5. Selecione a plataforma "Wbuy" e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da plataforma seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Wbuy e rastreia a origem das conversões. ## Configuração do Webhook na Wbuy 6.1. Acesse sua conta **Wbuy**. a. No painel administrativo da Wbuy, vá até **Configurações >> Integrações >> Webhooks**. 6.2. Crie um novo Webhook. a. Clique em **Novo Webhook** ou **Adicionar Webhook**. ![image3](../../../../../public/oneclick-tracking/wbuy/image-1.png) b. Cole a URL de rastreamento fornecida pelo OneClick no campo de URL. c. Escolha o evento de **Pedidos** (order). ![image4](../../../../../public/oneclick-tracking/wbuy/image-2.png) d. Selecione o formato **JSON** e clique em **Salvar**. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** seu pixel na configuração da Wbuy. - O OneClick Tracking considera como conversão os pedidos cujo status no painel da Wbuy seja **"Pagamento Efetuado"** ou **"Pagamento em Análise"**. Demais status (pendente, cancelado, etc.) não são contabilizados. - As UTMs devem estar presentes nas URLs dos anúncios e ser passadas até a página de checkout para que o rastreamento funcione. --- # Integração Xgrow Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-xgrow.md > Aprenda a conectar o OneClick Tracking à Xgrow via webhook para rastrear conversões reais de infoprodutos e áreas de membros nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na Xgrow. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a Xgrow como plataforma de infoprodutos, comunidades e áreas de membros. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Xgrow, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar conversões. 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, Xgrow e Hotmart 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. ::: ## Como Plugar o OneClick Tracking na Xgrow 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto **Infoproduto** e clique em Continuar. 5. Selecione a plataforma **Xgrow** e clique em Continuar. 6. Copie a URL do Webhook gerada pelo OneClick e cadastre-a dentro da Xgrow seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Xgrow e rastreia as conversões por UTM. 6.1. Acesse sua conta Xgrow e vá até **Ferramentas → Recursos → Integrações**. 6.2. Clique em **Nova integração** e selecione a opção **Webhook**. 6.3. Dê um nome para a integração (por exemplo, `OneClick Tracking`) e cole a URL de rastreamento fornecida pelo OneClick no campo de URL do webhook. 6.4. Selecione o evento de **compra aprovada** como gatilho. É o evento que a Xgrow dispara quando o pagamento é confirmado — depois da aprovação do cartão, da confirmação do Pix ou da compensação do boleto. O OneClick Tracking processa apenas compras aprovadas: eventos de lead, carrinho abandonado, boleto/Pix gerado, recusa, reembolso, chargeback e cancelamento são ignorados automaticamente. 6.5. Salve a integração. a. Você não precisa enviar eventos de teste — basta finalizar a configuração na Xgrow. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. b. O script também deve estar presente na página de checkout da Xgrow ou na landing page que antecede o checkout. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** o pixel da Meta na configuração da sua conta Xgrow. - Como a Xgrow também trabalha com **assinaturas e áreas de membros**, o OneClick Tracking registra apenas a **primeira compra aprovada** de cada venda. As renovações seguintes da mesma assinatura não são contadas como novas conversões, para não inflar o seu ROAS. - O script de passagem de UTMs **deve estar presente** na página de checkout da Xgrow ou na landing page que antecede o checkout para garantir que os parâmetros UTM sejam capturados corretamente. - 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. - Mantenha ao menos um identificador de anúncio (`ad.id`) nos parâmetros de UTM — é o que permite ao OneClick Tracking associar a conversão à campanha, ao conjunto e ao anúncio corretos. --- # Integração Yampi Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-yampi.md > Aprenda a conectar o OneClick Tracking à Yampi para rastrear conversões de vendas de e-commerce nas suas campanhas Meta Ads com precisão via UTM. > Aprenda a configurar o OneClick Tracking na Yampi. O **OneClick Tracking** é uma nova funcionalidade voltada para anunciantes da Meta Ads que usam a Yampi como gateway de pagamento. Ele oferece um rastreamento de conversões imediato e preciso. **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. ::: ## Como Plugar o OneClick Tracking na Yampi 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "E-Commerce" e clique em Continuar. 5. Selecione a plataforma "Yampi" e clique em Continuar. 5.1. Insira o Alias da sua loja. a. Dentro da plataforma Yampi, clique no botão do canto superior direito (logo da sua loja) >> "Credenciais de API" >> Copie o "Alias" e cole no campo do OneClick Tracking. Depois, clique em continuar. 6. Copie a URL do Webhook e insira dentro da plataforma seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Yampi e rastreia a origem das conversões. 6.1. Acesse sua conta Yampi. a. Vá até **Configurações >> Webhooks >> Novo Webhook** no menu da Yampi. ![image2](../../../../../public/oneclick-tracking/yampi/image-1.png) 6.2. Crie um novo Webhook. a. Cole a URL de rastreamento fornecido pelo OneClick no campo de URL. ![image3](../../../../../public/oneclick-tracking/yampi/image-2.png) b. Escolha os eventos: - "Pedido criado" - "O status de um pedido foi atualizado" - "Pedido atualizado" - "Pedido aprovado" ![image4](../../../../../public/oneclick-tracking/yampi/image-3.png) c. Clique em "Salvar". 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** seu pixel na configuração da Yampi. --- # Integração Zouti Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-zouti.md > Aprenda a conectar o OneClick Tracking à Zouti via webhook para rastrear conversões reais de infoprodutos nas suas campanhas Meta Ads. > Aprenda a configurar o OneClick Tracking na Zouti. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a Zouti como plataforma de checkout de infoprodutos. Ele oferece um rastreamento de conversões imediato e preciso. Essa solução **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.** A partir do webhook da sua conta Zouti, o OneClick considera dados das UTM's, bem como os da Meta, sem duplicar conversões. Cada conta de anúncios recebe um link único e é possível **vincular múltiplos produtos (order bumps, downsells ou upsells)**. 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. ::: ## Como Plugar o OneClick Tracking na Zouti 1. Acesse sua conta OneClick Ads. 2. 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) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto e clique em Continuar. a. Infoproduto b. E-Commerce 5. Selecione a plataforma **Zouti** e clique em Continuar. 6. Copie a URL do Webhook e insira dentro da Zouti seguindo o passo-a-passo abaixo: a. Cada conta de anúncios terá um link único gerado automaticamente. b. Esse link é o que conecta sua conta à Zouti e rastreia as conversões por UTM. 6.1. Acesse sua conta [Zouti](https://app.zouti.com.br) e vá até **Configurações > Webhooks**. > Consulte também a [documentação oficial da Zouti sobre webhooks](https://ajuda.zouti.com.br/pt-br/articles/9740950-como-configurar-webhook) para mais detalhes sobre a tela de configuração. 6.2. Clique em **Adicionar Webhook** (ou edite um webhook existente). a. Cole a URL de rastreamento fornecida pelo OneClick no campo de URL do Webhook. b. Em **Eventos**, selecione os eventos de **Pedidos** (categoria **Orders**). O OneClick Tracking processa apenas pedidos com status `PAID` — outros tipos de evento são ignorados automaticamente. c. Sugerimos ativar o tracking apenas para o produto principal de cada funil. Se quiser adicionar outros produtos, repita os passos criando um novo webhook para cada produto separadamente. 6.3. Salve a configuração. a. Você não precisa enviar eventos de teste — basta finalizar a configuração na Zouti. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. b. O script também deve estar presente na página de checkout da Zouti ou na landing page que antecede o checkout. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. 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. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../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. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Instale e mantenha** o pixel da Meta na configuração da sua conta Zouti. - **Sugestão**: Evite enviar dados de order bumps ou upsells para manter a otimização limpa do produto de entrada. De qualquer modo, você pode criar webhooks também para produtos adicionais apontando para o mesmo link. - O script de passagem de UTMs **deve estar presente** na página de checkout da Zouti ou na landing page que antecede o checkout para garantir que os parâmetros UTM sejam capturados corretamente. - 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. - Se quiser, você pode vincular múltiplos produtos apontando para o mesmo link de Webhook fornecido pelo OneClick Ads. --- # Modos de Atribuição Source: https://docs.oneclickads.com.br/pt-br/oneclick-tracking/modos-de-atribuicao.md > Entenda os modos de atribuição do OneClick Tracking — 100% UTM, atribuição por jornada e personalizada — como escolher, como o sistema combina dados do Gerenciador e das UTMs, e como alterar depois. > Como o OneClick Tracking decide quais conversões considerar nas otimizações. O **modo de atribuição** define como o OneClick combina os dados de conversão do **Gerenciador de Anúncios da Meta** com os dados rastreados via **UTM** pelo OneClick Tracking. Essa escolha influencia diretamente as decisões de pausa e escala. [Assista a este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo em detalhe. ## Como definir o modo de atribuição? Existem **quatro opções**: ### 1. 100% UTM As otimizações são baseadas **totalmente** no OneClick Tracking (conversões rastreadas por UTM). ### 2. Atribuição do Gerenciador de Anúncios As otimizações são baseadas **totalmente** nos dados de conversão do Gerenciador de Anúncios da Meta — o OneClick Tracking não entra no cálculo. ### 3. Atribuição por jornada (recomendada) Mistura os dados do Gerenciador e das UTMs, na proporção **90% Gerenciador / 10% UTM**. É a **recomendação geral**. - Sempre que as conversões **via UTM forem maiores** do que as conversões do Gerenciador, a leitura passa a considerar **apenas UTM**; - Se o número de conversões via UTM for **igual a 0**, este modelo considera **100% das conversões do Gerenciador**; - Nos demais casos, a leitura mistura as duas fontes para refletir a participação na jornada além do _last-click_. ### 4. Personalizada Você define **manualmente a proporção** entre as duas fontes (por exemplo, 50/50). ## Por que o tracking pode mostrar mais conversões do que outras ferramentas? O método de leitura e associação de UTM do OneClick pode **capturar eventos que outras ferramentas perdem**, resultando em contagens superiores em alguns casos comparativos. ## É possível alterar o modo de atribuição depois de configurado? Sim. O modo de atribuição pode ser **editado a qualquer momento**. Após concluir a alteração, o comportamento de otimização passa a considerar o novo modelo **já nos próximos ciclos**. --- # Otimizações — Campanhas Meta Ads com OneClick Ads Source: https://docs.oneclickads.com.br/pt-br/otimizacoes.md > Guias sobre a inteligência artificial de otimização do OneClick Ads: sistema de sufixos automáticos, perfis de pausa e escala, controle por tags manuais, parametrização de CPA e ROAS, e boas práticas para reduzir CPA e aumentar conversões. Guias sobre a inteligência artificial de otimização do OneClick Ads — otimizações automáticas, sufixos, controle de campanhas e boas práticas. ## Artigos - [Sistema de Sufixos](/pt-br/otimizacoes/sistema-de-sufixos/) - [Personalizando a Tag de Otimização](/pt-br/otimizacoes/personalizando-a-tag-de-otimizacao/) - [Controlando a Atuação do OneClick Ads nas Campanhas](/pt-br/otimizacoes/controlando-a-atuacao-do-oneclick-ads-nas-campanhas/) - [Pausas e Proteção](/pt-br/otimizacoes/pausas-e-protecao/) - [Controle de Horário de Campanhas](/pt-br/otimizacoes/controle-de-horario-de-campanhas/) - [Relatório de Inteligência Diária](/pt-br/otimizacoes/relatorio-de-inteligencia-diaria/) - [Boas Práticas para Usar e Medir a Performance](/pt-br/otimizacoes/boas-praticas-para-usar-e-medir-a-performance-do-oneclick-ads/) - [Como Parametrizar Campanhas](/pt-br/otimizacoes/como-parametrizar-campanhas/) - [Definindo Limite Mensal de Investimento da Conta de Anúncios](/pt-br/otimizacoes/definindo-limite-mensal-de-investimento-da-conta-de-anuncios/) --- # Boas práticas para usar e medir a performance do OneClick Ads Source: https://docs.oneclickads.com.br/pt-br/otimizacoes/boas-praticas-para-usar-e-medir-a-performance-do-oneclick-ads.md > Guia completo para medir e comprovar os resultados do OneClick Ads: amostragem mínima de campanhas, como interpretar sufixos, criar relatórios comparativos e avaliar o impacto no CPA e nas conversões. > Para acompanhar os resultados gerados pelo OneClick Ads nas suas campanhas, siga este guia. O **OneClick Ads** ajuda você a simplificar a gestão de campanhas e otimizar resultados de forma automática. Para entender se está funcionando bem na sua conta, siga este guia dividido em três etapas. Assista ao vídeo abaixo para ter todos os detalhes: ## 1. Tenha uma amostragem relevante de dados O OneClick Ads precisa de **volume estatístico** para que os resultados sejam significativos. Por isso: ✅ **Boas práticas:** - Mantenha **pelo menos 5 campanhas ativas**. - **Duplique campanhas que já funcionam bem** — não é necessário criar tudo do zero. - **Use as campanhas validadas**: no menu lateral do OneClick Ads, você encontra o item Campanhas Validadas com sugestões de estruturas já otimizadas. - Configure **no mínimo 3 conjuntos de anúncios por campanha**. - Adicione **muitos anúncios em cada conjunto** (15, 20 ou mais, se desejar). 💡 **Dica:** quanto mais ativos (campanhas, conjuntos e anúncios) você entregar, mais oportunidades a nossa IA terá para otimizar. --- ## 2. Deixe o OneClick trabalhar sem interrupções A inteligência artificial do OneClick Ads foi projetada para **otimizar automaticamente** suas campanhas, aprendendo com o desempenho de cada ativo. ### O que você deve fazer: - Evite interferências constantes: o sistema pausa campanhas, ajusta orçamentos e duplica ativos de forma planejada. - Sempre que necessário, ajuste a **parametrização**: - Defina custo por conversão máximo. - Escolha se quer um comportamento mais **agressivo** (escala) ou mais **conservador** (eficiência). - Se uma campanha for pausada, verifique no **Sistema de Sufixos**: - Toda ação feita pela nossa IA aparece como sufixo no nome do ativo. - Lá você consegue entender se a pausa é temporária e qual foi o raciocínio por trás da decisão. - Esse recurso está disponível no menu lateral, na opção _Sistema de Sufixos_. ℹ️ **Nota:** as pausas temporárias são reativadas automaticamente no dia seguinte. --- ## 3. Crie relatórios de resultados A análise deve ser feita com base em dados consistentes, sempre comparando períodos e campanhas. ### 🔍 Análise 1: Comparar campanhas com e sem OneClick - No **Gerenciador de Anúncios da Meta**, clique em **Criar Relatório**. - Substitua a coluna _Nome da Campanha_ por _Dia_, para visualizar os resultados **dia a dia**. - Remova colunas irrelevantes e mantenha apenas: - **Compras (ou Leads)** - **Custo por Compra (ou Custo por Lead)** - **Valor gasto** - Selecione o período **desde a ativação do OneClick**. - Salve o relatório e compartilhe o link com seu **gerente de contas** caso queira suporte na interpretação. Exemplo prático do que observar: - Antes do OneClick: CPA médio de R$170 com ~100 conversões/dia. - Depois do OneClick: CPA de R$90 e mais de 200 conversões/dia. Você pode ainda **duplicar o relatório**: - Um relatório **com OneClick ON**. - Outro relatório **sem OneClick ON**. Assim, fica fácil comparar desempenho. ### 🔍 Análise 2: Avaliar a performance global da conta Além das campanhas individuais, verifique se: - Sua **conta como um todo** está escalando mais conversões. - O **CPA médio da conta** está diminuindo ao longo do tempo. 💡 **Exemplo de funil:** Antes do OneClick, 8 a 15 vendas/dia com CPA de até R$200. Após ativação, 30 a 40 vendas/dia com CPA de R$31–40. --- ## 4. Acompanhe notificações de performance O OneClick Ads também conta com um **sistema de notificações automáticas** que informa quando há **ganho de performance relevante** nas suas campanhas. Essas notificações aparecem diretamente na plataforma e também são enviadas por **e-mail**, permitindo que você acompanhe os resultados sem precisar estar logado o tempo todo. Assim, você tem mais visibilidade sobre os impactos positivos da nossa inteligência artificial e pode reagir rapidamente sempre que necessário. --- ## 5. Testes de criativo Testar criativos com método ajuda a nossa IA a encontrar os melhores anúncios sem prejudicar a escala. ### Estrutura recomendada (maior controle) Uma estrutura recomendada é o teste em **ABO** com **replicação do mesmo anúncio** dentro do conjunto (ex.: **3 réplicas do mesmo criativo por conjunto**). Isso aumenta a chance de distribuição consistente e reduz o efeito de variações de entrega. ### Quantos conjuntos por campanha? Uma prática comum é manter as campanhas de teste com **até 10 conjuntos**, para facilitar performance e distribuição, rodando criativos em **lotes** (ex.: 10 por semana) quando há volume grande de peças. ### Como alocar verba sem prejudicar a escala Reserve uma **parcela fixa do orçamento diário para testes** (ex.: **25%**) e mantenha o restante em campanhas de escala. Em testes, trabalhe em **lotes** (até 10 conjuntos por campanha) para manter consistência e reduzir distorções por sazonalidade ou variação do período. --- ## Conclusão Para analisar corretamente os resultados do OneClick Ads: - **Garanta amostragem mínima**: 5 campanhas ativas, 3 conjuntos por campanha e múltiplos anúncios. - **Deixe a IA operar** e use parametrizações para alinhar seus objetivos (escala ou eficiência). - **Crie relatórios comparativos** semanais e avalie também o impacto na performance global da conta. 👉 Seguindo esse método, você terá clareza sobre a real contribuição do OneClick Ads e poderá escalar campanhas com eficiência. --- # Como Parametrizar Campanhas Source: https://docs.oneclickads.com.br/pt-br/otimizacoes/como-parametrizar-campanhas.md > Aprenda a configurar os parâmetros de otimização do OneClick Ads: perfis de pausa e escala, custo por conversão, ROAS mínimo, orçamento máximo e limite mensal. > Aprenda tudo sobre a tela de parametrização de campanhas do OneClick Ads Aprenda como configurar corretamente os parâmetros das suas campanhas para que a IA do OneClick Ads otimize e maximize seus resultados. A parametrização do OneClick Ads funciona como o **prompt que você dá no GPT** — são esses parâmetros que vão definir o comportamento total da nossa IA para otimização e maximização dos resultados das suas campanhas. --- ## Perfis de Otimização Os perfis de otimização definem **como o OneClick Ads vai pausar e escalar** suas campanhas. Você encontra essas opções no bloco de cada campanha, antes de ativar as otimizações. ### Comportamento de Pausa Você tem duas opções de pausa: **1. Pausa Rigorosa** Pausa a campanha assim que atingir o CPA definido. É mais rápida e direta. **2. Pausa Flexível (Padrão)** Espera um pouco mais antes de pausar. A campanha roda por mais tempo antes de ser interrompida. ### Comportamento de Escala Você tem duas opções de escala: **1. Escala Acelerada** Contempla otimizações intraday (hora em hora), com maior frequência, velocidade e agressividade. **2. Escala Conservadora (Padrão)** Sem otimização de hora em hora. Os ajustes são mais gradativos e lentos. ### Combinações Possíveis Com essas opções, você tem **4 perfis de otimização** possíveis: | Perfil | Pausa | Escala | | -------- | -------- | ------------ | | Perfil 1 | Rigorosa | Acelerada | | Perfil 2 | Rigorosa | Conservadora | | Perfil 3 | Flexível | Acelerada | | Padrão | Flexível | Conservadora | ⚠️ **IMPORTANTE:** Após as primeiras otimizações serem executadas (em média, após 1 hora), o perfil de otimização **não pode mais ser alterado**. Isso é necessário para não atrapalhar a inteligência da IA. Para testar outro perfil, você precisará criar uma nova campanha. --- ## Onde Definir o Perfil de Otimização Você pode definir o perfil de otimização em **dois níveis**: ### 1. A nível de Campanha Diretamente no bloco da campanha específica que você deseja configurar. ### 2. A nível de Conta Nas **Configurações de Conta de Anúncios** (ícone de engrenagem). Ao definir aqui, todas as novas campanhas que aparecerem na listagem já virão com esse perfil pré-configurado. --- ## Teste AB para Verificar o Melhor Perfil pra Sua Conta Se você está na dúvida sobre qual perfil usar, sugerimos o seguinte teste: - Crie uma **campanha principal** no formato 1x ou 1x3 (consulte o artigo sobre campanhas validadas) - Mantenha essa campanha no **modelo padrão** (Pausa Flexível + Escala Conservadora) - **Replique essa campanha 3 vezes**, variando os perfis de otimização em cada uma - Teste os 4 perfis simultaneamente e verifique qual funciona melhor para sua conta, projeto e momento 💡 **Dica:** Se estiver começando, use o modelo padrão (Pausa Flexível + Escala Conservadora) que já vem configurado. --- ## Campos de Parametrização Abaixo dos perfis de otimização, você encontra os campos de parametrização. Pense neles como o **prompt que você dá à nossa IA**: são esses valores que definem o comportamento da inteligência artificial para otimizar e maximizar os resultados da campanha. Cada campo abaixo é explicado em três partes — **o que é**, **o que ele representa para a IA** e **como definir o valor ideal**. ### 1. Valor de Venda do Produto Anunciado **O que é:** o valor de venda do produto que você está anunciando nessa campanha. **O que representa para a IA:** é a base que a inteligência usa para avaliar se o investimento em cada estrutura está valendo a pena. Ele também serve de referência para os avisos do campo de custo por conversão (veja a seção seguinte) e para o cálculo de ROAS, quando essa otimização está ativa. **Como definir:** - **Infoproduto:** coloque o valor exato do produto (ex.: R$ 300). - **E-commerce:** coloque o **ticket médio** da sua loja ou do produto anunciado (ex.: R$ 240). - **Campanhas de Geração de Leads:** este campo **não aparece** — campanhas de leads são otimizadas pelo custo por lead, não pelo valor de venda. 💡 **E se existem vários kits e preços?** Use o **ticket médio** da loja (a média do seu e-commerce/plataforma), obtido no seu sistema de vendas (Shopify, Tray, etc.). A configuração é baseada no **valor médio real** de pedidos — não no maior ou no menor kit isoladamente. ### 2. Custo por Conversão para Pausar (Conjunto de Anúncios) **O que é:** o **principal parâmetro de otimização** do OneClick Ads — o seu **stop loss**. É o custo máximo que você aceita pagar por uma conversão (ou por um lead, em campanhas de geração de leads). **O que representa para a IA:** esse valor define **três faixas de comportamento** que orientam todas as decisões da inteligência: - **Custo Ideal (até 80% do valor):** enquanto o custo por conversão estiver até ~80% do que você definiu, a IA entende que há margem e **aumenta o orçamento** (escala) para capturar mais resultado. - **Faixa de manutenção (entre 80% e 100%):** o investimento é **mantido**, pois a estrutura está performando dentro do aceitável. - **Acima de 100%:** a estrutura é **pausada** para proteger seu investimento. ℹ️ **Importante — fase de aprendizado:** para coletar dados e seguir as melhores práticas da Meta Ads, a IA pode **extrapolar** esse limite nas **primeiras 7 conversões** de um conjunto, tolerando um custo de até ~1,6× o valor definido antes de pausar. Isso evita pausas precoces antes de a Meta encontrar o público ideal. A partir da 7ª conversão, a pausa passa a respeitar o valor que você inseriu. **Como definir (boas práticas):** - Verifique a **média de CPA da sua conta** nos últimos 30 dias para esse produto/tipo de campanha. - **Acrescente cerca de 25% a 30%** sobre essa média. - Use esse valor como Custo por Conversão para Pausar. **Exemplo prático:** - Média de CPA nos últimos 30 dias: R$ 100. - Cálculo: R$ 100 + 25% = **R$ 125**. - Coloque R$ 125 como Custo por Conversão para Pausar. **Por que fazer isso?** Ao definir R$ 125, você dá à IA margem para escalar: o Custo Ideal de trabalho fica em torno de **R$ 100** (80% de R$ 125), e a inteligência maximiza as estruturas que estão bem mais baratas que o teto, pausando apenas o que ultrapassa R$ 125. ⚠️ **Não defina um valor baixo demais.** A nossa IA é precisa e vai pausar exatamente na faixa que você definir. Um CPA máximo **abaixo do viável** para o seu funil gera pausas por proteção com **muito mais frequência** e sufoca a campanha antes de ela aprender. Como referência, a plataforma avisa quando o valor é **menor que 1/4 do ticket médio** ("valor inserido baixo, a campanha pode não ter resultado"). ⚠️ **Não defina um valor acima do ticket médio.** Pagar por conversão mais do que o produto vale inviabiliza o retorno. A plataforma também avisa quando o custo por conversão informado é **maior que o Valor de Venda**. 💡 **Em testes**, quando você precisa de mais amostragem, é aceitável definir um CPA máximo **um pouco mais alto** para permitir mais volume antes de pausar — e reduzir depois, conforme entende como o OneClick Ads trabalha na sua operação. **Exemplo (produto barato, CPA aceitável maior):** se o produto custa **R$ 19**, mas o CPA máximo aceitável é **R$ 55**, configure: _Valor de Venda_ = R$ 19 e _Custo por Conversão para Pausar_ = R$ 55. O sistema mede a performance com base no valor do produto e respeita o limite de CPA informado para as decisões de pausa. --- ### 3. Otimização por Retorno sobre Investimento (ROAS) **O que é:** uma forma alternativa de otimizar. Em vez de pausar pelo custo por conversão (CPA), a IA passa a pausar pelo **retorno sobre o investimento em anúncios (ROAS)**. Marque o checkbox **"Otimizar por ROAS"** e o campo de custo dá lugar a **"ROAS mínimo para PAUSAR os anúncios"**. **O que representa para a IA:** o ROAS mínimo é o piso de retorno aceitável. Estruturas com ROAS **acima** do valor continuam rodando e podem ser escaladas; estruturas com ROAS **abaixo** do valor são pausadas para proteger o retorno. **Como definir:** - Informe o múltiplo de retorno que você almeja para o projeto (valor mínimo aceito: **0,1**). - **Exemplo:** para um ROAS alvo de **3,5x**, coloque `3.5`. Campanhas com ROAS acima de 3,5 seguem ativas; abaixo disso, são pausadas. **Quando usar cada otimização:** - **Otimização por CPA:** ideal para infoprodutos e produtos com valor fechado/definido. - **Otimização por ROAS:** ideal para e-commerces e operações onde o retorno sobre investimento é a métrica principal. 📌 **Observações importantes:** - A otimização por ROAS é válida **apenas para campanhas de vendas** (não aparece em campanhas de geração de leads). - CPA e ROAS são **mutuamente exclusivos**: ao ativar o ROAS, o campo de CPA é desativado, e vice-versa. - Assim como o perfil de otimização, a escolha entre CPA e ROAS **não pode ser alterada após as primeiras otimizações** da campanha. --- ### 4. Orçamento Diário Máximo Este é o campo que mais gera dúvidas, então vale entendê-lo com calma. **O que é:** o **teto de escala** da campanha — o valor diário máximo que a IA está autorizada a alcançar **quando a performance está boa**. **O que ele NÃO é:** ele **não** é o orçamento inicial da campanha. O orçamento de partida continua sendo o que você definiu na Meta. O Orçamento Diário Máximo é apenas o **limite até onde a IA pode subir** esse orçamento ao escalar. Em outras palavras: a campanha começa no orçamento configurado na Meta e, conforme converte barato (abaixo do Custo Ideal), a inteligência aumenta o orçamento dia após dia — **mas nunca acima desse teto**. **O que representa para a IA:** - A IA só escala uma estrutura **até** esse valor. Se uma escala (inclusive a escala intraday, de hora em hora) ultrapassar o teto, a inteligência **corrige automaticamente** o orçamento de volta para o limite que você definiu. - Se você **reduzir** o teto depois de uma escala já ter acontecido, a IA também ajusta o orçamento para respeitar o novo valor. - Valor mínimo aceito: **R$ 7**. **Onde ele se aplica (ABO vs CBO):** o OneClick Ads identifica automaticamente o tipo de campanha criada na Meta e ajusta o campo: - **Campanha ABO:** aparece como "Orçamento Diário Máximo **por Conjunto** (ABO)" — o teto vale para **cada conjunto de anúncios** individualmente. - **Campanha CBO:** aparece como "Orçamento Diário Máximo **da Campanha** (CBO)" — o teto vale para a **campanha como um todo**. **Como definir (boas práticas):** - Defina o máximo que faz sentido investir **por dia** naquela estrutura quando ela está performando bem. Ex.: se R$ 300/dia por conjunto é o limite saudável da sua operação, use R$ 300. - Pense no teto como uma **trava de segurança contra escalas agressivas**, não como uma meta. A IA só chega lá se a performance justificar. - Se você já definiu um **Limite de Investimento Mensal na conta** (veja abaixo), normalmente **não precisa** preencher o teto por campanha — ele se torna opcional, e a conta inteira passa a respeitar o teto mensal. --- ## Escala Ilimitada vs Escala Limitada O preenchimento (ou não) do Orçamento Diário Máximo define dois modos de escala: ### Escala Limitada Defina um valor no Orçamento Diário Máximo (ex.: R$ 300). A estrutura **não ultrapassará** esse orçamento diário, mesmo com performance excelente. Use quando quiser **controle rígido** do investimento por campanha/conjunto. ### Escala Ilimitada Marque a opção **"Escala Ilimitada"** (ou deixe o teto em branco quando há limite mensal na conta). A IA pode **escalar o orçamento sem um teto fixo por campanha**, de acordo com a performance — sempre respeitando o **limite mensal da conta**, se houver. ⚠️ Ao ativar a Escala Ilimitada, a inteligência pode aumentar o orçamento diário **significativamente** com base na performance. Use quando seu objetivo é **máxima escala** e você confia no limite mensal da conta como proteção. 💡 **Gestão inteligente de verba:** se uma campanha for pausada por baixa performance, o orçamento é **liberado automaticamente** para outras campanhas que estão performando bem. Essa redistribuição acontece de forma inteligente entre todas as campanhas da conta. --- ## Limite de Investimento Mensal da Conta Nas **Configurações de Conta de Anúncios** (ícone de engrenagem), você pode definir um **limite de investimento mensal** — o teto de gasto da conta inteira no mês. **Exemplo:** - Limite mensal: R$ 30.000. - Isso equivale a aproximadamente R$ 1.000/dia de investimento máximo. **Vantagem:** ao definir esse limite, o Orçamento Diário Máximo de cada campanha se torna **opcional**. A IA escala o que estiver barato em toda a conta, respeitando o teto mensal — sem você precisar configurar um teto campanha por campanha. **Como os dois limites se relacionam:** - **Com limite mensal definido:** a Escala Ilimitada fica disponível por padrão; o teto diário por campanha vira opcional (marque "Definir Orçamento Diário Máximo" só se quiser um teto específico para aquela campanha). - **Sem limite mensal definido:** para se proteger, você precisa definir um **Orçamento Diário Máximo** em cada campanha **ou** assumir explicitamente a **Escala Ilimitada**. --- ## Resumo: Passo a Passo da Parametrização - **Escolha o Perfil de Otimização** (Pausa + Escala) ou mantenha o padrão. - **Informe o Valor de Venda** do produto ou ticket médio. - **Defina o Custo por Conversão para Pausar** (média dos últimos 30 dias + 25% a 30%) — ou ative o **ROAS mínimo**. - **Configure o Orçamento Diário Máximo** (teto de escala) ou deixe-o ilimitado, se tiver um limite mensal definido na conta. - **Clique em Otimizar** (botão verde) para ativar as otimizações. --- ## Boas Práticas - Se está começando, use o **modelo padrão** (Pausa Flexível + Escala Conservadora). - Faça **testes AB com os 4 perfis** para descobrir o ideal para sua operação. - Nunca defina o Custo por Conversão para Pausar **muito baixo** (nem abaixo de 1/4 do ticket médio) — isso causa pausas prematuras. E nunca acima do **Valor de Venda**. - Lembre-se do funcionamento em faixas: a IA **escala** até ~80% do custo definido, **mantém** entre 80% e 100% e **pausa** acima de 100%. - Trate o **Orçamento Diário Máximo** como uma trava de segurança (teto de escala), não como orçamento inicial. - Defina um **limite mensal na conta** para ter mais flexibilidade e dispensar o teto campanha a campanha. - Lembre-se: após as primeiras otimizações, o **perfil** e a escolha entre **CPA e ROAS** não podem mais ser alterados. --- # Controlando a Atuação do OneClick Ads nas campanhas Source: https://docs.oneclickads.com.br/pt-br/otimizacoes/controlando-a-atuacao-do-oneclick-ads-nas-campanhas.md > Saiba como usar tags manuais ([manual], [não-duplicar], [ativo-diariamente], [intraday]) para controlar quais campanhas, conjuntos e anúncios o OneClick Ads pode otimizar. > Aprenda como ter total controle sobre suas campanhas e, ainda assim, utilizar o OneClick Ads para maximizar seus resultados. ## Como bloquear a atuação da IA do OneClick Ads com tags manuais Saiba como impedir que o OneClick Ads atue em campanhas, conjuntos ou anúncios específicos usando **tags manuais**, garantindo controle total sobre sua operação. ## O que é essa funcionalidade? Essa funcionalidade permite que você **bloqueie ações automáticas da IA** do OneClick Ads em estruturas específicas — como campanhas, conjuntos (adsets) e anúncios — apenas escrevendo uma **tag no nome** desses itens. --- ## Quando usar? Você pode usar essa função em diversas situações. Veja alguns exemplos: ### 1. **Evitar reativação de anúncios antigos** Anúncios sazonais (como Black Friday) que não devem mais rodar. ### 2. **Impedir atuação em conjuntos com leads desqualificados** Mesmo que o custo por lead esteja baixo, você quer manter um conjunto pausado manualmente. ### 3. **Executar testes manuais** Você está fazendo um teste controlado com um criativo ou conjunto específico e não quer interferência da IA. --- ## Como funciona? Basta **incluir a tag entre colchetes** (`[ ]`) no nome da campanha, conjunto ou anúncio. Assim que o OneClick Ads identificar a tag, ele deixa de atuar naquele item. Duas coisas facilitam a sua vida: - **Tanto faz maiúscula ou minúscula.** Escrever `[manual]`, `[MANUAL]` ou `[Manual]` dá exatamente no mesmo — o OneClick Ads reconhece a tag de qualquer jeito. - **A tag pode ficar em qualquer parte do nome** — no começo, no meio ou no fim. O que importa é que ela apareça entre colchetes. > ⚠️ Escreva a tag **exatamente como mostrada aqui**, mantendo os acentos e os hífens (por exemplo, `[não-duplicar]`). Apenas as maiúsculas e minúsculas são flexíveis. ### Tipos de tags disponíveis ## 1. `[manual]` — bloqueia tudo **O que faz:** impede **todas as ações automáticas** da IA (duplicação, escala de orçamento e pausa) naquele item. É o "não mexa aqui" completo. - **Na campanha**: `Campanha Vendas 2024 [manual]` 🔒 A IA **não atua** em nenhum conjunto ou anúncio dessa campanha. - **No conjunto**: `Lookalike Clientes [manual]` 🔒 Apenas esse conjunto fica protegido. - **No anúncio**: `Criativo Natal 2023 [manual]` 🔒 Esse anúncio não é reativado nem duplicado. ## 2. `[não-duplicar]` — evita cópias **O que faz:** a IA continua otimizando normalmente (ajustando orçamento, pausando etc.), mas **fica proibida de criar cópias** daquela campanha ou conjunto. Use quando: - você não quer réplicas de públicos em campanhas de remarketing; - quer manter uma estrutura única, sem duplicações automáticas. ## 3. `[ativo-diariamente]` — não pausa durante o dia **O que faz:** impede as **pausas temporárias** que a IA costuma fazer ao longo do dia, mantendo o item ativo do início ao fim do dia. Use quando: - a campanha tem **padrão de compra noturno**, em que os resultados só aparecem à noite — assim a IA não pausa pela manhã achando que o desempenho está ruim. ## 4. `[intraday]` — só escala dentro do dia **O que faz:** libera **apenas o aumento de orçamento ao longo do dia**, feito de hora em hora e com base nos resultados do próprio dia. Na virada do dia (entre 0h e 1h), o orçamento volta automaticamente ao valor original que você configurou. Use quando: - a oferta (vendas ou geração de leads) perde desempenho quando o orçamento sobe demais de uma vez; - você prefere escalar aos poucos, de forma controlada, ao longo do dia. Com essa tag, o OneClick Ads aumenta o orçamento das campanhas que estão indo bem no dia e, no dia seguinte, reseta tudo para o valor original — mantendo a escala mais segura. Nesse caso, o ideal é escalar de forma lateralizada (criando várias campanhas com orçamento baixo). --- **⚠️ Atenção ao duplicar!** Se você **duplicar uma campanha, conjunto ou anúncio** que já tenha uma dessas tags: - a cópia **nasce com a mesma tag**; - ou seja, a IA também não vai atuar na cópia. - ✅ **Revise e remova a tag** se a nova versão puder ser otimizada normalmente. --- ## Boas práticas - A inteligência artificial do OneClick Ads é treinada com base em milhares de campanhas e funciona bem **sem intervenção**. - Use as tags como **exceção**, para proteger ou testar estruturas específicas — não como regra geral. --- # Controle de Horário de Campanhas Source: https://docs.oneclickads.com.br/pt-br/otimizacoes/controle-de-horario-de-campanhas.md > Como pausar e reativar campanhas por horário mantendo o OneClick Ads ativo, usando Regras Automatizadas da Meta com orçamento diário — e por que evitar o orçamento vitalício para esse controle. > Como controlar a janela de horário das suas campanhas sem abrir mão da otimização do OneClick Ads. ## Como pausar campanhas por horário mantendo o OneClick ativo? O controle de janela de horário deve ser feito via **Regras Automatizadas da Meta**, e **não** via orçamento vitalício. Passo a passo: 1. Use campanhas com **orçamento diário**; 2. Aplique uma **tag de identificação** no nome da campanha; 3. Crie uma **regra automatizada na Meta** para pausar e reativar nos horários definidos. Durante o período ativo, o OneClick **otimiza normalmente**. ## Por que evitar orçamento vitalício para controle de horário? O **orçamento vitalício** exige uma data final e atende a cenários específicos (por exemplo, lançamentos). Para operar **continuamente** com otimização e escalabilidade, o modelo recomendado é: > **Orçamento diário + regra automatizada na Meta** para os horários. :::tip[Veja também] Para controlar **quais** ativos o OneClick pode otimizar (e não apenas quando), consulte [Controlando a Atuação do OneClick Ads nas campanhas](/pt-br/otimizacoes/controlando-a-atuacao-do-oneclick-ads-nas-campanhas/). ::: --- # Definindo Limite Mensal de Investimento da Conta de Anúncios Source: https://docs.oneclickads.com.br/pt-br/otimizacoes/definindo-limite-mensal-de-investimento-da-conta-de-anuncios.md > Aprenda a configurar o limite de investimento mensal por conta de anúncios no OneClick Ads para controlar gastos, proteger o orçamento do cliente e escalar com segurança. > Aprenda como gerir melhor seu orçamento mensal. Esta funcionalidade ajuda você a controlar de forma inteligente o orçamento mensal de suas campanhas, evitando gastos indesejados sem travar sua performance. --- ## O que é essa funcionalidade A função **"Limite de orçamento mensal"** permite definir um valor máximo de investimento por **conta de anúncios**, garantindo que nenhuma otimização ultrapasse esse teto — mesmo que as campanhas estejam performando bem. Ideal para: - Agências - Gestores de tráfego - Donos de e-commerces ou infoprodutos --- ## Benefícios - 🔒 **Segurança**: nunca ultrapasse o orçamento combinado com o cliente. - 📊 **Controle**: escala com inteligência, respeitando os limites definidos. - 🤖 **Automação real**: distribui o investimento entre campanhas que realmente performam bem. --- ## Como funciona - Você define o **valor mensal** (ex: R$ 10.000). - O sistema calcula o **valor diário proporcional** (ex: R$ 333/dia). - Se o limite for atingido, o OneClick: - ❌ Pausa a escala automática - ⛔ Evita duplicações ou aumentos de orçamento - Quando o orçamento for liberado (por pausa ou encerramento de campanhas), a escala é retomada automaticamente. O sistema **não força gastos** para atingir o teto. Ele respeita seus parâmetros de performance (como CPA, ROAS etc). --- ## Passo a passo para configurar o limite mensal de investimento 1. Acesse **Gerenciar Conta > Contas de Anúncios** no menu lateral. 2. Encontre a conta de anúncios desejada e clique no botão de **Configurações** (ícone de engrenagem). 3. Ative a opção **“Limite mensal”** e insira o valor desejado (ex: R$ 30.000). 4. Clique em **Salvar**. Em seguida, você verá uma confirmação de que o limite foi definido com sucesso. :::tip[Também dá para pedir para o assistente de IA] Se você [conectou um assistente de IA](/pt-br/mcp/conectar-um-assistente-de-ia/) com permissão de escrita, pode pedir para ele definir, alterar ou remover esse limite por você — veja [Parametrizar e otimizar campanhas com IA](/pt-br/mcp/operar-campanhas-com-ia/). ::: --- ## Como funciona o cálculo diário dinâmico O limite mensal é uma **referência**, e o OneClick calcula dinamicamente: - o **valor diário estimado** disponível; - quanto **já foi gasto** no mês; - **quantos dias faltam**; - e quanto **ainda existe de margem**. **Exemplo:** se o limite mensal for **R$ 30.000** (referência de R$ 1.000/dia) e, no **dia 29**, foram gastos apenas **R$ 15.000**, havendo oportunidade o sistema pode **aumentar o orçamento diário** para aproveitar o restante da margem dentro do mês. :::tip[Teto global x travas por campanha] A melhor prática é definir o **limite mensal na conta** (teto global) e **evitar travas desnecessárias por campanha**. Travar o orçamento de forma rígida em cada campanha reduz a margem do OneClick para escalar, aumenta as pausas e diminui a capacidade de aproveitar oportunidades de alta performance. Com o teto global, o sistema redistribui o investimento para as melhores oportunidades. Veja [Como Parametrizar Campanhas](/pt-br/otimizacoes/como-parametrizar-campanhas/). ::: ## Como alterar ou remover - Você pode **editar o valor** a qualquer momento. - Para **desativar**, basta desligar o botão de limite e salvar novamente. :::caution[Quando a remoção é bloqueada] Se alguma otimização ativa da conta depende desse limite mensal como único teto de investimento (ou seja, não tem um limite diário próprio nem optou por escalar sem limite), o OneClick **bloqueia a remoção ou redução do limite** e mostra uma mensagem indicando quais campanhas precisam ser ajustadas antes. Isso evita que uma campanha continue escalando sem nenhum teto de investimento. ::: --- ## Dicas e observações - O sistema calcula automaticamente o valor diário com base no orçamento mensal. - Pode haver **variações pequenas** no gasto diário, devido ao comportamento natural do Meta Ads. - Se você não definir um limite, a escala continuará de forma **ilimitada**. --- ## Exemplo prático Se você deseja investir **R$ 1.000 por dia**, basta configurar um limite de **R$ 30.000 por mês**. O sistema controlará diariamente o orçamento, sem ultrapassar esse valor até o final do mês — escalando apenas campanhas com boa performance. --- # Pausas e Proteção Source: https://docs.oneclickads.com.br/pt-br/otimizacoes/pausas-e-protecao.md > Entenda como o OneClick Ads pausa campanhas para proteger seu investimento: pausas temporárias e reativação automática, por que ele nunca "mata" uma campanha, conversões tardias e como identificar o motivo de cada decisão. > Como funcionam as pausas de proteção do OneClick Ads e por que elas preservam o resultado do mês. Este guia explica o **comportamento** das pausas. Para o significado de cada rótulo aplicado no nome dos ativos, consulte o [Sistema de Sufixos](/pt-br/otimizacoes/sistema-de-sufixos/). ## O OneClick pausa a campanha inteira? Em quais condições? O OneClick atua em **três níveis**: campanha, conjunto e anúncio. A pausa no **nível de campanha** existe, porém com característica **temporária** e vinculada a critérios de proteção — quando o comportamento do dia indica gasto acima do aceitável sem retorno. ## O que caracteriza uma "pausa temporária" de campanha? Uma pausa temporária ocorre quando o desempenho do **dia** indica gasto acima do aceitável sem retorno — por exemplo, **sem conversões no dia** ou **CPA do dia muito acima do limite** definido. O objetivo é **proteger o resultado do mês** contra um dia ruim. > Pausas temporárias são **resetadas e reativadas automaticamente no dia seguinte**, em janela de madrugada (normalmente entre **00:00 e 03:00**). ## O OneClick "mata" uma campanha definitivamente? **Não.** A operação foi desenhada para manter a campanha com **possibilidade de retomada automática**, evitando que um recorte ruim elimine uma campanha que pode voltar a performar em outro momento. ## O OneClick decide olhando apenas o "hoje"? **Não.** As otimizações podem considerar **múltiplas janelas** (intraday e recências como 3, 7, 14 e 30 dias). Quando há decisões baseadas em janelas maiores, existe uma verificação do desempenho do dia para **evitar parar um dia positivo**. ## Por que uma campanha pode parecer pausada mesmo após o CPA "ficar bom"? Isso pode ocorrer por **conversões tardias**: a decisão de pausa acontece em um momento em que o CPA do dia estava alto e, minutos depois, pode cair uma conversão que **barateia** o CPA. A reavaliação ocorre no **próximo ciclo de otimização**, podendo reativar automaticamente quando o sinal melhora. ## O que acontece se eu reativar manualmente uma campanha pausada temporariamente? Quando há reativação manual, a plataforma **evita "brigar" com a decisão naquele mesmo dia** — ou seja, **não irá pausar novamente** aquele ativo no mesmo dia. ## Como identificar o motivo de uma pausa ou reativação? O motivo é indicado pela **nomenclatura/sufixos** aplicados nas campanhas (por exemplo, pausa temporária, reativação por conversão tardia ou por métrica secundária) e pode ser confirmado no **histórico de alterações** de orçamento/estado. Veja a lista completa em [Sistema de Sufixos](/pt-br/otimizacoes/sistema-de-sufixos/). ## O OneClick troca o público automaticamente, alterando segmentações? **Não.** O sistema **não altera o setup estrutural de segmentação** por conta própria (idade, gênero, posicionamentos, configurações estratégicas). Isso evita gasto em hipóteses não desejadas e perda de rastreabilidade sobre o que está funcionando. ## Como o OneClick atua quando um conjunto/público começa a perder performance? O sistema executa mecanismos de: - **identificação dos melhores conjuntos/audiências**; - **criação de réplicas/duplicações** (escala horizontal); - **revalidação** em situações onde um conjunto gastou pouco e foi interrompido por métricas secundárias. --- # Personalizando a Tag de Otimização Source: https://docs.oneclickads.com.br/pt-br/otimizacoes/personalizando-a-tag-de-otimizacao.md > Personalize o emoji, o nome de marca e os textos de ativo/inativo que o OneClick Ads aplica no nome das campanhas otimizadas — direto no seu Perfil de Usuário, sem precisar falar com o suporte. > Escolha como a IA identifica campanhas otimizadas no nome, com a sua própria marca. Toda campanha com a otimização do OneClick Ads ativa recebe um marcador no nome — por padrão, **🤖 [OneClick ON]** (ou **🤖 [OneClick OFF]** quando a otimização está desligada). Esse marcador ajuda você a identificar rapidamente, direto no Gerenciador de Anúncios da Meta, quais campanhas estão sob controle da IA. Agora você pode personalizar esse texto — o emoji, o nome que aparece no lugar de "OneClick" e os rótulos de ativo/inativo — direto no seu **Perfil de Usuário**. ## Como personalizar 1. Clique no seu perfil, no canto superior direito da tela, e selecione **Meu Perfil**. 2. Abra a aba **Marca**. 3. Ajuste os campos: - **Emoji** — o símbolo que aparece antes do texto (padrão: 🤖). Deixe em branco para não exibir nenhum emoji. - **Marca** — o texto que substitui "OneClick" (por exemplo, o nome da sua agência). - **Rótulo quando ativo** — o texto que aparece com a otimização ligada (padrão: "ON"). - **Rótulo quando inativo** — o texto que aparece com a otimização desligada (padrão: "OFF"). 4. Confira a **pré-visualização** exibida na tela antes de salvar. 5. Clique em **Salvar**. A partir da próxima ação de otimização, as campanhas passam a usar o novo texto automaticamente — não é preciso renomear campanhas manualmente. :::tip[Sem custo, sem suporte] A personalização é gratuita e está disponível para todos os usuários — não é mais necessário falar com o suporte para habilitá-la. ::: :::note[Isso não muda o funcionamento da otimização] O marcador é apenas identificação visual no nome da campanha. Alterá-lo não liga, desliga nem muda o comportamento da otimização — só o texto exibido no Gerenciador. ::: ## Artigos relacionados - [Sistema de Sufixos](/pt-br/otimizacoes/sistema-de-sufixos/) - [Parametrizar e otimizar campanhas com IA](/pt-br/mcp/operar-campanhas-com-ia/) --- # Relatório de Inteligência Diária Source: https://docs.oneclickads.com.br/pt-br/otimizacoes/relatorio-de-inteligencia-diaria.md > Veja todo dia o que a inteligência do OneClick Ads fez pelas suas campanhas: uma nota do dia, o que foi protegido e escalado, e a saúde de cada campanha — no painel ou pelo resumo diário no WhatsApp. > Todo dia, o OneClick Ads mostra o que a nossa inteligência artificial fez pelas suas campanhas — sem você precisar caçar essa informação no Gerenciador de Anúncios. ## Onde encontrar No menu lateral de cada conta de anúncios, acesse **Relatório de Inteligência**. A página traz o **Relatório de Inteligência Diária**, atualizado automaticamente com o que aconteceu na conta. ## O que você vê ### Resumo do dia Uma nota geral do dia — **Excelente**, **Bom**, **Atenção** ou **Crítico** — com uma explicação em linguagem simples do porquê. Junto da nota, você vê números do dia: quanto foi investido, quantas otimizações foram avaliadas e quantas realmente entraram em ação nas suas campanhas. ### Orçamento protegido hoje Mostra o que a inteligência do OneClick evitou de desperdício: anúncios pausados a tempo, pausas temporárias aplicadas e quanto isso representou em economia no mês. ### Oportunidades de crescimento capturadas Mostra onde o OneClick escalou orçamento por uma campanha estar performando bem: quantas campanhas foram expandidas, quanto de orçamento foi escalado no mês e a oportunidade de receita capturada. ### Saúde das Campanhas Uma lista das suas campanhas com o selo **Otimização Ativa** nas que estão sob os cuidados da nossa inteligência — para você ver rapidamente quais campanhas estão sendo cuidadas e quais ainda não. ### O que seu gestor de tráfego IA fez hoje Um resumo, campanha a campanha, das ações que a inteligência tomou — como ajustes de orçamento — para você acompanhar o raciocínio por trás de cada decisão. :::tip[Receba um resumo no WhatsApp] Se você tem o [WhatsApp configurado como canal de notificação](/pt-br/notifications/canais-whatsapp/), você recebe automaticamente um resumo rápido do dia por lá — com um link direto para abrir o relatório completo no painel. Esse resumo é enviado apenas nos dias em que há mudanças relevantes na conta. ::: ## Próximos passos - Configure o [canal de WhatsApp](/pt-br/notifications/canais-whatsapp/) para receber esse resumo automaticamente. - Quer entender os sufixos que aparecem no nome das suas campanhas? Veja o [Sistema de Sufixos](/pt-br/otimizacoes/sistema-de-sufixos/). --- # Sistema de Sufixos Source: https://docs.oneclickads.com.br/pt-br/otimizacoes/sistema-de-sufixos.md > Entenda o significado de cada sufixo aplicado pelo OneClick Ads nas campanhas Meta Ads: pausas, reativações, escalas e outras ações automáticas de otimização. > Aprenda o que significa cada sufixo no nome das campanhas otimizadas pela nossa IA. Toda vez que a inteligência artificial do OneClick Ads executa uma otimização, um conjunto robusto de sufixos é utilizado para gerar clareza ao usuário. Esses sufixos são aplicados com base no desempenho de campanhas, conjuntos de anúncios e anúncios, permitindo ações que minimizem desperdícios de investimento em mídia e maximizem o retorno sobre o investimento em mídia (ROAS). --- ## Pausas por Falta de Conversão - **Pausado nunca converteu**: Pausa anúncios ou conjuntos que nunca geraram conversão dentro do período de análise. - **Pausado sem conversões 14 dias**: Pausa estruturas (conjuntos ou anúncios) que não geram conversões por um período de 14 dias, ou seja, estruturas que estavam convertendo bem, mas começaram a perder muita performance nos últimos 14 dias. A inteligência do OneClick Ads espera que o investimento nessa estrutura seja representativo para pausar. - **Pausado sem conversões e sem checkout**: Pausa estruturas que não geraram conversões nem checkouts (ou adições ao carrinho), ajudando a mitigar estruturas de campanhas que não têm projeção positiva de resultado. O OneClick Ads garante um gasto mínimo antes de aplicar essa otimização. - **Pausado sem conversões e CPC caro**: Pausa estruturas que não geraram conversões e com Custo por Clique (CPC) elevado, ajudando a mitigar estruturas de campanhas que não têm projeção positiva de resultado. O CPC caro é um parâmetro dinâmico do conjunto ou anúncio ter um custo por clique muito acima da média dos outros conjuntos ou anúncios dentro da mesma campanha, não tendo correlação direta com o “Custo máximo aceitável por conversão” definido dentro da plataforma do OneClick Ads. --- ## Pausas por Perda de Performance - **Pausado CPA máximo**: Pausa estruturas que atingiram um _custo máximo aceitável por conversão_ alto, ajudando a proteger desperdícios de investimento e otimizar o retorno sobre o investimento da conta como um todo. Neste caso, considere aumentar o _custo máximo aceitável por conversão_ dentro da plataforma do OneClick Ads, como mostrado abaixo. - **Pausado perda de performance 14 dias**: Pausa conjuntos de anúncios que apresentam perda de performance (aumento considerável no custo por conversão) nos últimos 14 dias, ajudando a evitar gastos desnecessários em campanhas que estão deixando de gerar bons resultados. - **Pausado CPA extremo últimos dias:** Pausa conjuntos de anúncios que apresentam custo por conversão extremamente elevado nos últimos dias — seja com CPC nos últimos 14 dias acima de 4 vezes o custo máximo aceitável por conversão, ou CPC nos últimos 7 dias acima de 6 vezes o custo máximo aceitável. Essa otimização atua como uma proteção adicional para casos extremos de desperdício de investimento, garantindo que conjuntos com performance muito distante do aceitável sejam pausados definitivamente. - **Pausado checkout caro**: É aplicada para estruturas que não converteram e, ao mesmo tempo, estão gerando “finalização de compra iniciada” (ou adições ao carrinho) com um custo acima da média da campanha em otimização, ajudando a mitigar estruturas de campanhas que não têm projeção positiva de resultado. --- ## Pausas Temporárias - **Pausado Temporariamente CPA hoje:** Pausa estruturas que converteram muito caro no dia de análise, com reativação automática no dia seguinte. - **Pausado temporariamente sem conversões hoje**: Pausa estruturas que gastaram muito e não converteram no dia de análise, com reativação no dia seguinte. - **Pausado temporariamente sem checkout hoje**: Pausa estruturas que gastaram muito no dia de análise e não apresentaram “finalização de compra iniciada” (ou adições ao carrinho), com reativação no dia seguinte. - **Pausado temporariamente checkout caro hoje**: Pausa estruturas que gastaram muito no dia de análise e apresentaram custo por “finalização de compra iniciada” (ou adições ao carrinho) muito acima da média, com reativação no dia seguinte. - **Pausado temporariamente CPA 3 dias**: Pausa estruturas que gastaram muito nos últimos 3 dias (incluindo hoje) e apresentaram custo por conversão muito caros, com reativação automática alguns dias depois. - **Pausado temporariamente CPA 7 dias**: Pausa estruturas que gastaram muito nos últimos 7 dias (incluindo hoje) e apresentaram custo por conversão muito caros, com reativação automática alguns dias depois. - **Pausado temporariamente sem conversões 3 dias**: Pausa estruturas que gastaram muito nos últimos 3 dias (incluindo hoje) e não converteram, com reativação automática alguns dias depois. - **Pausado temporariamente sem conversões 7 dias**: Pausa estruturas que gastaram muito nos últimos 7 dias (incluindo hoje) e não converteram, com reativação automática alguns dias depois. - **Pausado TEMPORARIAMENTE maximizando campanha hoje:** Pausa conjuntos de anúncios que não tiveram conversões no dia da análise, para potencializar o investimento da campanha em conjuntos de anúncios que estão tracionando o resultado da campanha no dia da análise (período "hoje" no gerenciador de anúncios da Meta). Essa otimização só é implementada quando o resultado da campanha está próximo ao custo por conversão para PAUSAR (inserido no OneClick Ads). Essa estratégia garante que a Meta foque o investimento em conjuntos de anúncios que já estão convertendo dentro da mesma campanha. A pausa temporária garante que todos eles serão reativados no dia seguinte entre 0h e 3h. --- ## Reativação de Estruturas - **Reativado conversão tardia**: Reativa estruturas que receberam marcações de conversões após terem sido pausadas, dando uma segunda chance a campanhas que eventualmente se mostraram eficazes. Isso acontece por uma característica de atribuição da Meta Ads, que trabalha em uma janela de atribuição de alguns dias. Esse comportamento é normal e pode ser melhor entendido na Central de Ajuda da Meta. - **Reativação métricas secundárias tardias**: Reativa estruturas que receberam marcações de “finalização de compra iniciada” (ou adições ao carrinho) após terem sido pausadas, dando uma segunda chance a campanhas que eventualmente se mostraram eficazes. Isso acontece por uma característica de atribuição da Meta Ads, que trabalha em uma janela de atribuição de alguns dias. Esse comportamento é normal e pode ser melhor entendido na Central de Ajuda da Meta. --- ## Estratégias de Escala - **Escala horizontal** (pode aparecer no nome como `[Escala horizontal]` ou `[Escala horizontal - Campanha Validada]`): Refere-se a uma estratégia de escala na qual um conjunto de anúncios ou campanha com ótima performance é duplicado, para que haja escala dos resultados. Automaticamente a inteligência do OneClick Ads otimiza o novo conjunto de anúncios duplicado. Esse comportamento se aplica apenas a campanhas do tipo ABO (Orçamento a nível de conjunto de anúncios). - **Escala horizontal Conjunto Validado** (pode aparecer no nome como `[Escala horizontal - Conjunto]`): Refere-se à escala na qual um conjunto de anúncios com muitas conversões é duplicado, uma vez que há alta probabilidade da nova réplica gerar resultados acima da média. Automaticamente a inteligência do OneClick Ads otimiza o novo conjunto de anúncios duplicado. Esse comportamento se aplica a todos os tipos de campanhas e os conjuntos podem ser duplicados somente uma vez. - **Escala vertical agressiva**: Indica uma estratégia de escala na qual o orçamento de um conjunto de anúncios ABO ou Advantage+ (com performance acima da média) é aumentado de forma significativa, visando aumentar escala e/ou alcançar o número de 50 conversões a cada 7 dias (em um mesmo conjunto de anúncios). Isso é uma boa prática sugerida na [Central de Ajuda](https://www.facebook.com/business/help/112167992830700?id=561906377587030) para melhor aproveitamento do algoritmo da própria Meta Ads. Essa estratégia também é aplicada a nível de campanhas do tipo CBO. - **Escala vertical**: Similar à escala vertical agressiva, o orçamento de um conjunto de anúncios (ABO ou Advantage+) ou campanha (CBO) é aumentado lenta e gradualmente para melhorar os resultados sem correr o risco de perder a inteligência do algoritmo da Meta Ads. - **Escala surfando conversões hoje**: Refere-se a uma estratégia de escala agressiva de orçamento baseada nas conversões obtidas no dia atual, aproveitando o bom desempenho no dia. Essa otimização traz uma escala temporária, ou seja, o orçamento da estrutura será reiniciado no dia seguinte, voltando ao orçamento do dia anterior, antes do processo de escala. - **[Réplica de Conjunto Validado]**: Refere-se a uma estratégia de duplicação de conjuntos de anúncios que já receberam um alto número de conversões no período máximo. A duplicação de conjunto validado pode acontecer várias vezes para o mesmo conjunto, garantindo que novas estruturas com alta probabilidade de conversão sejam criadas, viabilizando uma escala de longo prazo e constante. --- ## Ativação de novas Estruturas - **Ativação de Anúncio Pausado**: Refere-se a ativação de anúncios que estavam pausados e que nunca rodaram antes. Essa otimização permite que o usuário suba uma campanha com, por exemplo, 10 anúncios mantendo apenas 5 ativos. Nossa tecnologia vai ativar mais anúncios pausados assim que o número total de anúncios ativos reduzir a 3. Desse modo, garantimos que todos os anúncios serão testados em fila. - **Ativação de Conjunto Pausado**: Mesmo comportamento do sufixo acima, só que a nível de conjunto de anúncios — ativa conjuntos que estavam pausados e nunca haviam rodado antes, seguindo a mesma lógica de fila. --- ## Outras Estratégias de Otimização - **Top Anúncios em conjunto validado:** Este sufixo é aplicado quando o conjunto de anúncios já possui **conversões** e o custo por conversão está **acima do CPA Máximo** definido. **O que significa:** A IA identificou que este é um conjunto de anúncios validado (com bom volume de conversões), porém alguns anúncios individuais estão prejudicando a performance geral. **O que fazer:** Nenhuma ação é necessária. A IA mantém ativos apenas os anúncios com melhor performance, maximizando o retorno do seu investimento neste conjunto validado. - **Melhores Anúncios Isolados:** Este sufixo é aplicado quando o conjunto de anúncios possui **conversões** e o custo por conversão está acima do limite de custo máximo de conversão inserido na plataforma. **O que significa:** O conjunto ainda está em fase de validação (poucas conversões), mas já apresenta sinais de que alguns anúncios estão com performance inferior. A IA pausou os anúncios que: - **Nunca converteram** e possuem custo por checkout maior que a média do conjunto - **Nunca converteram** e possuem custo por clique maior que a média do conjunto - **Nunca converteram** e não receberam nenhum clique - **Já converteram**, mas com custo por conversão acima do limite tolerado para o volume de conversões atual **O que fazer:** Aguarde o conjunto acumular mais dados. A IA está isolando os melhores anúncios para acelerar a validação do conjunto. - **Top Anúncios Isolados:** Este sufixo é aplicado quando o conjunto de anúncios **ainda não possui nenhuma conversão**. **O que significa:** O conjunto ainda não converteu, mas já investiu um valor significativo. Para evitar desperdício de verba, a IA pausou os anúncios com pior performance, mantendo ativos apenas os que têm maior potencial de conversão. Foram pausados os anúncios que: - Possuem custo por checkout maior que a média do conjunto - Possuem custo por clique maior que a média do conjunto - Não receberam nenhum clique **O que fazer:** Aguarde. A IA está concentrando a verba nos anúncios com melhores métricas secundárias (cliques e checkouts), aumentando as chances de conseguir a primeira conversão com o menor custo possível. - **[Réplica de Revalidação]**: Refere-se a uma estratégia de duplicação de conjuntos de anúncios (apenas uma duplicação ao longo da "vida" de cada conjunto) que gastaram muito pouco e não tiveram conversões. A revalidação permite que a Meta Ads reinicie a busca por grupos de audiências que performam melhor. - **Redução por baixa performance**: Refere-se a uma estratégia de redução do orçamento de estruturas que apresentam baixa performance, ajudando a otimizar o retorno sobre o investimento da conta de anúncios. - **Redução CPA hoje**: Refere-se a uma estratégia de redução do orçamento de estruturas que apresentam baixa performance no dia da análise, ajudando a otimizar o retorno sobre o investimento da conta de anúncios e protegendo o investimento de estruturas ineficientes. - **Redução por alta frequência**: Refere-se a uma estratégia de redução do orçamento de anúncios que estão sendo exibidos com muita frequência, evitando a saturação do público-alvo e perda de performance. - **Correção Orçamento Máximo**: Refere-se à correção do orçamento diário quando a campanha está com orçamento acima daquele estipulado dentro da plataforma do OneClick Ads. - **Coletando dados**: Sufixo aplicado durante a fase inicial de uma estrutura recém-criada ou recém-ativada, enquanto a IA ainda não acumulou dados suficientes para aplicar pausas ou escalas. Nenhuma ação é necessária — é um estado temporário até haver volume suficiente para a otimização atuar.