Como registar alterações no Google Ads automaticamente (e o que cada método não apanha)

A equipa do Changeline · Publicado a · 8 min de leitura

Há quatro formas de registar alterações no Google Ads automaticamente: consultar o Histórico de alterações na interface (últimos 2 anos), agendar um script que grava as linhas do change_event numa folha de cálculo, consultar o recurso change_event da API (últimos 30 dias, 10 000 linhas por consulta) ou ligar uma ferramenta que importa as alterações para uma cronologia partilhada.

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

O Google Ads já regista a maior parte das edições por si. A questão é onde fica esse registo, durante quanto tempo lhe consegue aceder e se alguém o vê ao lado das outras alterações que mexem nos resultados. Existem quatro opções práticas, desde nenhuma configuração até um processo totalmente automático.

MétodoAté quando recuaConfiguraçãoIndicado paraPrincipal falha
Histórico de alterações na interfaceÚltimos 2 anosNenhumaVerificações pontuais numa contaRevisão manual, uma conta de cada vez, sem contexto fora do Google Ads
Script do Google Ads a gravar numa folha de cálculoÚltimos 30 dias por execução (change_event)Colar e agendar um scriptRegisto diário ou alerta para poucas contasO código é mantido por si; cada execução tem um limite de 30 minutos
API do Google Ads (change_event)Últimos 30 diasToken de programador, código e armazenamentoEquipas com engenharia e data warehouse10 000 linhas por consulta; as edições do Google Ads Editor não são devolvidas
Ferramenta de registo de alterações com importaçãoDepende da ferramentaLigar a contaAgências e equipas que precisam de uma cronologia únicaCobre apenas as plataformas que a ferramenta integra

Em seguida verá o que cada método regista, onde para e como usar o resultado quando uma métrica muda. Se só precisa de ler o ecrã do histórico, o guia do histórico de alterações do Google Ads explica-o passo a passo.

O que regista, por si só, o histórico de alterações do Google Ads?

O Histórico de alterações lista as alterações feitas à conta, às campanhas e aos grupos de anúncios nos últimos 2 anos; os dados mais antigos deixam de estar disponíveis. Abre-se 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 de utilizador ("Usuário" na interface em português) mostra o e-mail da pessoa que fez a alteração na interface. Os sistemas automáticos ou internos da Google podem surgir como "ads-dartsearch-budget" ou "Sistema do Google Ads", e as alterações via API como "Google Ads API" ou com o nome da ferramenta.
  • O quê: pode filtrar por tipo de alteração, como ajustes de orçamento ou edições de palavras-chave, e ver cada alteração numa cronologia cruzada com impressões, cliques, conversões, CTR e custo.
  • Limite de detalhe: a Google limita o detalhe mostrado por entrada e recomenda alterações que afetem menos de 2000 entidades para ver tudo.

É automático no sentido em que ninguém tem de registar nada. Não é automático no sentido em que alguém continua a ter de abrir cada conta, escolher o período e ler as linhas, e não diz nada sobre o site, as etiquetas ou o CRM.

Como gravar as alterações do Google Ads numa folha de cálculo com um script?

Um script do Google Ads pode consultar o recurso change_event todos os dias e acrescentar as linhas a uma folha de cálculo do Google, o que lhe dá um registo contínuo sem trabalho de engenharia. Os scripts aceitam a Google Ads Query Language (GAQL) através de AdsApp.search() e AdsApp.report().

  1. No Google Ads, clique no ícone de ferramentas, abra o menu "Ações em massa" e escolha "Scripts".
  2. Crie um script que execute 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 folha.
  3. Pré-visualize, autorize e defina a frequência. A ajuda da Google indica as opções uma vez, diariamente, semanalmente ou mensalmente, à hora que 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 precisamente isso e permitem ignorar utilizadores de confiança.

Limites a ter em conta: um script numa conta de anunciante corre no máximo 30 minutos (60 minutos para alguns scripts de conta de gestor que processam contas em paralelo), a consulta não ultrapassa 30 dias e a manutenção do código fica do seu lado quando a Google altera a API. Para poucas contas, é o registo automático mais barato que consegue montar.

O que lhe dá o recurso change_event da API do Google Ads?

O change_event é a vista do histórico de alterações através da API: uma linha por alteração, com os valores antigos e novos. É o que os scripts e a maioria das ferramentas de terceiros leem nos bastidores.

  • 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 intervalo de datas tem de estar dentro dos últimos 30 dias, e o filtro em change_date_time é obrigatório.
  • Volume: cada consulta exige um LIMIT de no máximo 10 000 linhas, por isso contas com muita atividade precisam de várias consultas divididas por data.
  • Latência: uma alteração pode demorar até três minutos a aparecer.
  • Pontos cegos: a Google avisa que nem todas as alterações aparecem no change_event e que as alterações feitas no Google Ads Editor não podem ser obtidas através dele.

Por causa da janela de 30 dias, tudo o que assenta no change_event tem de correr com regularidade e guardar as linhas noutro sítio. Se parar durante cinco semanas, a falha fica permanente nesse armazenamento, mesmo que a interface continue a mostrar os últimos 2 anos.

O que acrescenta uma ferramenta de registo de alterações com importação do Google Ads?

Uma ferramenta de registo de alterações trata do agendamento e do armazenamento e coloca as alterações do Google Ads ao lado das que acontecem fora dele. É esta segunda parte que torna o registo útil quando tem de explicar um resultado.

No Changeline, por exemplo, liga uma conta do Google Ads com acesso só de leitura. A primeira ligação traz os últimos 30 dias e, a partir daí, as alterações sincronizam a cada 6 horas, com atualização manual quando precisa delas mais cedo. Cada item importado mostra o que mudou (antes → depois), quem o mudou e a origem: interface, API, scripts, regras automatizadas ou recomendações. As alterações importadas e registadas ficam guardadas enquanto o projeto existir, pelo que pode ver o que foi alterado nas mesmas semanas do ano passado. O Meta Ads e outras integrações chegam em breve; por agora, a equipa regista essas alterações à mão na mesma cronologia.

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

Que alterações escapam ao registo automático?

Qualquer método automático só vê o que acontece dentro do Google Ads, e mesmo aí tem falhas. As alterações que mais explicam uma quebra estão muitas vezes fora da conta de anúncios.

  • Carregamentos do Google Ads Editor: não são devolvidos pelo change_event; verifique a interface nessas datas ou registe à mão os carregamentos em massa.
  • Site e landing pages: um novo formulário, uma alteração de preço, uma nova versão do checkout, uma página mais lenta.
  • Medição: uma etiqueta editada no Google Tag Manager, uma atualização do banner de consentimento, uma ação de conversão passada de principal a secundária.
  • CRM e vendas: novas regras de qualificação de contactos, carregamento de conversões offline em pausa, mudança no tempo de resposta comercial.
  • Outros canais: Meta Ads, e-mail, orgânico e parceiros que deslocam a procura.
  • O motivo: nenhum sistema regista porque é que um orçamento subiu nem o que a equipa esperava que acontecesse.

É por isso que um registo de alterações de marketing junta alterações importadas com as que a equipa regista, cada uma com data, responsável e motivo. Um modelo de registo de alterações partilhado chega para começar se ainda não tem ferramenta.

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

Coloque todas as alterações dos dias anteriores à variação numa única cronologia, exclua primeiro a medição e teste uma hipótese de cada vez. O registo automático só compensa se for usado assim.

  1. Marque a data em que a métrica mudou e os 7 a 14 dias anteriores.
  2. Reúna todas as alterações nessa janela: edições da equipa no Google Ads, automatismos da plataforma (recomendações aplicadas automaticamente, regras automatizadas, scripts), alterações no site, na medição e no CRM e acontecimentos externos, como uma promoção da concorrência ou um feriado.
  3. Exclua primeiro a medição. Se as conversões caíram mas as sessões, os contactos no CRM ou as encomendas não, o problema está na medição, não no desempenho.
  4. Teste uma hipótese de cada vez. Veja se a quebra se limita às campanhas, dispositivos ou ações de conversão em que a alteração mexeu.
  5. Registe o resultado na mesma cronologia para que a pessoa seguinte não comece do zero.

Exemplo (ilustrativo): o CPA sobe 30% numa terça-feira. As alterações importadas do Google Ads mostram um CPA alvo reduzido na sexta-feira e uma recomendação que acrescentou palavras-chave de correspondência ampla no sábado; o registo da equipa mostra uma nova landing page na segunda-feira. As conversões no CRM estão estáveis, por isso a medição está bem. Os termos de pesquisa das novas palavras-chave concentram a maior parte do custo extra, por isso é isso que testa primeiro. Para o método completo, veja a análise de causa raiz em marketing, como as recomendações aplicadas automaticamente alteram as contas e o guia para explicar uma quebra 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 por si só. A solução mais comum é um script do Google Ads que consulta o change_event todos os dias, grava as linhas numa folha de cálculo do Google e envia um e-mail quando a alteração vem de um utilizador que não está na sua lista aprovada.

Até quando consigo ver as alterações no Google Ads?

Na interface, o Histórico de alterações lista as alterações dos últimos 2 anos; os dados mais antigos não ficam disponíveis. Através do recurso change_event da API, e portanto dos scripts que o usam, só é possível consultar os últimos 30 dias, por isso uma ferramenta tem de correr com regularidade e guardar as linhas para manter um registo mais longo.

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

Não. A documentação do change_event indica que as alterações feitas no Google Ads Editor não podem ser obtidas através dele, embora o Editor surja como tipo de cliente. Verifique o Histórico de alterações na interface nessas datas ou registe à mão os carregamentos em massa do Editor, com data e motivo.

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

No Histórico de alterações, a coluna de utilizador mostra o e-mail da pessoa que fez a alteração na interface. Os sistemas automáticos surgem com nomes como "Sistema do Google Ads", e as alterações via API como "Google Ads API" ou com o nome da ferramenta. Na API, a mesma informação está em user_email e client_type.

Um script do Google Ads chega para uma agência registar alterações?

Para poucas contas, um script diário que grava o change_event numa folha de cálculo funciona. Com muitos clientes torna-se mais difícil: cada script corre no máximo 30 minutos, alguém tem de manter o código e a folha não inclui as alterações de site, medição ou CRM, que muitas vezes explicam a quebra.

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 numa só cronologia

O Changeline é um registo de alterações de marketing para agências e equipas de growth. Registe uma alteração em segundos e veja-a ao lado de todos os outros canais. Gratuito durante o acesso antecipado.

Começar já, é gratuito