For AI agents: the complete documentation index is available at https://docs.clickmax.dev/llms.txt, the full documentation bundle is available at https://docs.clickmax.dev/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.dev/features/traffic/connect-ad-account.md.
  • Português
  • Como conectar minha conta de anúncios ao Clickmax?

    Vá em Tráfego → Conexões e clique em Conectar conta. Escolha Meta Ads ou Google Ads, autorize o acesso na própria plataforma e o Clickmax começa a importar o investimento das suas campanhas.

    A conexão usa OAuth 2.0. O Clickmax lê campanhas e investimento, e só cria algo quando você pede: um post em Publicações ou um impulsionamento. Ele nunca altera campanhas que você criou fora do Clickmax.

    Antes de começar

    • Papel do workspace que alcance a área Tráfego — ver Tráfego.
    • A pessoa que autoriza precisa ter acesso àquela conta de anúncios na própria plataforma. O Clickmax enxerga exatamente o que ela enxerga, nem mais.
    • A área ainda está em liberação. Se Tráfego não aparece no seu menu, fale com o suporte.

    Passo a passo

    1. Vá em Tráfego e clique em Conexões.
    2. Clique em Conectar conta e escolha Meta Ads ou Google Ads.
    3. Em Antes de conectar, confira o que você vai precisar. No Meta, a mesma tela lista as permissões que o Clickmax pede. Clique em Continuar.
    4. Clique em Abrir Meta Ads (ou Abrir Google Ads). A tela de autorização abre numa janela, e o Clickmax fica atrás mostrando o que vai aparecer nela e quanto tempo passou.
    5. Na janela do Meta, siga a ordem que o Clickmax mostra:
      1. continue com o seu perfil do Facebook;
      2. escolha o portfólio empresarial onde estão as contas de anúncio;
      3. marque as contas de anúncio que você quer ver no Clickmax;
      4. marque as Páginas e os perfis do Instagram, para publicar, impulsionar e receber leads;
      5. salve. A janela fecha sozinha.
    6. De volta ao Clickmax, a tela final mostra quem autorizou, as contas de anúncio que entraram e quantas Páginas e perfis do Instagram a autorização alcança.

    Se você desligou alguma permissão na revisão final do Meta, a tela final mostra Ficou de fora com o que deixa de funcionar (por exemplo, "os leads dos formulários de anúncio não entram no CRM"). Clique em Autorizar de novo e, na janela do Meta, deixe todas ligadas.

    Se o navegador bloquear a janela, o Clickmax avisa e oferece Abrir em nova aba. O resultado volta para a mesma tela do mesmo jeito.

    O que acontece depois depende de quantas contas a sua autorização alcança:

    • Até 10 contas — todas já entram sincronizando, e a primeira importação começa em segundos.
    • Mais de 10 contas — todas aparecem na lista, mas nenhuma começa sincronizando. É de propósito: uma autorização de agência pode revelar dezenas de contas, e importar todas gastaria o limite de consultas da plataforma com dados que ninguém pediu.

    Escolher quais contas sincronizar

    Em Tráfego → Conexões, clique em Ver detalhes na conta que interessa e ligue a chave Sincronização — a primeira importação daquela conta começa em segundos, sem esperar a rodada diária. Só as contas com essa chave ligada alimentam o painel de Desempenho. Para forçar uma importação de uma conta só, veja Como sincronizar ou revisar uma única conta de anúncios?.

    A primeira importação traz os últimos 90 dias. Depois disso, cada rodada reescreve os últimos 28 dias — é o período em que as plataformas ainda ajustam números do passado, então o histórico recente continua se corrigindo sozinho.

    Páginas e perfis do Instagram

    Ao conectar o Meta Ads, o Clickmax também lista as Páginas do Facebook que a sua autorização alcança e o perfil do Instagram vinculado a cada uma. Elas aparecem em Tráfego → Conexões, na seção Páginas e perfis do Instagram, logo abaixo das contas de anúncio.

    Cada Página mostra o que impede publicar por ela:

    • Sem Instagram vinculado — a Página não tem um perfil profissional do Instagram ligado a ela. Vincule o perfil à Página no próprio Meta.
    • Sem permissão para publicar — quem conectou o Meta não tem permissão de criar conteúdo naquela Página. Peça essa permissão a um administrador da Página, ou reconecte com alguém que já a tenha.
    • Autorização vencida ou Desconectada — a autorização do Meta venceu ou não alcança mais aquela Página. Clique em Reconectar ao lado da Página e, na tela do Meta, marque a Página e o Instagram dela.

    Vinculou o Instagram à Página, ou ganhou acesso a uma Página nova, depois de conectar? Clique em Atualizar Páginas: o Clickmax busca de novo, sem você refazer a autorização. Uma Página que não aparece nem depois disso não foi incluída na autorização. Com a lista vazia, clique em Reconectar o Meta. O mesmo botão Reconectar fica no detalhe de cada conta de anúncio, ao lado de Desconectar. Na tela do Meta, clique em Editar acesso e marque a Página e o Instagram dela. Se o Meta só mostrar Continuar, a seleção anterior é mantida e a Página continua de fora.

    A lista de Páginas vem de quem autorizou, não da conta de anúncio: essa pessoa precisa ter acesso à Página no Meta. Acesso só à conta de anúncio, mesmo no mesmo portfólio empresarial, não traz a Página.

    Onde ficam as conexões

    Tudo o que vem de uma conexão fica em Tráfego → Conexões, em abas: Contas de anúncio, Páginas e Instagram, Pixels e Saúde dos dados.

    Em Contas de anúncio, as contas aparecem agrupadas pela autorização que as sincroniza. O topo de cada grupo diz quem autorizou, quantas contas e Páginas ela alcança, quando vence e, quando for o caso, quantas permissões faltam. Se a autorização parou de servir ou falta permissão, o botão Reconectar fica ali mesmo.

    Conta de anúncio e Página não se ligam direto: as duas vêm da mesma autorização. Elas só se cruzam quando você impulsiona um post da Página pagando com a conta. O detalhe de cada uma mostra isso no bloco De onde vem e o que alimenta:

    • Na conta de anúncio: a autorização, as campanhas, quantas estão ligadas a um funil, os posts que ela impulsionou e as Páginas da mesma autorização.
    • Na Página: a autorização, os posts, as contas que pagaram os impulsionamentos, os formulários de anúncio e os leads dos últimos 7 dias. Abaixo, O que dá para fazer com esta Página diz se dá para publicar no Facebook e no Instagram, receber leads e ver as métricas dos posts, e o que falta quando não dá.

    Cada item do bloco leva à tela com a lista completa.

    O que muda entre Meta Ads e Google Ads

    AssuntoMeta AdsGoogle Ads
    AutorizaçãoVence a cada 60 dias. Quando vencer, alguém precisa reconectar a conta.Não vence. O detalhe da conta mostra Renovação automática no lugar de uma data.
    Quais contas aparecemAs contas de anúncio que a pessoa autorizada enxerga.As contas de cliente abaixo das contas de administrador que a pessoa autorizada enxerga. Contas de administrador não aparecem sozinhas: elas não veiculam anúncio.
    Detalhe por criativoCampanha, conjunto e anúncio.Campanha, grupo de anúncios e anúncio — exceto em Performance Max.
    ID da contaNo formato act_ seguido dos números.Dez dígitos, no mesmo formato do Gerenciador do Google.

    Campanhas Performance Max

    O Google não abre os anúncios de dentro de uma campanha Performance Max. Na aba Por Campanha, essas campanhas aparecem com o selo Sem detalhe por anúncio e não expandem.

    O investimento delas está correto e entra em todos os totais — o que não existe é o ranking de criativos dentro da campanha. Não é dado faltando nem sincronização quebrada.

    Reconectar ou desconectar

    Reconectar é o mesmo caminho de conectar: Conectar conta de novo, com a mesma plataforma. A conta mantém todo o histórico já importado e volta a atualizar.

    No detalhe da conta, o botão Reconectar aparece quando a autorização parou de servir ou quando faltam permissões nela. Ele abre a mesma tela de Conectar conta.

    Contas conectadas antes de o Clickmax pedir mais permissões mostram o aviso Permissões que faltam nesta autorização, com a lista do que falta. A sincronização dos números continua, mas publicar posts, receber leads e ver as métricas dos posts dependem dessas permissões. Reconecte e confirme todas na tela do Meta.

    Para parar de importar, abra o detalhe da conta e clique em Desconectar. A conta para de sincronizar e o histórico já importado é preservado — a conexão pode ser refeita a qualquer momento. Desconectar uma conta de anúncios não desliga as Páginas e os perfis do Instagram da mesma autorização: eles continuam disponíveis para publicar.

    Desconectar o Meta de vez

    Para largar o Meta inteiro, clique em Desconectar Meta no topo de Tráfego → Conexões e confirme. O Clickmax:

    • revoga as permissões que o Clickmax Ads tem no Meta, para todas as autorizações do workspace;
    • apaga o acesso guardado (o token) da conexão;
    • desliga as contas de anúncio, as Páginas, os perfis do Instagram e o envio de eventos do pixel que dependiam dela.

    Campanhas, métricas, posts e leads já importados continuam no workspace. Se o Meta não confirmar a revogação (por exemplo, com a autorização já vencida), o Clickmax apaga o acesso do lado dele mesmo assim e avisa: nesse caso, remova o Clickmax também pelo Facebook, como mostrado abaixo.

    Uma autorização desfeita por qualquer motivo — desconectar, reconectar com outra pessoa ou o Meta revogar — não fica mais com o token guardado.

    Permissões que o Clickmax pede ao Meta

    PermissãoPara quê
    ads_readImportar campanhas, conjuntos, anúncios e investimento.
    ads_management, pages_manage_adsImpulsionar um post publicado pelo Clickmax e pausar o impulsionamento.
    pages_show_list, pages_read_engagementListar as suas Páginas e ler curtidas, comentários e compartilhamentos dos posts.
    pages_manage_postsPublicar na Página quando você manda publicar.
    read_insightsMostrar alcance e visualizações dos posts da Página.
    instagram_basic, instagram_content_publish, instagram_manage_insightsEncontrar o perfil vinculado, publicar nele e mostrar alcance, visualizações e salvamentos.
    pages_manage_metadata, leads_retrievalReceber os leads dos formulários de anúncio no CRM.

    O Clickmax só alcança as contas, Páginas e perfis que você marca na tela de autorização do Meta. A mesma lista aparece no passo Antes de conectar da janela Conectar Meta Ads, antes de você ir para o Meta.

    O acesso do Meta vence de dois jeitos: o token dura cerca de 60 dias, e o acesso aos seus dados cai depois de cerca de 90 dias sem você usar o app. O Clickmax avisa no sino pelo que vencer primeiro. Reconectar renova os dois.

    Remover o Clickmax do Facebook e apagar seus dados

    Pelo lado do Meta, abra Facebook → Configurações e privacidade → Configurações → Integrações comerciais, escolha Clickmax Ads e clique em Remover. Ao remover:

    • O Clickmax revoga a autorização em todos os workspaces em que você conectou e para de sincronizar.
    • Se você pedir a exclusão dos dados na mesma tela, o Clickmax apaga o token de acesso, as permissões concedidas e o seu identificador do Facebook guardados com a conexão, e mostra um código de confirmação.
    • Campanhas, métricas, posts publicados e leads importados continuam no workspace: eles pertencem ao negócio que conectou, não à pessoa que autorizou. Para apagá-los, fale com o suporte.

    Se não funcionou

    • "Você cancelou a autorização." Alguém recusou a tela da plataforma. Clique em Abrir Meta Ads de novo.
    • "A janela foi fechada antes de terminar." A janela da plataforma foi fechada antes de salvar, e nada foi conectado. Abra de novo e vá até o fim.
    • "O navegador bloqueou a janela." Clique em Abrir em nova aba, ou libere janelas pop-up para o Clickmax no navegador.
    • "O pedido de conexão expirou." O caminho de volta tem validade curta. Clique em Conectar conta de novo e conclua sem parar no meio.
    • "Não foi possível concluir a conexão." Tente uma vez mais. Se repetir, confira se a pessoa que autorizou tem acesso à conta de anúncios na plataforma.
    • Conectei e a lista está vazia. A autorização foi concedida por uma conta que não alcança nenhuma conta de anúncios. No Google, confira se ela tem acesso à conta de administrador certa; no Meta, ao Gerenciador de Negócios certo.
    • A conta aparece como Autorização expirada ou Sem acesso. Reconecte-a. No Meta isso é esperado a cada 60 dias; no Google, significa que alguém removeu o acesso do Clickmax pelo lado do Google.
    • Último erro "Não foi possível ler a autorização guardada". A autorização guardada não pode mais ser usada, e a conta passa a Autorização expirada. Clique em Reconectar no detalhe da conta.
    • Impulsionar falhou dizendo que falta forma de pagamento. Cadastre um cartão ou outra forma de pagamento na conta de anúncios, no Gerenciador de Anúncios do Meta, e impulsione de novo. O Clickmax tenta apagar a campanha que ficou pela metade; se ela continuar lá, apague no Gerenciador de Anúncios.
    • Conectei mas o painel continua vazio. Confira a chave Sincronização no detalhe da conta e acompanhe a primeira importação em Saúde dos dados.

    Relacionados