Guia de Credenciais — Alunos ClickGrowth

Qual plataforma você
quer configurar?

Selecione a plataforma para ver o guia completo de credenciais — estrutura de conta, token de API, boas práticas e template preenchível.

📘

Meta Ads

Business Manager, token da API, System User, pixel e estrutura de agência no Facebook e Instagram.

Business Manager API Token System User
Acessar guia →
🔵

Google Ads

MCC (conta gerenciadora), Developer Token básico, OAuth2, Google Cloud Console e estrutura de agência.

MCC Developer Token OAuth2
Acessar guia →
Guia de Agência — Alunos ClickGrowth

Meta Ads
para Agências

Business Manager, token da API, System User permanente, boas práticas e template pronto para solicitar acesso.

Business Manager
Token long-lived
System User
Template preenchível
Role para aprender do zero

Meta Ads para quem
opera como agência

O Meta Ads (Facebook + Instagram) trabalha por interrupção — o criativo aparece no feed e desperta desejo. Para agências, a operação exige uma estrutura de Business Manager separada do perfil pessoal.

Canais do Meta Ads
CanalOnde apareceMelhor paraNível
Feed (Facebook/Instagram)Linha do tempo e feed principalConversão e geração de leadsComeçar aqui
Stories e ReelsTela cheia verticalEngajamento e brandingIntermediário
Audience NetworkApps e sites parceirosAlcance e remarketingAvançado
WhatsApp AdsClick-to-WhatsApp no feedLeads direto no WhatsAppComeçar aqui
Meta Ads — Interrupção

O usuário está no feed sem intenção de compra — o criativo interrompe e desperta desejo. Volume alto, criativo é o diferencial.

Criativo críticoAlto volumeDemanda criada
Google Ads — Intenção

O usuário busca ativamente — o anúncio aparece para quem já quer comprar. Menor volume, mas conversão mais alta.

Busca ativaCPL menorDemanda capturada

BM — A estrutura
profissional da agência

O Business Manager (BM) é o painel central de gestão do Meta para empresas. É dentro dele que você organiza contas de anúncio, páginas, pixels e acessos dos clientes.

🏢 Sua Agência — Business Manager conta-mãe
├──👤Usuário do Sistema (System User)token permanente
├──💳Ad Account — Cliente Aact_XXXXXXXXX
├──💳Ad Account — Cliente Bact_XXXXXXXXX
├──📄Páginas (Pages) dos clientes
└──📊Pixels dos clientesrastreamento
✗ Sem BM — conta pessoal
  • Gerenciador de anúncios vinculado ao perfil pessoal do Facebook
  • Se perder acesso ao perfil, perde tudo dos clientes
  • Impossível criar System User — token expira sempre
  • Limite de contas de anúncio muito menor
✓ Com BM — modo profissional
  • Contas separadas do perfil pessoal — total segurança
  • System User com token que não expira nunca
  • Permissões granulares por colaborador e cliente
  • Acesso à Marketing API com mais permissões
Como criar o Business Manager
1
Tenha um perfil pessoal do Facebook ativo
O BM é vinculado a um perfil pessoal como "proprietário". Use o perfil da pessoa responsável pela agência — não um perfil falso (o Meta detecta e bane).
⚠️

O perfil pessoal não aparece para clientes. Ele é apenas o "dono" do BM internamente.

2
Acesse business.facebook.com e crie o BM
Clique em "Criar conta" e preencha com os dados da agência:
🔗 business.facebook.com
Nome do negócio[Nome da Sua Agência]
Seu nomeNome completo do responsável
Email corporativo[nome]@suaagencia.com.br obrigatório
3
Verifique o domínio da agência
No BM vá em Configurações do negócio → Segurança da marca → Domínios. Adicione o domínio do site e siga as instruções de verificação (DNS ou meta-tag).

Domínio verificado aumenta o limite de contas de anúncio e reduz bloqueios do Meta.

4
Vincule ou crie Ad Accounts (contas de anúncio)
Em Configurações do negócio → Contas → Contas de anúncio, escolha:
Opção A — Criar nova
Agência controla tudo. Recomendado para novos clientes que ainda não têm conta.
Opção B — Solicitar acesso
Cliente já tem conta. Você pede acesso de admin — ele aprova na conta dele.

Tipos de token e
qual usar na agência

O token de acesso é a chave que autoriza sua aplicação a operar nas contas do Meta. Para agências, o tipo certo de token faz toda a diferença.

● Short-lived Token
~1-2h
duração
Expira em horas
Gerado no Graph Explorer
Não use em produção
Evitar
● Long-lived Token
~60 dias
duração — precisa renovar
Convertido do short-lived
Suficiente para operar
Precisa de renovação mensal
Opção viável
● System User Token
Nunca
não expira
Criado dentro do BM
Não depende de pessoa física
Ideal para automações
Recomendado para agências
Permissões (scopes) necessárias para agência
PermissãoPara que serveObrigatória?
ads_managementCriar, editar e pausar anúnciosSim
ads_readLer performance de campanhasSim
business_managementGerenciar ativos do BMSim
pages_read_engagementLer dados de páginas vinculadasRecomendado
instagram_basicDados básicos do InstagramSe usar Instagram

Processo completo
de geração do token

Dois caminhos: Long-lived token (mais rápido, renovação mensal) ou System User Token (configuração única, não expira). Siga o passo a passo do que se aplica a você.

Caminho A Long-lived Token (mais rápido)
Ideal para começar rapidamente. Precisa renovar a cada ~60 dias.
1
Crie um App no Meta for Developers
Acesse o painel de desenvolvedores e crie um app do tipo "Business".
🔗 developers.facebook.com/apps
→ Tipo do app: Business
→ Nome: [SuaAgencia]-ads-api
→ Adicione o produto: Marketing API
2
Abra o Graph API Explorer e gere o token curto
🔗 developers.facebook.com/tools/explorer
→ Selecione o seu App no dropdown
→ Clique em "Gerar token de acesso"
→ Marque as permissões: ads_management, ads_read, business_management
→ Copie o token gerado (válido por ~1-2h)
3
Converta para Long-lived Token (~60 dias)
Faça a chamada abaixo substituindo os valores:
curl — converter token para long-lived curl "https://graph.facebook.com/v20.0/oauth/access_token
  ?grant_type=fb_exchange_token
  &client_id=SEU_APP_ID
  &client_secret=SEU_APP_SECRET
  &fb_exchange_token=TOKEN_CURTO_AQUI"

A resposta retorna access_token — este é o long-lived token. Salve no wiki da sua agência.

Caminho B System User Token (recomendado para agências)
Token que não expira nunca. Configuração única — vale para sempre.
1
No BM, crie um Usuário do Sistema
Vá em Configurações do negócio → Usuários → Usuários do sistemaAdicionar.
→ Nome: sistema-ads-api
→ Função: Admin (para acesso completo)
2
Atribua o System User às Ad Accounts
Ainda em Usuários do Sistema, clique no usuário criado → "Atribuir ativos" → selecione cada Ad Account dos clientes → permissão: Admin.
3
Gere o token permanente
Na página do System User, clique em "Gerar novo token". Selecione o App criado e as permissões necessárias.
⚠️

O token é exibido uma única vez. Copie e salve imediatamente no wiki/cofre de senhas da agência. Não há como recuperá-lo depois.


Operar Meta Ads com
segurança e escala

Práticas que evitam bloqueios, perdas de conta e dores de cabeça com clientes.

🔐
Nunca use token pessoal
Use System User ou Long-lived de App Business. Token pessoal vincula operação à sua conta pessoal do Facebook — risco alto.
📊
Pixel antes de ativar
Instale e teste o Pixel no site do cliente antes de ativar qualquer campanha. Sem pixel = sem dados de conversão = otimização cega.
📋
📋
Documente os IDs
Guarde: Ad Account ID (act_), Page ID, Pixel ID e BM ID de cada cliente. Você vai precisar para API e suporte.

✓ Faça

  • Use System User Token para automações e scripts
  • Configure Conversions API além do Pixel (dupla proteção)
  • Verifique o domínio do cliente no BM antes de anunciar
  • Crie públicos personalizados desde o início (acumulam tempo)
  • Use nomes padronizados: CAMP_Objetivo_Público_Data
  • Renove long-lived tokens antes de expirar (agende lembrete)

✗ Não faça

  • Ativar campanhas sem evento de conversão configurado
  • Dar acesso de Admin ao cliente — pode remover a agência
  • Criar a Ad Account no perfil pessoal do cliente (perde o controle)
  • Ignorar avisos de qualidade de conta — levam a bloqueio
  • Escalar budget antes de ter 50 eventos de conversão
  • Usar imagens com mais de 20% de texto (reduz entrega)

Onboarding completo
por cliente Meta

Execute a cada novo cliente. Não ative campanhas sem todos os itens marcados.

01
Business Manager da agência criado com email corporativo@suaagencia.com.br — nunca Gmail pessoal
02
Domínio da agência verificado no BMConfigurações do negócio → Segurança da marca → Domínios
03
Ad Account do cliente criada ou vinculada ao BM da agênciaNomenclatura: [Cliente] — [Segmento] — anotar o act_ID
04
Página do Facebook do cliente vinculada ao BMNecessária para criar anúncios — cliente precisa aceitar
05
Pixel criado e instalado no site do clienteTestar com Meta Pixel Helper antes de ativar campanhas
06
Evento de conversão configurado e testadoLead, Purchase ou o evento principal da estratégia
07
System User ou Long-lived Token gerado e salvoDocumentar no wiki: token, data de geração, data de expiração
08
Acesso "Analista" (não Admin) dado ao clientePara ele ver resultados sem risco de editar ou remover a agência
09
Público personalizado de remarketing criadoVisitantes do site dos últimos 180 dias — começa a acumular desde já
10
IDs documentados no wiki da agênciaact_ID, Page ID, Pixel ID, BM ID — tudo em um lugar

Modelo para configurar
o acesso da agência

Substitua apenas os campos em amarelo. Use este modelo para documentar e replicar o setup para cada aluno.

📬
Email corporativo obrigatório
Todas as configurações devem ser feitas com o email corporativo da agência (nome@suaagencia.com.br). Nunca use Gmail pessoal como email principal do BM — isso dificulta verificações e limita funcionalidades da API.
📋Ficha de Setup — Meta Ads por cliente
substitua os campos em amarelo
== DADOS DA AGÊNCIA == Business Manager ID: [ID do seu BM]
Email corporativo: [nome@suaagencia.com.br]
App ID (Meta Dev): [App ID do seu App Business]
App Secret: [App Secret — guardar em cofre]
Token: [Long-lived ou System User Token]
Tipo do token: [long-lived / system-user]
Expira em: [YYYY-MM-DD ou "nunca" se system-user]

== DADOS POR CLIENTE == Cliente: [Nome do Cliente]
Ad Account ID: act_[XXXXXXXXXXXXXXXXX]
Page ID: [ID da Página do Facebook]
Pixel ID: [ID do Pixel instalado no site]
Instagram ID: [ID do perfil do Instagram]
WhatsApp: [número com DDI — ex: +5511999999999]
Moeda: [BRL / USD]
Acesso concedido em: [YYYY-MM-DD]
Links essenciais — Meta Ads
Guia de Agência — Alunos ClickGrowth

Google Ads
para Agências

Estrutura MCC, Developer Token básico, boas práticas desde a criação da conta e template pronto para solicitar acesso à API.

MCC — Manager Account
Developer Token básico
Email corporativo obrigatório
Template preenchível
Role para aprender do zero

Google Ads para quem
opera como agência

O Google Ads captura intenção ativa de compra — o usuário já está buscando o que você anuncia. Para agências, a operação exige uma estrutura específica de conta.

Os 5 canais principais do Google Ads
CanalOnde apareceMelhor paraNível
Search (Pesquisa)Resultados do GoogleCapturar demanda existenteComeçar aqui
DisplaySites parceirosRemarketing e alcanceIntermediário
YouTubeVídeos do YouTubeBranding e educaçãoIntermediário
Performance MaxTodos os canaisEscala com automaçãoAvançado
Demand GenYouTube + Gmail + DiscoverCriação de demandaAvançado
Google Ads — Intenção

O usuário digita a busca — ele já quer o que você oferece. CPL mais baixo, conversão mais alta.

Busca ativaCPL menorConversão alta
Meta Ads — Interrupção

O anúncio interrompe o usuário no feed. Volume maior, criativo é o diferencial.

Criativo críticoAlto volumeDemanda criada

MCC — O coração
da operação de agência

O MCC (Manager Customer Center) é a conta-mãe da agência. Sem ele você não opera como agência de verdade — e não consegue o Developer Token.

🏢 Sua Agência — MCC conta-mãe ID: XXX-XXX-XXXX
├──🏥Cliente A — ClínicaID: 123-456-7890ativo
├──🏠Cliente B — Home ServiceID: 234-567-8901ativo
├──🍕Cliente C — RestauranteID: 345-678-9012pausado
└──⚙️Conta Própria da Agênciaagência
Como criar o MCC — passo a passo
1
Use email corporativo — obrigatório
Ex: ads@suaagencia.com.br. O Google verifica o domínio durante a solicitação do Developer Token.
⚠️

Sem domínio próprio? Contrate antes de começar. Recomendado: Google Workspace — integra com a conta Google e garante o domínio .com.br.

2
Acesse a página de criação do MCC
🔗 Criar conta gerenciadora — Google Ads
3
Configure os dados — atenção: são imutáveis
Nome[Agência] — MCC
Fuso horárioAmerica/Sao_Paulo ⚠ imutável
MoedaBRL para BR / USD para EUA ⚠ imutável
4
Vincule ou crie contas de clientes
Opção A — Novo cliente
Criar nova conta do Google Ads dentro do MCC.
Opção B — Cliente existente
Vincular pelo ID de 10 dígitos — cliente aceita o convite.

O que é e por que
você precisa

O Developer Token é a chave de autenticação para a Google Ads API. Com ele você conecta scripts, automações e agentes de IA às contas dos clientes.

🤖
Agentes de IA
Operar campanhas via scripts Python
📊
Relatórios automáticos
Extrair performance de todos os clientes
Automação de lances
Ajustar bids e orçamentos em escala
🚀
Criação em escala
Subir campanhas para novos clientes
● Basic Access — Básico
15.000
operações por dia
Aprovação automática — imediata
Suficiente para até ~50 clientes
Criar campanhas, relatórios, ajustes
Comece aqui
● Standard Access — Padrão
Sem limite
operações por dia
Revisão manual — 1 a 5 dias úteis
Necessário para 100+ clientes
Upgrade disponível após usar o Basic
Faça upgrade quando precisar

Como solicitar o
Developer Token

O processo exige atenção nos detalhes — principalmente no email corporativo e na descrição de uso.

✓ Pré-requisitos — confira antes de começar
MCC criado com email corporativo
Ao menos 1 conta de cliente vinculada
Site da agência no ar
Email corporativo ativo e acessível
Passo a passo
1
Acesse o API Center dentro do MCC
Ferramentas e Configurações → Configuração → Central de APIs
🔗 Acessar API Center
⚠️

O API Center só aparece logado no MCC, não em conta-filha.

2
Preencha o formulário de solicitação
CampoO que colocar
Nome do desenvolvedor[Nome da Agência]
URL do sitehttps://www.[seusite].com.br
Email de contato[nome]@[seusite].com.br mesmo domínio
TipoAgência / Provedor de tecnologia
FuncionalidadesCampaign Management, Reporting, Keyword Planning
NívelBasic Access
ID do MCC[10 dígitos sem hífens]
3
Configure OAuth2 no Google Cloud Console
🔗 console.cloud.google.com
1. Criar projeto → agencia-ads-api
2. Habilitar Google Ads API
3. Criar credenciais OAuth2 → Tipo: App para computador
4. Copiar client_id e client_secret
5. Gerar refresh_token via OAuth2
4
Criar o arquivo google-ads.yaml
google-ads.yaml — adicionar ao .gitignore developer_token: "SEU_DEVELOPER_TOKEN"
client_id: "SEU_CLIENT_ID.apps.googleusercontent.com"
client_secret: "SEU_CLIENT_SECRET"
refresh_token: "SEU_REFRESH_TOKEN"
login_customer_id: "ID_DO_MCC_SEM_HIFENS"

Segurança e
profissionalismo

Práticas que separam agências profissionais de amadores — aplique desde o primeiro cliente.

Níveis de permissão — quem recebe o quê
NívelO que pode fazerPara quem dar
AdministradorControle total da contaApenas sócios/diretores
PadrãoCriar e editar campanhasGestores de tráfego da equipe
Somente leituraVer resultados sem editarClientes

✓ Faça

  • Separe Search e Performance Max em campanhas distintas
  • Use labels: fase:teste | fase:ativo | fase:pausado
  • Configure conversões antes de ativar qualquer campanha
  • Adicione lista de negativas desde o início
  • Colete 30-50 conversões antes de otimizar por CPA

✗ Não faça

  • Ativar campanha sem conversão configurada
  • Misturar Search e Display na mesma campanha
  • Colocar telefone no texto do anúncio (é proibido)
  • Escalar budget antes de validar o CPL
  • Solicitar Standard Access de primeira

Onboarding por
cliente Google Ads

Execute a cada novo cliente. Nenhum item é opcional.

01
Email corporativo da agência disponível e ativo@suaagencia.com.br — não Gmail pessoal
02
MCC criado, configurado e com 2FA ativadoFuso horário e moeda corretos — são imutáveis
03
Conta do cliente criada ou vinculada ao MCCNomenclatura: [Cliente] — [País/Cidade]
04
Faturamento configuradoCentralizado no MCC ou independente por conta
05
Acesso "Somente leitura" dado ao clientePara acompanhar resultados sem risco de editar
06
Conversão configurada via Google Tag ManagerSem conversão = campanha sem dados para otimizar
07
Tag de remarketing instalada no siteAcumula audiência desde o início
08
Lista de palavras-chave negativas adicionadaEvita desperdício nos primeiros dias
09
Relatório de baseline extraído antes de ativarPonto de partida para comparar em 30/60/90 dias
10
Credenciais documentadas no wiki da agênciaID da conta, email, tipo de faturamento, data de início

Modelo para solicitar
o Developer Token

Substitua apenas os campos em amarelo e cole no formulário do Google.

📬
Regra de ouro — email de envio
O formulário deve ser preenchido com o email corporativo do domínio da agência (nome@suaagencia.com.br). O email de contato no formulário deve ser do mesmo domínio do site informado. Gmail pessoal = chance alta de rejeição.
📝Descrição de uso — cole no campo livre do formulário
substitua apenas os campos em amarelo
Nome da empresa: [Nome da Sua Agência]
Site: [https://www.seusite.com.br]
Email de contato: [nome@seusite.com.br]

Descrição do uso:

[Nome da Sua Agência] é uma agência de marketing digital
especializada em tráfego pago para pequenas e médias empresas
[brasileiras / americanas]. Utilizamos a Google Ads API para
automatizar criação e otimização de campanhas Search, gerar
relatórios consolidados de performance e ajustar lances em escala.

Casos de uso: criação programática de campanhas Search, relatórios
mensais automáticos, ajuste de lances por CPA, gestão centralizada
de palavras-chave negativas. MCC ID: [ID_DO_SEU_MCC].
Gerenciamos [N] contas ativas. Operações com autorização contratual.
Links essenciais — Google Ads