google ads pelo claude code: termos de busca, negativas e quality score numa conversa — Ratos de IA
tráfego pago

google ads pelo claude code: termos de busca, negativas e quality score numa conversa

como gerenciar google ads pelo claude code: termos de busca, negativas, quality score e keyword planner pela API oficial, com o acesso novo do google cloud.

por · 21 nov 2026

google ads pelo claude code: termos de busca, negativas e quality score numa conversa

aqui na DobraLabs, um laboratório de design, tecnologia e IA, e na Ratos de IA, a nossa frente de educação que vende cursos de IA (além do canal no youtube, da newsletter e da comunidade), a gente toca o próprio tráfego pago conversando com o agente. a primeira vez que a gente abriu o google ads da Ratos de IA pelo claude code, eram 593 cliques e zero conversão registrada. o motivo era bobo: a tag de conversão nem estava no site. gerenciar google ads pelo claude code é isso, perguntar em português e o agente ler a conta inteira pela API oficial do google: termos de busca, quality score, keywords, negativas, campanhas. ele cria e edita quando tu manda, sempre pausado e com confirmação. abaixo tem como configurar o acesso (que mudou em setembro de 2026), os pedidos que a gente mais faz e o caso inteiro da nossa conta, com o erro que a gente cometeu.

como funciona o google ads pelo claude code

o google ads pelo claude code funciona com scripts que falam com a API oficial. pra quem não sabe, o Claude Code é o agente da Anthropic que roda comandos no teu computador ou num servidor. a skill google-ads-ratos, uma das que a gente vende pros alunos (skill é um pacote de instruções e scripts que ensina o agente a fazer uma tarefa), entrega pra ele um conjunto de scripts em python que usam o SDK oficial google-ads e a GAQL, a linguagem de consulta do google ads.

tu escreve “quais termos de busca gastaram mais de 50 reais sem converter no último mês” e o agente roda o script certo, lê a saída e te responde com o número e o que ele significa. por baixo, é algo assim:

python3 scripts/read.py search-terms --customer-id 1234567890
python3 scripts/read.py quality-scores --customer-id 1234567890
python3 scripts/insights.py campaign --customer-id 1234567890 --date-range LAST_30_DAYS

tu nunca precisa digitar isso. mas vale saber que existe, porque quando o agente responde algo estranho, tu pede pra ele mostrar o comando e a saída crua.

o que mudou no acesso à API em setembro de 2026

o acesso à API do google ads mudou em 09/09/2026: o google aposentou o developer token e o nível de acesso passou a ser do projeto do google cloud onde tu cria as credenciais OAuth. quem já tinha token teve o acesso transferido sozinho pro projeto. quem está começando agora pede o nível na página Google Ads API Overview do cloud console, e não precisa mais de conta de gerenciamento (mcc) pra isso, como o google explicou no anúncio do novo cadastro.

os níveis que importam, pela página oficial de níveis de acesso:

nívelo que liberaoperações por dia em conta real
testesó contas de testenenhuma
explorercontas reais, sem planejamento (keyword planner fica de fora)2.880
basiccontas reais, com keyword planner15.000

duas armadilhas que pegam quase todo mundo no setup:

a parte chata, gerar o token de renovação, a skill faz sozinha: abre o navegador, tu autoriza e ele é salvo. a gente atualizou a skill em outubro de 2026 pra funcionar sem developer token, porque era exatamente o que travava quem chegou depois de setembro.

termos de busca: onde a verba vaza

o relatório de termos de busca é onde o dinheiro escapa numa conta de search, e é o que menos gente revisa, porque ler linha por linha toda semana é chato. por conversa, vira uma pergunta.

no nosso caso, o termo “startse ai” (o nome de outra escola de IA) estava gerando clique num grupo de anúncios de curso. eram 14 cliques e R$ 3,03, pouco dinheiro, mas o detalhe que importa é outro: a negativa pra esse termo tinha sido combinada cinco dias antes e não tinha sido aplicada. o agente só percebeu porque releu a conta. desde então, toda escrita termina com o agente lendo a conta de volta pra conferir.

pedidos que a gente faz aqui:

negativas e tipo de correspondência

negativa é a palavra que tu proíbe de disparar o teu anúncio, e o tipo de correspondência decide o quanto ela pega. as que a gente colocou na conta da Ratos de IA dão o tom:

e o contrário também: a keyword “aprender claude code” estava em correspondência ampla, puxando busca demais, e foi trocada pra frase. o comando que o agente roda pra negativar é este:

python3 scripts/create.py negative --customer-id 123 --campaign-id 456 \
  --text "startse" --match-type BROAD

quality score decomposto

o quality score de 1 a 10 sozinho diz pouco. o que ajuda é a decomposição em três partes: relevância do anúncio, experiência na página de destino e taxa de clique esperada. a skill puxa as três por keyword, e aí dá pra ver se o problema está no texto do anúncio ou na página.

na nossa conta, a maioria das keywords estava em 5 de 10, e “claude code preço” estava em 3. com a decomposição na mão, a conversa muda de “o google não gosta da gente” pra “a página não responde o que essa busca pergunta”.

keyword planner antes de montar campanha

o keyword planner pela API devolve volume mensal, CPC estimado e concorrência, sem precisar criar campanha. a skill já vem com Brasil e português como padrão (--location-id 2076, --language-id 1014).

python3 scripts/keyword_planner.py ideas --keywords "curso de ia|automação com ia" --limit 50
python3 scripts/keyword_planner.py ideas --url https://teusite.com.br --limit 100
python3 scripts/keyword_planner.py historical-metrics --keywords "claude code|cursor ai"

o segundo comando é o que a gente mais usa: dá a página do cliente e volta a lista de buscas relacionadas. lembra que isso precisa do nível basic.

o caso inteiro da nossa conta

o histórico do google ads da Ratos de IA virou um bom exemplo do que o agente faz bem e do que ele não decide por ti. em abril de 2026, numa semana:

  1. o diagnóstico. 3 campanhas de search rodando, 593 cliques, zero conversão. a tag de conversão do google ads não estava no site. o agente baixou o orçamento pro mínimo até o rastreio funcionar, a gente instalou a tag (início de checkout no clique do botão, compra na página de obrigado) e o orçamento voltou.
  2. o segundo buraco. cinco dias depois, 885 cliques, R$ 113 gastos e ainda zero conversão atribuída. nenhum anúncio tinha UTM. a correção foi um sufixo de URL final em todas as campanhas, com os parâmetros que o google preenche sozinho: utm_source=google&utm_medium=cpc&utm_campaign={campaignid}&utm_content={adgroupid}&utm_term={keyword}.
  3. o anúncio desatualizado. o anúncio responsivo do curso generalista ainda dizia R$ 197, e a página cobrava R$ 97 havia uma semana. anúncio no ar não se edita: o agente pausou o antigo e criou um novo com os 4 textos corrigidos. aprendizado registrado na skill: R$ no terminal vai entre aspas simples, senão o shell come o $97.
  4. a decisão. com 4 dias de UTM rodando, a gente cruzou o google analytics com o banco de compras. google: 962 sessões, 19 segundos de duração média, zero compra. meta, no mesmo período: 864 sessões, 60 segundos, 19 compras. as três campanhas foram pausadas.

o problema estava no encaixe: quem busca “claude code” no google quer aprender a ferramenta, e a página falava de outra coisa. nenhum ajuste de lance conserta isso. o agente juntou os números em minutos; a leitura de que era desencaixe entre busca e página foi nossa. o post sobre relatório do GA4 com IA mostra como fazer esse cruzamento.

as travas antes de mexer em verba

as regras que estão escritas na google-ads-ratos:

na meta a API conta orçamento em centavos e no google em reais, e é por isso que a skill nunca deixa o agente escrever o valor em micros na mão. eu contei as travas do lado da meta no post de gestão de meta ads com claude code.

skill ou MCP oficial do google

o google publica um servidor MCP do google ads. pra quem não sabe, MCP é um jeito padrão de plugar uma ferramenta no agente (tem um post só sobre MCP no claude).

MCP oficial do google adsskill google-ads-ratos
leitura da contasimsim
escritaparcial: criar asset e mexer em rótulocampanha, grupo, keyword, negativa, anúncio, sitelink, callout, orçamento
keyword plannerpela consulta geralcomando próprio
pode ficar só leiturasim, por configuraçãoa ga4 e a análise são só leitura; a escrita pede confirmação

pra só olhar a conta, o MCP oficial resolve. pra rodar a conta no dia a dia, a gente segue na skill, e a leitura crítica (benchmark, nota de saúde, ordem do que atacar) fica com a ads-ratos, outra skill nossa, que analisa a conta e nunca mexe em nada. a DobraLabs escreveu sobre o conjunto completo no post das 4 skills de tráfego pago no Claude Code.

o agente acha o termo que vaza, o anúncio com preço velho e a campanha sem rastreio em minutos. se o canal combina com a tua oferta, quem decide é tu.

perguntas frequentes

ainda em dúvida?

ainda preciso de developer token pra usar a API do google ads?

não. o google aposentou o developer token em 09/09/2026. o nível de acesso agora pertence ao projeto do google cloud onde tu criou as credenciais OAuth, e o pedido de acesso é feito na página Google Ads API Overview do cloud console. quem já tinha token teve o acesso transferido pro projeto.

por que o keyword planner dá erro pela API?

porque o nível explorer, o primeiro que libera conta real, bloqueia os serviços de planejamento, e o keyword planner está entre eles. pra usar, o projeto precisa do nível basic, que exige verificação de marca. o resto da gestão funciona no explorer.

o claude code pode mexer no meu orçamento sozinho?

na google-ads-ratos, não. tudo nasce pausado, e ativar, apagar ou mudar orçamento pede confirmação. aumento maior que 3 vezes o orçamento atual é bloqueado e precisa de uma flag explícita.

existe MCP oficial do google ads?

existe. o google publica um servidor MCP do google ads que lê a conta e tem escrita parcial (criar asset e mexer em rótulo), e dá pra configurar como só leitura. pra subir negativa, criar campanha e mexer em orçamento, a gente usa a skill.

dá pra gerenciar conta de cliente e mcc?

dá. tu cadastra o mcc e as contas dos clientes por apelido, e chama pelo nome. desde a mudança de setembro de 2026, mcc deixou de ser obrigatório pra acessar a API.

black friday da ratos · lote 2
tudo que a gente ensina, a Ratoeira e a comunidade, numa assinatura só.

os cursos inteiros, as skills que a gente usa no dia a dia, a Ratoeira pra rodar teus agentes numa máquina tua e a comunidade pra trocar com quem tá fazendo o mesmo. no lote 2 da Black sai por 12x de R$ 113,46 ou R$ 1.097 à vista, e o preço sobe a cada lote.

ver a oferta da Black → 7 dias de garantia
últimos posts
Tutoriais criativo de anúncio com IA: os 3 formatos da meta, na tua marca, sem texto torto Tutoriais rotinas: o agente de ia trabalhando sozinho num horário Tutoriais como cortar vídeo longo em reels com ia (e limpar a gravação bruta)
guias da ratos
ver todos os guias →
🔷 a Ratos é feita pela DobraLabs
laboratório de IA que testa inteligência artificial de verdade no próprio dia a dia pra ensinar e construir pra empresas: workshops in-company, automações e sistemas sob medida.
conhecer a dobralabs →