Integração Meta Ads e Google Sheets via API: Passo a Passo

A integração Meta Ads e Google Sheets via API é a solução para gestores de tráfego que perdem horas exportando dados manualmente do Gerenciador de Anúncios. Em vez de baixar arquivos CSV e copiar e colar informações, você pode criar um fluxo que atualiza suas planilhas automaticamente com as principais métricas de campanha.

Essa automação não apenas economiza tempo, mas também reduz a chance de erros humanos e permite a criação de dashboards personalizados. Com os dados centralizados no Google Sheets, fica mais fácil cruzar informações de tráfego pago com outras fontes, como o Google Analytics ou seu sistema de CRM, para obter uma visão completa do funil de vendas.

Neste artigo, vamos mostrar o passo a passo para construir essa ponte entre as duas plataformas. Você aprenderá a gerar um token de acesso na API de Marketing da Meta, a estruturar sua planilha e a usar um script simples no Google Apps Script para que os dados sejam atualizados todos os dias, sem que você precise mover um dedo.

Por que automatizar relatórios do Meta Ads?

O principal motivo é a eficiência. Um gestor de tráfego que gerencia cinco contas pode gastar facilmente de 30 a 60 minutos por dia apenas compilando relatórios. Ao final de um mês, isso representa mais de 20 horas de trabalho dedicadas a uma tarefa repetitiva. A automação elimina esse processo, liberando tempo para atividades estratégicas, como análise de criativos, otimização de públicos e planejamento de novas campanhas.

A precisão dos dados é outro ponto crucial. A cópia manual de informações está sujeita a erros: uma célula colada no lugar errado, um filtro esquecido ou um número digitado incorretamente podem levar a decisões equivocadas. Quando a API envia os dados diretamente para a planilha, a integridade da informação é garantida. O dado que você vê no Google Sheets é exatamente o mesmo registrado nos servidores da Meta.

Por fim, a centralização permite uma análise mais profunda. Imagine ter uma única planilha onde você pode visualizar o ROAS das suas campanhas do Meta Ads ao lado do LTV (Lifetime Value) dos clientes que elas trouxeram, dado importado do seu CRM. Essa visão integrada é impossível de se obter apenas com o Gerenciador de Anúncios e planilhas estáticas. A automação transforma o Google Sheets em um verdadeiro hub de business intelligence, adaptado às suas necessidades.

O que você precisa antes de começar

Para realizar a integração, alguns pré-requisitos técnicos são necessários. Não é preciso ser um desenvolvedor experiente, mas ter familiaridade com os conceitos a seguir facilitará o processo. Garanta que você tenha acesso a tudo antes de iniciar.

• Conta de Desenvolvedor da Meta: Qualquer pessoa com uma conta no Facebook pode se registrar gratuitamente em developers.facebook.com. É o portal para criar e gerenciar aplicativos que usam as APIs da Meta.
• Um Aplicativo no Painel de Desenvolvedores: Dentro do portal, você precisará criar um novo aplicativo. Para este caso, o tipo de aplicativo "Business" (Negócios) é o mais adequado. Ele servirá como a "identidade" da sua integração ao fazer chamadas para a API.
• Acesso de Administrador à Conta de Anúncios: Para que seu aplicativo possa ler os dados, você precisa conceder a ele permissão para acessar a conta de anúncios desejada. Isso é feito através do seu Gerenciador de Negócios (Business Manager).
• Conhecimento Básico de APIs: Entender o que é um endpoint, um token de acesso e uma chamada GET é fundamental. Vamos explicar os conceitos essenciais, mas uma base prévia ajuda. Opcionalmente, um conhecimento mínimo de JavaScript será útil para entender e adaptar o script do Google Apps Script (GAS).

Passo 1: Gerando seu Token de Acesso na API da Meta

O token de acesso é uma chave de segurança que autoriza seu script a solicitar dados em seu nome. Pense nele como uma senha temporária e específica para essa tarefa. A Meta oferece uma ferramenta chamada Graph API Explorer, que facilita a geração desse token.

Primeiro, acesse o Graph API Explorer. No canto superior direito, selecione o aplicativo que você criou. Depois, no menu suspenso "Token de usuário", clique em "Obter token de acesso do usuário". Uma janela pop-up solicitará que você escolha as permissões. Para ler dados de campanhas, você precisará de, no mínimo:

• ads_read
• read_insights

Após conceder as permissões, um token de acesso de curta duração será gerado. Ele é válido por cerca de uma hora, o que não é útil para automação. Precisamos de um token de longa duração. Para isso, clique no ícone de "i" azul ao lado do campo do token e depois em "Abrir na Ferramenta de Token de Acesso". Na nova tela, clique no botão "Estender Token de Acesso" na parte inferior. Isso gerará um novo token válido por aproximadamente 60 dias.

Guarde este token de longa duração em um local seguro. Ele é a chave para sua automação. Lembre-se que ele expirará em dois meses, então você precisará criar um lembrete para renová-lo e atualizar seu script.

Passo 2: Estruturando sua Planilha no Google Sheets

Antes de escrever o código, prepare o ambiente que receberá os dados. Crie uma nova planilha no Google Sheets e nomeie uma aba como "Dados Meta Ads", por exemplo. O cabeçalho da sua planilha deve corresponder exatamente às métricas que você planeja importar.

Uma estrutura inicial recomendada para análise de campanhas de e-commerce ou infoprodutos seria:

Essa organização simples permite que o script preencha os dados de forma ordenada. Você pode adicionar outras métricas que sejam relevantes para seu negócio, como Custo por Lead, Custo por Visualização de Vídeo ou outras conversões personalizadas. O importante é que os nomes das colunas sejam claros para você e para quem mais for usar a planilha.

Em uma segunda aba, você pode criar seu dashboard, usando fórmulas como SOMA, MÉDIA, PROCV e gráficos que leem os dados brutos da primeira aba. Dessa forma, a aba de dados serve como um banco de dados que é atualizado automaticamente, e seu dashboard se torna dinâmico.

Passo 3: Criando o script no Google Apps Script (GAS)

O Google Apps Script (GAS) é uma plataforma de desenvolvimento baseada em JavaScript que permite criar automações para os produtos do Google, incluindo o Sheets. É aqui que a mágica acontece.

Para abrir o editor, vá em "Extensões" > "Apps Script" na sua planilha do Google Sheets. Apague qualquer código de exemplo e cole o script abaixo. Você precisará substituir os valores das variáveis AD_ACCOUNT_ID, ACCESS_TOKEN e SHEET_NAME pelos seus próprios.

// Função principal que será executada
function buscarDadosMetaAds() {
 // --- CONFIGURAÇÕES. SUBSTITUA PELOS SEUS DADOS ---
 const AD_ACCOUNT_ID = 'act_SEUNUMERODACONTA'; // Substitua pelo ID da sua conta de anúncios (ex: act_123456789)
 const ACCESS_TOKEN = 'SEUTOKENLONGOAQUI'; // Substitua pelo seu token de acesso de longa duração
 const SHEET_NAME = 'Dados Meta Ads'; // Nome exato da aba da sua planilha
 // ---------------------------------------------------

 const fields = 'name,spend,impressions,clicks,ctr,cpc,cost_per_action_type,actions,roas';
 const level = 'campaign';
 const date_preset = 'yesterday'; // Você pode usar 'today', 'last_7d', 'this_month', etc.

 const apiUrl = `https://graph.facebook.com/v19.0/${AD_ACCOUNT_ID}/insights?level=${level}&fields=${fields}&date_preset=${date_preset}&access_token=${ACCESS_TOKEN}`;

 try {
 const response = UrlFetchApp.fetch(apiUrl);
 const json = JSON.parse(response.getContentText());
 const data = json.data;

 const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);
 sheet.getRange('A2:I').clearContent(); // Limpa os dados antigos antes de inserir os novos (ajuste o intervalo I se tiver mais colunas)

 const rows = [];
 data.forEach(campaign => {
 let cpa = 0;
 let purchases = 0;
 
 // A API retorna 'actions' como uma lista. Precisamos encontrar a ação de compra.
 if (campaign.actions) {
 const purchaseAction = campaign.actions.find(action => action.action_type === 'omni_purchase');
 if (purchaseAction) {
 purchases = parseInt(purchaseAction.value);
 }
 }
 
 // A mesma lógica para o CPA (custo por ação)
 if (campaign.cost_per_action_type) {
 const cpaAction = campaign.cost_per_action_type.find(action => action.action_type === 'omni_purchase');
 if (cpaAction) {
 cpa = parseFloat(cpaAction.value).toFixed(2);
 }
 }
 
 const roasValue = campaign.roas ? parseFloat(campaign.roas[0].value).toFixed(2) : '0.00';

 rows.push([
 campaign.campaign_id,
 campaign.name,
 parseFloat(campaign.spend).toFixed(2),
 parseInt(campaign.impressions),
 parseInt(campaign.clicks),
 parseFloat(campaign.ctr).toFixed(2),
 cpa,
 purchases,
 roasValue
 ]);
 });

 if (rows.length > 0) {
 // Escreve todos os dados de uma vez para melhor performance
 sheet.getRange(2, 1, rows.length, rows[0].length).setValues(rows);
 }

 } catch (e) {
 Logger.log('Erro ao buscar dados da API: ' + e.toString());
 }
}

Este script faz uma chamada para a API de Insights da Meta, solicita os dados de campanha do dia anterior (yesterday), processa a resposta e insere os valores formatados na sua planilha. Para quem não quer lidar com scripts e prefere consultar métricas essenciais rapidamente, o Trafius entrega esses dados direto no WhatsApp, sem precisar de planilhas ou código.

Passo 4: Configurando a atualização automática (Triggers)

Ter o script pronto é ótimo, mas de nada adianta se você precisar executá-lo manualmente todos os dias. O objetivo é a automação completa. Para isso, usamos os "acionadores" (triggers) do Google Apps Script.

No menu à esquerda do editor de script, clique no ícone de relógio ("Acionadores").

1. Na nova tela, clique no botão "+ Adicionar acionador" no canto inferior direito.
2. Na janela de configuração, defina as seguintes opções:

• Escolha a função a ser executada: buscarDadosMetaAds (o nome da nossa função).
• Escolha a implantação que deve ser executada: Head.
• Selecione a origem do evento: Baseado em tempo.
• Selecione o tipo de acionador baseado no tempo: Contador de dias.
• Selecione o horário do dia: 8h às 9h (ou o horário que preferir para receber o relatório diário).

3. Clique em "Salvar".

O Google pedirá autorização para que o script possa modificar suas planilhas e acessar URLs externas. Conceda as permissões necessárias. Pronto. Todos os dias, no horário configurado, seu script será executado automaticamente, e sua planilha será atualizada com os dados mais recentes do Meta Ads.

Boas práticas e limites da API

Ao trabalhar com a API da Meta, é importante conhecer algumas regras para garantir que sua automação funcione de forma estável. A principal delas são os limites de taxa (rate limits). A Meta limita o número de chamadas que um aplicativo pode fazer em um determinado período para evitar sobrecarga em seus servidores. Para consultas de insights, o limite geralmente é generoso para o tipo de relatório que estamos construindo, mas é bom evitar executar o script a cada 5 minutos, por exemplo. Uma ou duas vezes ao dia é mais do que suficiente.

Outra boa prática é solicitar apenas os campos (fields) que você realmente vai usar. Cada métrica adicional aumenta o processamento necessário. O script de exemplo já é otimizado nesse sentido.

Para referência, aqui está uma tabela com algumas métricas comuns e seus nomes correspondentes na API, que você pode adicionar à variável fields do script.

Sempre consulte a documentação oficial da API de Insights para ver a lista completa de métricas disponíveis e seus nomes exatos.

Como aplicar agora

A integração entre Meta Ads e Google Sheets via API pode parecer complexa no início, mas os benefícios em tempo economizado e qualidade da análise compensam o esforço inicial. Com relatórios automatizados, você pode focar no que realmente importa: otimizar campanhas e gerar mais resultados.

Aqui estão os próximos passos:

• Crie sua conta de desenvolvedor: Se ainda não tiver, registre-se no portal da Meta e crie seu primeiro aplicativo.
• Gere seu token de acesso: Use o Graph API Explorer para obter seu token de longa duração e guarde-o em segurança.
• Copie e adapte o script: Cole o código do Google Apps Script na sua planilha e insira suas credenciais (ID da conta e token).
• Configure o acionador: Programe a execução diária do script para que seus dados estejam sempre atualizados pela manhã.
• Construa seu dashboard: Crie gráficos e tabelas em uma nova aba para visualizar os dados de forma clara e tomar decisões mais rápidas.

Se o processo parece técnico demais ou se você precisa de uma forma ainda mais ágil de consultar suas métricas, lembre-se que existem ferramentas para isso. O Trafius foi criado justamente para simplificar essa consulta, entregando os KPIs mais importantes direto no seu WhatsApp.