Como monitorar o status das metas do Google Ads em contas MCC usando o Planilhas Google

Este tutorial documenta um script que audita a atividade de metas de conversão em todas as contas do seu MCC. Ele grava os resultados em uma Planilha Google, marca a integridade de cada meta, codifica o status por cores e envia um resumo por e-mail somente quando há um problema.

Não há ferramentas desnecessárias ou painéis de terceiros, apenas controle bruto e visibilidade completa.

O que este script faz

Este script audita todas as contas do Google Ads sob sua MCC e avalia o status de cada meta de conversão durante um período de análise definido. Em vez de adivinhar quais metas estão ativas ou não, este sistema fornece um instantâneo em tempo real em uma Planilha Google e alerta você apenas quando algo precisa da sua atenção.

• Conecta-se ao seu MCC e percorre cada conta vinculada
• Ignora contas que você bloqueou (excluídas)
• Exibe o desempenho de conversão no nível da campanha durante um período de análise definido
• Avalia a saúde de cada meta de conversão
• Registre os resultados em uma planilha do Google, aplicando cores de fundo ao status
• Envia por e-mail um resumo apenas de contas ou objetivos problemáticos

Notificações por e-mail

Haverá duas notificações por e-mail: uma para contas que precisam de atenção e outra para todas as contas boas.

Exemplo:

Mensagens:

Entendi, seu script precisa duas saídas de e-mail distintas :

1. ✅ E-mail “Tudo bem” (se sem problemas são encontrados)

2. ⚠️ E-mail “Precisa de Atenção” (se qualquer as metas estão inativas, ausentes ou com baixo desempenho)

Veja exatamente como ambas as versões devem ficar, usando seus dados de amostra e lógica atual:

Mensagem #1

Todas as metas de conversão monitoradas estão relatando atividades dos últimos 60 dias.

Nenhum problema encontrado em nenhuma conta.

Veja o relatório completo:
https://docs.google.com/spreadsheets/d/yoursheetid

Mensagem #2

As seguintes metas de conversão podem precisar de revisão (por exemplo, nenhuma conversão recente ou inativa):

Bright Widgets Inc (123-456-789) - Envio de formulário de contato (requer atenção)
Acme Corp (987-654-321) - Agendar chamada (Inativo)
Acme Corp (987-654-321) - Inscrição para teste gratuito (requer atenção)
Rocket Leads (456-789-123) - (configurado, sem atividade) (Sem conversões recentes)
Grupo de Teste Beta (321-654-987) - (não definido) (Inativo)
Zebra Analytics (999-111-222) - Download do Whitepaper (Precisa de Atenção)

Veja o relatório completo:
https://docs.google.com/spreadsheets/d/yoursheetid

Requisitos

Antes de implantar o script, certifique-se de que seu ambiente esteja configurado corretamente. Este script foi projetado para ser executado em um contexto MCC do Google Ads para gravar dados e enviar alertas.

• Conta MCC do Google Ads
• Planilha Google (deve ser criada manualmente)

O roteiro original

Este é o script completo e sem edições. Todos os comentários, formatação e lógica estão exatamente como escritos originalmente. Não faça modificações se planeja acompanhar o detalhamento mais adiante neste tutorial.

// ========== CONFIGURAÇÃO ==========

const ID_DA_FOLHA = '1PvpW3eUl5fqRwabBg0P7D8LKzW83MOTVX1KDBMB3ipA';

const DIAS_DE_OLHO_RETROCESSO = 60;

const ID_DE_CONTA_EXCLUÍDA = [

'000-000-000', '000-000-000', '000-000-000'

];

const E-MAILS_DE_DESTINATÁRIOS = ' [email protected] ';

// ==================================

função principal() {

planilha const = SpreadsheetApp.openById(SHEET_ID).getSheets()[0];

planilha.clear();

sheet.appendRow(['Nome da conta', 'ID da conta', 'Nome da meta', 'Conversões', 'Status', 'Intervalo de datas']);

const startDate = getDateXDaysAgo(LOOKBACK_DAYS);

const datafim = getDataHoje();

const dateRangeLabel = `Últimos ${LOOKBACK_DAYS} dias (${startDate} a ${endDate})`;

contas const = MccApp.accounts().get();

const flagged = [];

let rowIndex = 2;

while (accounts.hasNext()) {

const account = accounts.next();

const accountId = account.getCustomerId();

const accountName = account.getName();

Logger.log(`⏳ Conta corrente: ${accountName} (${accountId})`);

if (EXCLUDED_ACCOUNT_IDS.includes(accountId)) {

Logger.log(`🚫 Ignorando conta excluída: ${accountName} (${accountId})`);

continue;

}

try {

MccApp.select(account);

const query = `

SELECT ConversionTypeName, Conversões

DE RELATÓRIO_DE_DESEMPENHO_DA_CAMPANHA

DURANTE ${Data_de_início},${Data_de_término}

`;

const report = AdsApp.report(query);

const rows = report.rows();

const goalMap = {};

while (rows.hasNext()) {

const row = rows.next();

const goalName = row['ConversionTypeName'] || '(não definido)';

const conversions = parseFloat(row['Conversões']) || 0;

if (!goalMap[goalName]) {

goalMap[goalName] = 0;

}

goalMap[goalName] += conversões;

}

if (Object.keys(goalMap).length === 0) {

Logger.log(`⚠️ Nenhum dado de conversão foi retornado para a conta: ${accountName} (${accountId})`);

const status = 'Nenhuma Conversão Recente';

sheet.appendRow([

accountName,

accountId,

'(configurado, sem atividade)',

0,

status,

dateRangeLabel

]);

setStatusColumnColor(sheet, rowIndex, status);

flagged.push(`${accountName} (${accountId}) - nenhuma meta de conversão foi acionada`);

rowIndex++;

continue;

}

for (const [goalName, totalConversions] de Object.entries(goalMap)) {

let status;

if (totalConversions > 0) {

status = 'Ativo';

} else if (goalName.toLowerCase().includes('teste') || goalName === '(não definido)') {

status = 'Inativo';

} else {

status = 'Requer atenção';

}

sheet.appendRow([

accountName,

accountId,

goalName,

totalConversions,

status,

dateRangeLabel

]);

setStatusColumnColor(sheet, rowIndex, status);

if (status !== 'Ativo') {

flagged.push(`${accountName} (${accountId}) - ${goalName} (${status})`);

}

rowIndex++;

}

} catch (e) {

Logger.log(`❌ Erro ao processar a conta: ${accountName} (${accountId}) - ${e.message}`);

}

}

if (flagged.length > 0) {

const subject = '⚠️ Metas de conversão que precisam de atenção';

const body = `As seguintes metas de conversão podem precisar de revisão (por exemplo, nenhuma conversão recente ou inativas):\n\n`

+ flagged.join('\n')

+ `\n\nVeja o relatório completo:\nhttps://docs.google.com/spreadsheets/d/${SHEET_ID}`;

MailApp.sendEmail(RECIPIENT_EMAILS, subject, body);

} else {

Logger.log('✅ Todas as metas estão relatando conversões.');

}

}

// 🎨 Aplicar cor apenas à coluna "Status" (Coluna E)

function setStatusColumnColor(sheet, row, status) {

const range = sheet.getRange(row, 5); // Coluna E

switch(status) {

case 'Ativo':

range.setBackground('#d9ead3'); // Verde claro

break;

case 'Inativo':

range.setBackground('#f4cccc'); // Vermelho claro

break;

case 'Precisa de Atenção':

range.setBackground('#fff2cc'); // Amarelo claro

break;

case 'Sem Conversões Recentes':

range.setBackground('#e6e6fa'); // Roxo claro

break;

default:

range.setBackground(null);

}

}

// 🕒 Auxiliares

function getTodayDate() {

const date = new Date();

return Utilities.formatDate(date, AdsApp.currentAccount().getTimeZone(), 'aaaaMMdd');

}

function getDateXDaysAgo(days) {

const date = new Date();

date.setDate(date.getDate() - days);

return Utilities.formatDate(date, AdsApp.currentAccount().getTimeZone(), 'aaaaMMdd');

} 

Análise do roteiro por seção

CONFIGURAÇÃO

• SHEET_ID: destino do Planilhas Google para todas as saídas
• LOOKBACK_DAYS: Janela de relatórios em dias
• EXCLUDED_ACCOUNT_IDS: Contas de clientes a serem ignoradas
• E-MAILS_DE_DESTINATÁRIOS: Quem recebe e-mails quando há um problema

Função main()

• Abre a planilha, limpa-a e configura cabeçalhos
• Calcula o intervalo de datas
• Faz um loop em cada subconta do MCC
• Ignora qualquer um que esteja na lista de bloqueio
• Usa CAMPAIGN_PERFORMANCE_REPORT para extrair todos os dados de metas
• Para cada meta:
  • Agrega conversões totais
  • Atribui um status:
    • Ativo: conversões > 0
    • Inativo: meta de teste ou não definida
    • Requer atenção: zero conversões, não é um teste
    • Nenhuma conversão recente: nenhum dado de meta retornado
• Adiciona dados à planilha
• Chama setStatusColumnColor() para marcar cada linha
• Cria uma lista sinalizada e envia e-mails caso algum problema seja encontrado

setStatusColumnColor(planilha, linha, status)

• Aplica uma cor de fundo à Coluna E dependendo do status da meta:
  • Verde para ativo
  • Vermelho para inativo
  • Amarelo para precisa de atenção
  • Roxo para nenhuma atividade

Ajudantes de encontros

• getTodayDate() retorna a data de hoje no fuso horário correto
• getDateXDaysAgo() retorna a data X dias atrás

Este tutorial mostra como configurar o verificador de integridade da meta de conversão para sua conta MCC do Google Ads. Siga cada etapa para colocar o sistema em funcionamento, escrever no Planilhas Google e enviar alertas quando algo não funcionar.

Etapa 1: Crie a Planilha Google

Comece configurando o destino de saída.

1. Acesse o Planilhas Google
2. Clique em "Em branco" para criar uma nova planilha
3. Por favor, dê um nome como Monitor de Metas
4. A parte do meio é o ID da sua planilha
5. Cole o ID no seu script onde diz const SHEET_ID = '...'

Etapa 2: Abra o Painel de Scripts do Google Ads

Você implantará este script dentro da sua conta MCC.

1. Faça login na sua conta MCC do Google Ads
2. Clique em "Ferramentas e configurações" na navegação superior
3. Em "Ações em massa", selecione "Scripts".
4. Clique no botão de mais (+) para adicionar um novo script
5. Cole o script inteiro exatamente como foi escrito no editor de código

Etapa 3: Autorizar o script

Na primeira vez que você usar o script, você precisa autorizá-lo.

1. Clique em "Autorizar" no canto superior direito
2. Selecione sua conta do Google
3. Aprovar todas as permissões solicitadas

Você deve concluir esta etapa ou o script não será executado.

Etapa 4: defina a configuração do seu script

Dentro do script, revise e modifique o seguinte:

• SHEET_ID: Cole o ID da planilha copiada
• LOOKBACK_DAYS: Altere se necessário (o padrão é 60)
• EXCLUDED_ACCOUNT_IDS: adicione quaisquer contas que você não deseja escanear
• RECIPIENT_EMAILS: Adicione o e-mail ou e-mails para receber relatórios de alerta

Você pode deixar o resto do script exatamente como está.

Etapa 5: execute um teste manual

Execute-o manualmente uma vez para garantir que tudo funcione.

1. Clique em "Executar" na parte superior da navegação.
2. Aguarde até que a execução seja concluída.
3. Abra a Planilha Google conectada.
4. Verifique se:
   • Os cabeçalhos foram criados
   • Os dados foram gravados para cada conta ativa.
   • Os status e as cores são aplicados corretamente na Coluna E.

Etapa 6: Agende o script (opcional)

Para tornar isso automático, configure-o para ser executado em um cronograma recorrente.

1. No editor de script, clique em "Criar agendamento".
2. Escolha uma frequência (recomenda-se que seja diária)
3. Defina o horário de execução (o ideal é de manhã cedo)
4. Salvar e fechar

O script será executado automaticamente e só o alertará quando algo estiver errado.

Etapa 7: Revisar alertas

Quando o script é executado, ele verifica todas as metas de conversão. Se alguma estiver inativa ou não estiver sendo disparada, você receberá um e-mail.

Resumo

Este script não é apenas um despejo de dados. Ele é um monitor para cada meta de conversão em toda a sua MCC do Google Ads. Você recebe um alerta quando algo quebra, trava ou interrompe o rastreamento silenciosamente. Quando tudo está bem, você fica em silêncio.

Ele verifica todas as contas que você gerencia, sinaliza metas inativas ou com baixo desempenho e envia um relatório filtrado e sem ruído diretamente para sua caixa de entrada. A Planilha Google oferece uma visualização em tempo real do status das metas por conta, nome da meta e volume de conversão, com indicações visuais integradas.

Você não está vasculhando interfaces. Não está esperando até o final do mês para perceber que estava cego. Você está no controle antes que isso se torne um problema.

Confira postagens semelhantes:

Confira postagens semelhantes:

Se você gerencia várias contas, não perca nosso guia sobre rastreando problemas do GA4 de várias propriedades ou exportador termos de pesquisa reais de alto desempenho com um script leve para refinar sua segmentação.

Contate-nos

Cansado de ficar na dúvida se o seu monitoramento funciona? Quer uma equipe que crie sistemas em vez de apenas relatórios?

A Bright Vessel não gerencia apenas o Google Ads; nós projetamos visibilidade de desempenho em escala. Se você precisar de ajuda para implementar este script, integrá-lo a uma pilha de automação maior ou criar uma camada de análise personalizada que lhe diga algo, estamos prontos.

Fale com a equipe que cria o que outras agências falsificam.

Entre em contato com a Bright Vessel