Como monitorar alterações no Google Ads automaticamente (e o que cada método deixa passar)

Equipe Changeline · Publicado em · 8 min de leitura

Dá para monitorar alterações no Google Ads automaticamente de quatro formas: consultar o Histórico de alterações na interface (últimos 2 anos), agendar um script que grava as linhas do change_event numa planilha, consultar o recurso change_event da API (últimos 30 dias, 10.000 linhas por consulta) ou conectar uma ferramenta que importa as alterações para uma linha do tempo compartilhada.

Como monitorar alterações no Google Ads de forma automática?

O Google Ads já registra a maior parte das edições para você. A questão é onde esse registro fica, por quanto tempo você consegue acessá-lo e se alguém o vê ao lado das outras mudanças que mexem nos seus resultados. Existem quatro opções práticas, de zero configuração até totalmente automático.

MétodoQuanto tempo para trásConfiguraçãoMelhor paraPrincipal lacuna
Histórico de alterações na interfaceÚltimos 2 anosNenhumaConsultas pontuais em uma contaRevisão manual, uma conta por vez, sem contexto fora do Google Ads
Script do Google Ads gravando numa planilhaÚltimos 30 dias por execução (change_event)Colar e agendar um scriptLog diário ou alerta para poucas contasVocê mantém o código; cada execução tem limite de 30 minutos
API do Google Ads (change_event)Últimos 30 diasToken de desenvolvedor, código e armazenamentoTimes com engenharia e data warehouse10.000 linhas por consulta; edições do Google Ads Editor não aparecem
Ferramenta de log de mudanças com importaçãoDepende da ferramentaConectar a contaAgências e times que precisam de uma linha do tempo únicaCobre só as plataformas que a ferramenta integra

Abaixo você vê o que cada método registra, onde ele para e como usar o resultado quando uma métrica muda. Se você só precisa ler a tela de histórico, o guia do histórico de alterações do Google Ads mostra o passo a passo.

O que o histórico de alterações do Google Ads registra sozinho?

O Histórico de alterações lista as mudanças feitas na conta, nas campanhas e nos grupos de anúncios nos últimos 2 anos; dados mais antigos não ficam disponíveis. Você abre a ferramenta em "Histórico de alterações", no menu "Campanhas", ou a partir de uma campanha ou grupo de anúncios específico.

  • Quem: a coluna "Usuário" mostra o e-mail de quem fez a alteração na interface. Sistemas automáticos ou internos do Google podem aparecer como "ads-dartsearch-budget" ou "Sistema do Google Ads", e mudanças via API como "Google Ads API" ou o nome da ferramenta.
  • O quê: dá para filtrar por tipo de alteração, como ajustes de orçamento ou edições de palavras-chave, e ver cada mudança numa linha do tempo cruzada com impressões, cliques, conversões, CTR e custo.
  • Limite de detalhes: o Google limita os detalhes exibidos por entrada e recomenda alterações que afetem menos de 2.000 entidades para ver tudo.

É automático no sentido de que ninguém precisa registrar nada. Não é automático no sentido de que alguém ainda precisa abrir cada conta, escolher o período e ler as linhas, e ele não diz nada sobre o seu site, as tags ou o CRM.

Como gravar as alterações do Google Ads numa planilha com um script?

Um script do Google Ads pode consultar o recurso change_event todos os dias e adicionar as linhas numa planilha do Google, o que dá um log contínuo sem precisar de engenharia. Scripts aceitam a Google Ads Query Language (GAQL) por meio de AdsApp.search() e AdsApp.report().

  1. No Google Ads, clique no ícone de ferramentas, abra "Ações em massa" e escolha "Scripts".
  2. Crie um script que rode uma consulta como SELECT change_event.change_date_time, change_event.user_email, change_event.client_type, change_event.change_resource_type, change_event.changed_fields FROM change_event WHERE change_event.change_date_time >= '2026-10-06' AND change_event.change_date_time <= '2026-10-07' ORDER BY change_event.change_date_time LIMIT 10000 e grave cada linha na planilha.
  3. Visualize, autorize e defina a frequência. A central de ajuda lista as opções uma vez, diariamente, semanalmente ou mensalmente, no horário que você escolher.
  4. Se quiser, envie um e-mail quando a alteração vier de alguém fora de uma lista aprovada. Scripts de especialistas, como o alerta de histórico de alterações de Nils Rooijmans, fazem exatamente isso e permitem ignorar usuários de confiança.

Limites a considerar: um script em conta de anunciante roda por no máximo 30 minutos (60 minutos para alguns scripts de conta de administrador que processam contas em paralelo), a consulta não passa de 30 dias e o código é seu quando o Google muda a API. Para poucas contas, é o log automático mais barato que dá para montar.

O que o recurso change_event da API do Google Ads entrega?

O change_event é a visão do histórico de alterações pela API: uma linha por mudança, com valores antigos e novos. É o que scripts e a maioria das ferramentas de terceiros leem por trás.

  • Campos: change_date_time, user_email, client_type (por exemplo, cliente web do Google Ads ou Google Ads API), change_resource_type, resource_change_operation (criar, atualizar, remover), changed_fields, old_resource e new_resource.
  • Janela: o período precisa estar dentro dos últimos 30 dias, e o filtro em change_date_time é obrigatório.
  • Volume: cada consulta exige LIMIT de no máximo 10.000 linhas, então contas movimentadas precisam de várias consultas divididas por data.
  • Latência: uma alteração pode levar até três minutos para aparecer.
  • Pontos cegos: o Google avisa que nem toda alteração aparece no change_event e que mudanças feitas no Google Ads Editor não podem ser recuperadas por ele.

Por causa da janela de 30 dias, tudo o que é construído sobre o change_event precisa rodar com frequência e guardar as linhas em outro lugar. Se parar por cinco semanas, o buraco fica permanente nesse armazenamento, mesmo que a interface ainda mostre os últimos 2 anos.

O que uma ferramenta de log de mudanças com importação do Google Ads acrescenta?

Uma ferramenta de log de mudanças cuida do agendamento e do armazenamento e coloca as alterações do Google Ads ao lado do que muda fora dele. Essa segunda parte é o que torna o registro útil quando você precisa explicar um resultado.

No Changeline, por exemplo, você conecta uma conta do Google Ads com acesso somente leitura. A primeira conexão traz os últimos 30 dias e, depois, as alterações sincronizam a cada 6 horas, com atualização manual quando você precisa antes. Cada item importado mostra o que mudou (antes → depois), quem mudou e a origem: interface, API, scripts, regras automatizadas ou recomendações. As alterações importadas e registradas ficam guardadas enquanto o projeto existir, então dá para ver o que foi mexido nas mesmas semanas do ano passado. Meta Ads e outras integrações chegam em breve; hoje o time registra essas mudanças à mão na mesma linha do tempo.

Seja qual for a ferramenta, faça três perguntas: ela guarda o histórico depois da janela da API da plataforma, mostra a origem de cada alteração e deixa o time adicionar o que ela não importa?

Quais alterações o monitoramento automático deixa passar?

Todo método automático só enxerga o que acontece dentro do Google Ads, e mesmo ali tem lacunas. As mudanças que mais explicam uma queda costumam estar fora da conta de anúncios.

  • Uploads do Google Ads Editor: não aparecem no change_event; confira a interface nessas datas ou registre os uploads em massa à mão.
  • Site e landing pages: um formulário novo, mudança de preço, uma versão nova do checkout, uma página mais lenta.
  • Mensuração: uma tag editada no Google Tag Manager, atualização do banner de consentimento, uma ação de conversão trocada entre principal e secundária.
  • CRM e vendas: novas regras de qualificação de leads, upload de conversões offline pausado, mudança no tempo de resposta do comercial.
  • Outros canais: Meta Ads, e-mail, orgânico e parceiros que deslocam a demanda.
  • O motivo: nenhum sistema registra por que um orçamento subiu ou o que o time esperava que acontecesse.

Por isso um log de mudanças de marketing mistura alterações importadas com as que o time registra, cada uma com data, responsável e motivo. Um modelo de log de mudanças compartilhado já basta para começar se você ainda não tem ferramenta.

Como usar as alterações monitoradas para descobrir o que mexeu na métrica?

Coloque todas as mudanças dos dias anteriores à variação numa única linha do tempo, descarte primeiro a mensuração e teste uma hipótese por vez. O monitoramento automático só se paga se for usado assim.

  1. Marque a data em que a métrica mudou e os 7 a 14 dias anteriores.
  2. Levante todas as mudanças nessa janela: edições do time no Google Ads, automações da plataforma (recomendações aplicadas automaticamente, regras automatizadas, scripts), mudanças de site, mensuração e CRM e eventos externos, como uma promoção do concorrente ou um feriado.
  3. Descarte a mensuração primeiro. Se as conversões caíram, mas sessões, leads no CRM ou pedidos não, o problema é de medição, não de desempenho.
  4. Teste uma hipótese por vez. Veja se a queda se limita às campanhas, dispositivos ou ações de conversão que a mudança afetou.
  5. Anote o resultado na mesma linha do tempo para a próxima pessoa não começar do zero.

Exemplo (ilustrativo): o CPA sobe 30% numa terça-feira. As alterações importadas do Google Ads mostram um CPA desejado reduzido na sexta e uma recomendação que adicionou palavras-chave de correspondência ampla no sábado; o log do time mostra uma landing page nova na segunda. As conversões no CRM estão estáveis, então a mensuração está ok. Os termos de pesquisa das novas palavras-chave concentram a maior parte do custo extra, então você testa isso primeiro. Para o método completo, veja a análise de causa raiz em marketing, como as recomendações aplicadas automaticamente mexem nas contas e o guia para explicar uma queda de conversões ao cliente.

Perguntas frequentes

O Google Ads avisa quando alguém altera a minha conta?

O Histórico de alterações não envia alertas sozinho. A solução mais comum é um script do Google Ads que consulta o change_event todo dia, grava as linhas numa planilha do Google e manda um e-mail quando a alteração vem de um usuário que não está na sua lista aprovada.

Até quando dá para ver as alterações no Google Ads?

Na interface, o Histórico de alterações lista as mudanças dos últimos 2 anos; dados mais antigos não ficam disponíveis. Pelo recurso change_event da API, e portanto pelos scripts que o usam, só é possível consultar os últimos 30 dias, então uma ferramenta precisa rodar com frequência e guardar as linhas para manter um registro mais longo.

As alterações feitas no Google Ads Editor aparecem na API?

Não. A documentação do change_event diz que mudanças feitas no Google Ads Editor não podem ser recuperadas por ele, embora o Editor apareça como tipo de cliente. Confira o Histórico de alterações na interface nessas datas ou registre à mão os uploads em massa do Editor, com data e motivo.

Como ver quem fez uma alteração no Google Ads?

No Histórico de alterações, a coluna "Usuário" mostra o e-mail de quem fez a mudança na interface. Sistemas automáticos aparecem com nomes como "Sistema do Google Ads", e mudanças via API como "Google Ads API" ou o nome da ferramenta. Na API, a mesma informação está em user_email e client_type.

Um script do Google Ads basta para uma agência monitorar alterações?

Para poucas contas, um script diário que grava o change_event numa planilha funciona. Com muitos clientes fica mais difícil: cada script roda por no máximo 30 minutos, alguém precisa manter o código e a planilha não tem as mudanças de site, mensuração ou CRM, que muitas vezes explicam a queda.

Fontes

  1. Sobre o Histórico de alterações – Ajuda do Google Ads
  2. Evento de alteração – API do Google Ads
  3. Usar scripts para fazer alterações automatizadas – Ajuda do Google Ads
  4. Limites – Scripts do Google Ads
  5. Relatórios – Scripts do Google Ads
  6. Google Ads Script – Change History Alerts – Nils Rooijmans

Todas as alterações em uma linha do tempo

O Changeline é um log de alterações de marketing para agências e times de growth. Registre uma alteração em segundos e veja ao lado de todos os outros canais. Grátis durante o acesso antecipado.

Começar grátis