For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/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.
    3. Escolha a plataforma e clique em Conectar. Você sai do Clickmax e vai para a tela de autorização da plataforma.
    4. Entre com a conta que tem acesso aos anúncios e confirme as permissões.
    5. Você volta para a mesma tela do Clickmax, com o resultado no topo.

    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 — reconecte o Meta e marque essa Página na tela de permissões.

    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 na janela Conectar conta de anúncios 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 fechou ou recusou a tela da plataforma. Comece de novo.
    • "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