Você já conhece a dor de cabeça se estiver executando campanhas Performance Max ou de correspondência ampla. O Google oculta as consultas de pesquisa reais. Este script as traz de volta. Ele se conecta diretamente ao seu MCC, captura as consultas convertidas e as insere em uma Planilha Google com CPA e taxa de conversão calculados.
Nosso script, "Como exportar termos de pesquisa de anúncios do Google de alto desempenho para o Planilhas Google usando o Apps Script", é perfeito para agências que gerenciam vários clientes ou profissionais de marketing que querem parar de adivinhar.
Vamos analisar.
A seção Scripts é onde toda a automação em massa é configurada no Google Ads MCC.
1. Faça login na sua MCC (Conta de Gerente) e vá para Ferramentas > Ações em Massa > Scripts
2. Clique no botão azul de mais (+) para criar um novo script
Isso abre o editor de scripts. Não se preocupe, você não estará codificando do zero. Você estará colando um script já escrito. Clicar neste botão cria um contêiner de script em branco para sua automação.
Nomear seu script é essencial para o gerenciamento e o agendamento de longo prazo.
3. Nomeie o script de forma que seja fácil identificá-lo mais tarde
Na parte superior da janela do editor de scripts, você verá um campo para inserir um nome. Use algo claro, como "Relatório de Termos de Pesquisa com Melhor Desempenho". Isso ajudará você a reconhecer o script posteriormente ao gerenciar vários scripts ou contas.
Você pode nomeá-lo Termos de pesquisa reais com melhor desempenho e insira o script (incluído no final deste post).
Nomeie o script
4. Cole o script inteiro no editor
function main() {
// Definir a URL da Planilha Google de destino
var spreadsheetUrl = 'Cole a URL da Planilha Google aqui';
// Obter o nome da conta para nomear a planilha dinamicamente
var accountName = AdsApp.currentAccount().getName();
// Usar o nome da conta para rotular a aba dentro da planilha
var sheetName = accountName + ' - Termos de melhor desempenho PC 90 dias';
// Abrir a planilha pela URL
var spreadsheet = SpreadsheetApp.openByUrl(spreadsheetUrl);
// Obter a planilha pelo nome ou criá-la se ela não existir
var sheet = spreadsheet.getSheetByName(sheetName) || spreadsheet.insertSheet(sheetName);
// Limpar todos os dados existentes da planilha
sheet.clear();
// Gravar a linha de cabeçalho na planilha
sheet.getRange('A1').setValue('Nome da campanha');
sheet.getRange('B1').setValue('Nome do Grupo de Anúncios');
sheet.getRange('C1').setValue('Termo de Pesquisa');
sheet.getRange('D1').setValue('Conversões');
sheet.getRange('E1').setValue('Valor da Conversão');
sheet.getRange('F1').setValue('Custo por Conversão (CPA)');
sheet.getRange('G1').setValue('Taxa de Conversão (%)');
// Defina o intervalo de datas personalizado para o relatório (formato: AAAAMMDD)
var startDate = '20230315';
var endDate = '20240915';
// Cria a consulta a partir do Relatório de Desempenho de Consulta de Pesquisa
var report = AdsApp.report(
"SELECT CampaignName, AdGroupName, Query, Conversions, ConversionValue, Cost, Clicks " +
"FROM SEARCH_QUERY_PERFORMANCE_REPORT " +
"WHERE Conversions > 0 " +
"DURING " + startDate + "," + endDate
);
// Obtém as linhas do relatório e define a linha inicial para inserção de dados
var rows = report.rows();
var rowNumber = 2;
// Itera por cada linha do relatório
while (rows.hasNext()) {
var row = rows.next();
// Coloque o termo de pesquisa em minúsculas para uma filtragem de marca consistente
var searchTerm = row['Query'].toLowerCase();
var conversions = parseFloat(row['Conversions']);
// Ignora linhas com menos de 1 conversão
if (conversions < 1) continue;
// Excluir termos de marca para evitar poluir o relatório
if (searchTerm.includes('parker chase') || searchTerm.includes('parker-chase') || searchTerm.includes('endeavor schools')) {
continue;
}
// Filtro genérico opcional - adicione ou remova termos aqui
if (
searchTerm.includes('creative') ||
searchTerm.includes('learning') ||
searchTerm.includes('content')
) {
continue;
}
// Extrair valores de custo e clique para calcular o desempenho
var cost = parseFloat(row['Cost']);
var clicks = parseFloat(row['Clicks']);
// Calcular o custo por conversão (CPA)
var cpa = conversions > 0 ? cost / conversions : 0;
// Calcular a taxa de conversão
var conversionRate = cliques > 0 ? (conversões / cliques) * 100 : 0;
// Formatar valores
cpa = cpa.toFixed(2);
conversionRate = conversionRate.toFixed(2);
// Gravar a linha na planilha
sheet.getRange(rowNumber, 1).setValue(row['CampaignName']);
sheet.getRange(rowNumber, 2).setValue(row['AdGroupName']);
sheet.getRange(rowNumber, 3).setValue(row['Query']);
sheet.getRange(rowNumber, 4).setValue(conversões);
sheet.getRange(rowNumber, 5).setValue(row['ConversionValue']);
sheet.getRange(rowNumber, 6).setValue('$' + cpa); // Incluir cifrão para CPA
sheet.getRange(rowNumber, 7).setValue(conversionRate + '%'); // Adicionar símbolo de porcentagem
// Mover para a próxima linha na planilha
rowNumber++;
}
// Registrar quantas linhas foram processadas
Logger.log('Exportação concluída. Total de linhas processadas: ' + (rowNumber - 2));
} O script inclui várias configurações marcadas que você pode ajustar antes de executá-lo. Todas elas estão dentro dos blocos de comentários do script e podem ser alteradas com base em seus objetivos específicos, intervalo de relatórios ou preferências de formatação.
Aqui está uma análise do que você pode modificar e por quê:
1. URL da planilha
var planilhaUrl = 'https://docs.google.com/spreadsheets/d/xxxxx/edit'; O que ele faz:
É para lá que o script envia seus dados. Substitua o URL do espaço reservado pelo link para sua Planilha Google. Se você estiver usando vários endereços de e-mail, certifique-se de que a Planilha esteja compartilhada com a conta do Google vinculada à sua MCC.
2. Configurações de intervalo de datas
var datainicial = '20230315';
var datafinal = '20240915'; O que ele faz:
Isso controla a janela de relatórios. As datas devem ser formatadas como AAAAMMDD. Você pode ajustá-las para corresponder ao período de tempo que estiver analisando: os últimos 30 dias, os últimos 90 dias, intervalos trimestrais personalizados, etc.
3. Comportamento do nome da planilha
var sheetName = accountName + ' - Termos de melhor desempenho PC 90 dias'; O que ele faz:
Esta linha nomeia dinamicamente a aba Planilha com base na conta que executa o script. Você pode alterar a parte da string de texto ('—Termos de Melhor Desempenho PC 90 Dias') se quiser rotular os relatórios de forma diferente. Isso é útil ao executar relatórios em várias marcas ou subcontas.
4. Filtragem de termos de marca
se (searchTerm.includes('parker chase') || searchTerm.includes('parker-chase') || searchTerm.includes('escolas endeavor')) {
continuar;
} O que ele faz:
Esta seção exclui quaisquer termos de marca do seu relatório. Você pode atualizar esta lista adicionando ou removendo condições .includes(). Por exemplo, se quiser excluir "MinhaMarca", basta adicionar:
|| searchTerm.includes('minhamarca') Use letras minúsculas consistentemente, pois o script converte todas as consultas para letras minúsculas.
5. Filtragem de termos genéricos
se (
searchTerm.includes('criativo') ||
searchTerm.includes('aprendizagem') ||
searchTerm.includes('conteúdo')
) {
continuar;
} O que ele faz:
Este filtro opcional elimina termos que não são específicos da marca, mas ainda assim confundem os dados, como "aprendizagem" ou "criativo". Você pode adicionar ou remover filtros aqui com base no que considera ruído.
6. Limite de desempenho
se (conversões < 1) continuar; O que ele faz:
Esta linha remove consultas sem conversões. Você pode aumentar esse limite, se desejar, apenas para termos de melhor desempenho. Por exemplo, altere para:
se (conversões < 3) continuarem;
...para incluir apenas termos de pesquisa com 3 ou mais conversões no intervalo de datas.
7. Formatação de saída da planilha
planilha.getRange(rowNumber, 6).setValue('$' + cpa);
planilha.getRange(rowNumber, 7).setValue(conversionRate + '%'); O que ele faz:
Isso controla como o CPA e a taxa de conversão são escritos na planilha. Você pode editar ou excluir as adições de string para remover símbolos (por exemplo, $ ou %).
Após a execução bem-sucedida do script, ele preencherá sua Planilha Google com uma tabela estruturada. Cada linha representa um termo de pesquisa que gerou pelo menos uma conversão dentro do intervalo de datas especificado.
O exemplo da planilha do Google
O script gera um conjunto de colunas de desempenho na sua Planilha Google, fornecendo uma visão clara da contribuição de cada termo de pesquisa. Essas colunas incluem os nomes da campanha e do grupo de anúncios para rastrear onde o termo foi acionado, o termo de pesquisa digitado pelo usuário, o número de conversões geradas, o valor total da conversão, o custo médio por conversão e a taxa de conversão geral. Cada campo é fundamental para entender o que funciona e o que é desperdiçado.
Nome da campanha
Nome da campanha onde o anúncio foi acionado
Nome do grupo de anúncios
Um grupo de anúncios que corresponde ao termo de pesquisa
Termo de pesquisa
A frase exata que o usuário digitou no Google
Conversões
Número de conversões rastreadas desse termo
Valor de conversão
O valor total dessas conversões, com base nas configurações da sua conta
Custo por conversão (CPA)
O custo médio para gerar uma conversão a partir desse termo de pesquisa
Taxa de conversão (%)
Porcentagem de cliques que resultaram em uma conversão
Este script é uma base sólida, mas pode ir além, dependendo da profundidade que você deseja para seus relatórios. Se você gerencia várias marcas ou contas em um MCC, adicionar rótulos ou filtros de campanha pode ajudar a isolar os dados por marca ou unidade de negócios. Programar o script para ser executado automaticamente semanalmente ou mensalmente economiza tempo e garante relatórios consistentes. Você pode criar uma lógica para enviar alertas quando métricas importantes, como CPA ou taxa de conversão, ultrapassarem determinados limites. Para uma análise mais granular, você pode combinar isso com outros relatórios. PALAVRAS-CHAVE_RELATÓRIO_DE_DESEMPENHO para obter detalhamentos por tipo de correspondência. Dentro da Planilha, adicionar tabelas dinâmicas ou formatação condicional pode gerar insights mais rapidamente. E se você quiser um visual mais visual, os dados podem ser extraídos para o Looker Studio para painéis que seus clientes possam entender.
Adicione rótulos de campanha ou filtros em nível de conta para segmentar dados em grandes MCCs
Use o agendamento integrado para automatizar relatórios semanais ou mensais
Acione alertas por e-mail quando o CPA exceder um valor específico ou a taxa de conversão cair abaixo de um limite
Junte dados de outros relatórios, como KEYWORDS_PERFORMANCE_REPORT para detalhar os tipos de correspondência
Adicione resumos básicos ou formatação condicional diretamente no Planilhas
Conecte a saída ao Looker Studio para painéis de desempenho visual
Na Bright Vessel, criamos ferramentas de automação personalizadas como esta para clientes que precisam de insights claros de desempenho em ambientes de anúncios desorganizados. Se você está cansado de vasculhar painéis ruins ou executar cinco exportações manuais para obter os dados necessários, este script é apenas uma das muitas maneiras pelas quais simplificamos o processo.
Confira nosso passo a passo relacionado sobre “Como monitorar o status das metas do Google Ads em contas MCC usando o Planilhas Google e o Apps Script” para ver outro método para automatizar o rastreamento em escala.
Precisa de uma versão que se integre ao Slack, crie painéis do Looker ou conecte várias contas de anúncios em uma planilha mestre? Nós podemos fazer isso. Vamos conversar .
"*" indica campos obrigatórios
"*" indica campos obrigatórios
"*" indica campos obrigatórios
