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ível | o que libera | operações por dia em conta real |
|---|---|---|
| teste | só contas de teste | nenhuma |
| explorer | contas reais, sem planejamento (keyword planner fica de fora) | 2.880 |
| basic | contas reais, com keyword planner | 15.000 |
duas armadilhas que pegam quase todo mundo no setup:
- o keyword planner trava no explorer. o erro que volta ainda tem o nome antigo,
DEVELOPER_TOKEN_NOT_APPROVED. o resto da skill funciona; a pesquisa de palavra-chave pede o basic, que exige verificação de marca do projeto (site e política de privacidade no domínio verificado). - o token de renovação vence em 7 dias se o app OAuth ficar em modo teste. tem que publicar o app no google auth platform. na autorização aparece “o google não verificou este app”: é o teu próprio app, segue em avançado.
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:
- “lista os termos de busca dos últimos 30 dias com custo e conversão, do mais caro pro mais barato”
- “quais termos não têm nada a ver com o que a gente vende?”
- “sobe essas três como negativa de frase na campanha de curso”
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:
[anthropic]em correspondência exata, pra não pagar por quem procura a empresa."claude code api"e"claude by anthropic"em frase, porque quem busca isso quer documentação técnica.- startse, puc, graduação e faculdade em ampla, na campanha do Generalista de IA, o nosso curso pra quem não é técnico, porque quem busca isso quer diploma.
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:
- 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.
- 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}. - 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. - 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:
- tudo nasce pausado. campanha, grupo, keyword e anúncio.
- confirmação pra ativar, apagar e mudar orçamento. o agente mostra o valor em reais e espera.
- orçamento em reais.
--budget 50é R$ 50 por dia (aceita vírgula). aumento maior que 3 vezes o atual é bloqueado e precisa de--force. depois de aplicar, o script relê o valor na conta e mostra “confirmado na conta”. - ativar todos os níveis juntos, na ordem campanha, grupo, anúncio.
- quebrar por campanha antes de atribuir resultado. nunca dizer que uma venda veio de uma campanha olhando só o total da conta.
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 ads | skill google-ads-ratos | |
|---|---|---|
| leitura da conta | sim | sim |
| escrita | parcial: criar asset e mexer em rótulo | campanha, grupo, keyword, negativa, anúncio, sitelink, callout, orçamento |
| keyword planner | pela consulta geral | comando próprio |
| pode ficar só leitura | sim, por configuração | a 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.