Google Ads Scripts · Instalação
Como instalar Google Ads Scripts com segurança
Um processo simples para instalar, testar e agendar scripts sem transformar automação em risco operacional.
Instalar um script é fácil; colocar uma automação ruim em produção também. Por isso, a instalação deve separar quatro etapas: código, configuração, preview e agendamento. Essa sequência reduz o risco de acreditar em um script que consulta o período errado, usa limites inadequados ou depende de dados de conversão mal configurados.
Onde ficam os Scripts no Google Ads?
Na conta correta, acesse a área de Scripts dentro das ações em massa. Crie um script novo e trabalhe com um código por vez. Em contas de administrador, a lógica pode ser diferente porque é possível executar rotinas em várias contas.
Checklist antes de executar
- Confirme o ID e o nome da conta em que você está.
- Leia o bloco
CONFIGe troque e-mail, orçamento, período e limites. - Entenda se o script apenas consulta dados ou também altera entidades.
- Verifique quais serviços externos são usados, como e-mail ou Google Sheets.
- Rode em Visualizar e confira o log antes de agendar.
Use um teste mínimo antes do script real
Este código não altera nada. Ele serve para confirmar que você está na conta certa e que o script consegue acessar as informações básicas.
function main() {
const account = AdsApp.currentAccount();
Logger.log(`Conta: ${account.getName()} (${account.getCustomerId()})`);
Logger.log(`Moeda: ${account.getCurrencyCode()}`);
Logger.log(`Fuso: ${account.getTimeZone()}`);
Logger.log(`Preview: ${AdsApp.getExecutionInfo().isPreview()}`);
}Por que o modo Visualizar importa?
O Google Ads Scripts expõe informações de execução, incluindo se a rotina está em preview. Isso permite, por exemplo, impedir que um e-mail seja enviado durante o teste. O preview não substitui a revisão da lógica, mas é a primeira barreira contra uma execução precipitada.
Como escolher a frequência
| Rotina | Frequência inicial | Motivo |
|---|---|---|
| Ritmo de orçamento | Diária | Detectar aceleração ou subinvestimento cedo. |
| Gasto sem conversão | Diária | Priorizar revisão sem pausar automaticamente. |
| Termos de pesquisa | Semanal | Evitar decisões com pouco volume. |
| Histórico em Sheets | Diária | Criar uma série consistente para auditoria. |
O que revisar depois da primeira execução
- se os números batem com a interface;
- se o intervalo de datas está correto;
- se a moeda e o fuso são os esperados;
- se conversões representam a ação de negócio certa;
- se o alerta gera uma decisão útil em vez de ruído.