Scripts e automações no Google Ads

Scripts no Google Ads continuam relevantes mesmo com smart bidding

Em meados dos últimos anos, parte do mercado passou a questionar se scripts ainda valiam o esforço diante da popularização de smart bidding (lances algorítmicos do próprio Google). O argumento era: se o algoritmo do Google ajusta lance, palavra-chave e segmentação automaticamente, scripts viraram redundância.

A resposta da prática foi diferente. Scripts continuam relevantes porque cumprem função que smart bidding não cumpre: governança e visibilidade. O algoritmo do Google otimiza para o objetivo definido (conversões, custo por aquisição alvo, retorno sobre investimento em mídia alvo), mas não avisa se a conta está pausada por erro, se uma campanha está fora do ar, se uma página de destino retorna erro 404, se um termo de busca novo está consumindo orçamento de forma anormal, se Quality Score caiu em palavras-chave críticas, ou se share de impressão despencou em campanha estratégica.

Essa camada de monitoramento e alerta é o que scripts entregam. Em conta com investimento mensal de R$ 50.000 ou mais, um alerta perdido pode significar dezenas de milhares de reais desperdiçados antes do gestor notar. Scripts são o seguro contra esse cenário.

O conjunto recomendado evoluiu: menos scripts de ajuste de lance (smart bidding faz isso melhor) e mais scripts de monitoramento, alerta e relatório.

Scripts versus regras automatizadas (rules)

O Google Ads oferece dois mecanismos de automação na interface: scripts (JavaScript customizado) e regras automatizadas (interface ponto e clique).

Regras automatizadas. Configuradas direto na interface, sem código. Permitem ações simples: pausar campanha se custo por aquisição passar de X, aumentar lance em palavras-chave com taxa de conversão acima de Y, enviar email se gasto diário ultrapassar Z. Limitações: condições simples (uma ou duas variáveis), sem acesso a dados externos, sem cálculos complexos. Boas para casos básicos e gestores sem familiaridade com JavaScript.

Scripts. Programas JavaScript executados em ambiente do Google Ads. Acessam toda a API do Google Ads, podem fazer cálculos complexos, gerar relatórios em Google Sheets, enviar alertas customizados, integrar com outras fontes (planilhas, APIs externas, BigQuery). Limitações: exigem JavaScript básico, código pode falhar silenciosamente sem governança, mudanças em conta podem quebrar scripts antigos.

Recomendação prática: regras automatizadas para casos simples e padrão (pausar palavra-chave com custo por aquisição muito alto, aumentar lance em horários específicos); scripts para monitoramento, alerta consolidado, análise de n-grama e relatório customizado.

Scripts essenciais por categoria

Não tente rodar dezenas de scripts. Concentre-se em uma seleção que cobre os riscos principais.

Alerta de anomalia de conta. Detecta variações fora do padrão em custo, cliques, conversão ou taxa de conversão. Compara o dia atual com média móvel histórica e dispara alerta por email quando há desvio significativo. O Account Anomaly Detector do próprio Google Ads é a referência clássica — Brainlabs e outros mantêm versões evoluídas. Crítico para detectar conta pausada por erro, problema de tag, campanha fora do ar.

Verificador de links (link checker). Visita todas as URLs de destino das campanhas ativas e reporta páginas com erro 404, 500 ou redirecionamento problemático. Roda diariamente ou semanalmente. Especialmente crítico em e-commerce com catálogo grande — produto sai do ar e o anúncio continua direcionando para página inexistente, queimando orçamento.

N-grama de termos de busca. Analisa o relatório de termos de busca (palavras que o usuário digitou e que dispararam um anúncio) extraindo combinações de 1, 2 ou 3 palavras (uni-grama, bi-grama, tri-grama) com volume relevante. Permite identificar termos novos para incluir como palavra-chave ou para excluir como palavra-chave negativa. Costuma reduzir desperdício em 5-20% em contas com volume.

Ritmo de orçamento (budget pacing). Monitora se a campanha está gastando no ritmo certo para o mês — gasto acumulado versus dia do mês versus orçamento total. Alerta quando ritmo está muito acelerado (risco de esgotar antes do fim) ou muito devagar (subutilização de orçamento aprovado).

Histórico de Quality Score. Google Ads não mantém histórico longo de Quality Score (pontuação de qualidade) por palavra-chave. Script salva diariamente em Google Sheets, permitindo identificar tendência de queda em palavras-chave-chave antes que vire problema grave.

Alerta de share de impressão. Monitora share de impressão (percentual de impressões elegíveis que sua campanha capturou) em campanhas estratégicas. Alerta quando cai abaixo de limite definido ou quando a perda por classificação de anúncio aumenta significativamente — sinal de concorrência crescente ou queda de qualidade.

Relatório consolidado. Gera relatório semanal ou mensal em Google Sheets com indicadores-chave por conta, campanha e grupo de anúncios. Útil em agência operando múltiplas contas — automatiza o que seria horas de exportação manual.

Onde encontrar scripts prontos

Não é preciso desenvolver script do zero. Há bibliotecas mantidas pelo próprio Google e por agências especializadas que cobrem 80% das necessidades.

Google Ads Developers — Scripts library. Biblioteca oficial do Google em developers.google.com/google-ads/scripts. Contém scripts de referência para casos comuns: Account Anomaly Detector, Link Checker, N-Gram Analysis, Bid by Weather (ajuste de lance por clima), Account Summary Report. Código aberto, documentação completa, atualização pelo time do Google. Ponto de partida ideal.

Optmyzr Free Scripts. Optmyzr é fornecedora de ferramenta paga de gestão de Google Ads, mas mantém biblioteca pública gratuita de scripts em optmyzr.com/blog (categoria de scripts). Inclui versões evoluídas de scripts clássicos e scripts próprios. Fred Vallaeys (co-fundador da Optmyzr) é autor de referência no tema.

Brainlabs Digital. Agência britânica especializada em Google Ads que mantém repositório de scripts em código aberto (em GitHub, sob o nome da agência). Versões muitas vezes mais robustas e flexíveis que as oficiais. Documentação cuidadosa.

Free Adwords Scripts (FreeAdwordsScripts.com). Site mantido por Russ Savage com biblioteca pública de scripts. Inclui exemplos avançados e tutoriais.

GitHub — busca por "google ads scripts". Repositórios diversos de agências e profissionais individuais. Cuidado com manutenção — alguns scripts ficam desatualizados em relação a mudanças na API do Google.

Ferramentas pagas: quando vale a pena

Em contas com investimento mensal acima de R$ 30.000-50.000, ferramentas pagas geralmente se pagam pelo tempo economizado e pela otimização que entregam.

Optmyzr. Plataforma fundada por Fred Vallaeys (ex-Google Ads) com foco em auditoria, recomendações e relatórios. Funcionalidades principais: auditoria de conta com pontuação, recomendações de palavra-chave e palavra-chave negativa, gestão de orçamento, relatório de cliente, biblioteca de scripts integrados. Preço a partir de US$ 200/mês para conta pequena, escalando com volume e número de contas.

Adalysis. Plataforma com foco em otimização de anúncio (testes A/B de anúncios, análise de Quality Score, recomendações de termos). Auditoria contínua. Preço a partir de US$ 150/mês.

Skai (antes Kenshoo) e Marin Software. Plataformas enterprise para empresas muito grandes com orçamento de mídia paga acima de US$ 1 milhão por mês. Cobertura multi-plataforma (Google, Meta, Microsoft, TikTok, Pinterest). Preço sob consulta, geralmente fee mais percentual sobre mídia.

SpyFu, SEMrush, Ahrefs. Ferramentas mais focadas em inteligência competitiva (o que concorrente está fazendo) que em gestão direta da conta. Complementares a scripts e ferramenta de gestão.

SE Ranking. Plataforma com cobertura ampla (SEO, anúncios, monitoramento de concorrência) a preço acessível.

Critério para decidir: se o tempo economizado pelo time de marketing supera o custo da ferramenta, vale a pena. Em conta com investimento de R$ 100.000/mês e analista dedicado, Optmyzr ou Adalysis costumam economizar 15-30 horas por mês — facilmente justifica o custo da ferramenta.

Permissões e governança

Scripts têm permissões poderosas — podem pausar campanha, alterar lance, mudar palavra-chave, gerar relatório com dado sensível. Sem governança, são vetor de risco operacional.

Controle de acesso ao editor de scripts. Apenas usuários com permissão de administrador ou gestor padrão devem ter acesso ao editor. Em equipe grande, restrinja ao analista sênior ou ao gestor de mídia.

Ambiente de teste. Antes de implementar script em conta de produção, teste em conta de teste ou em modo de execução simulada (preview). Especialmente crítico para scripts que fazem alterações (pausar, ajustar lance), não apenas leitura e alerta.

Log de mudanças. Documente cada implementação ou alteração de script em planilha versionada: data, quem alterou, o que mudou, motivo. Sem log, em 6 meses ninguém lembra por que um script foi criado.

Revisão periódica. Pelo menos uma vez por trimestre, revise todos os scripts em execução: ainda fazem sentido? Estão rodando sem erro? Geram alerta que alguém lê? Scripts órfãos rodando há anos sem ninguém olhar são consumo desnecessário de cota e fonte de risco.

Documentação por script. Comentário no topo do código explicando o que faz, quem implementou, quando, com que objetivo, contatos para suporte. Trabalho de 5 minutos que salva horas no futuro.

Erros comuns em scripts

Script que pausa campanha por engano. Lógica mal escrita ou condição imprecisa pausa campanha estratégica. Mitigação: testar antes em conta de teste, usar modo preview, configurar alerta de email antes de qualquer ação destrutiva.

Sem revisão de log de execução. Script falha silenciosamente. Operação descobre semanas depois quando algo dá errado. Mitigação: revisão semanal das execuções na seção "Scripts > Log" do Google Ads. Configurar alerta de email em caso de erro.

Script herdado sem documentação. Gestor anterior implementou script complexo, não documentou, saiu da empresa. Time atual não sabe o que faz nem se ainda é necessário. Mitigação: documentação obrigatória no topo de cada script.

Múltiplos scripts conflitando. Dois scripts diferentes ajustam o mesmo lance ou pausam a mesma campanha por critérios diferentes. Resultado imprevisível. Mitigação: lista consolidada de scripts em uso, com proibição de implementação sem revisão prévia.

Script com dado sensível em planilha pública. Script gera relatório em Google Sheets com dado financeiro detalhado, planilha está com permissão "qualquer um com o link". Vazamento involuntário. Mitigação: planilhas com controle de acesso por usuário, revisão periódica de permissões.

Não atualizar script quando API muda. Google ajusta API do Google Ads periodicamente. Scripts antigos quebram. Mitigação: alerta de erro por email, revisão trimestral.

Confiar em scripts sem entender o que fazem. Implementação por copy-paste de tutorial sem entender o código. Quando algo dá errado, ninguém sabe consertar. Mitigação: pelo menos uma pessoa do time precisa entender JavaScript básico antes de operar scripts customizados.