Logotipo do Google Ads

Anúncio

Conectar Anúncios do Google para Excel, Planilhas Google, IA e REST

Campanhas, grupos de anúncios, palavras-chave e gastos como tabelas consultáveis. Combine-os com seus próprios dados de conversão armazenados no Postgres ou em uma pasta de exportação de planilha.

Comece gratuitamente 13 destinos

Uma conexão, todas as superfícies

Para onde podem ir os seus dados do Google Ads.

Anúncios do Google dados de API em tempo real como tabelas SQL
Consultas federadas + qualquer outro conector · um SQL de todas as fontes · todos os planos
Agente de rede
  • 1 conexão de saída
  • 0 portas de entrada
  • Somente leitura · credenciais permanecem inalteradas

funciona em

O Query Streams transforma uma conta do Google Ads em 12 tabelas SQL — campanhas, grupos de anúncios, anúncios, palavras-chave, termos de pesquisa, localização geográfica, dispositivos, dados demográficos, páginas de destino e histórico de alterações — legíveis no Microsoft Excel, Google Sheets, Power BI, assistentes de IA via MCP e um endpoint REST. Os gastos chegam como uma coluna que pode ser associada à receita, que é o objetivo principal: a conciliação que normalmente ocorre em uma planilha uma vez por mês se torna um único demonstrativo.

  1. Para sua equipe, fornecedores e parceiros.

  2. Google Ads para Excel Microsoft Excel · Suplemento do Excel

    Importe resultados do Google Ads em tempo real diretamente para uma planilha e atualize-os sob demanda — Excel para desktop, Excel Online, Microsoft 365.

    Como funciona o Excel

  3. Anúncios do Google para o Google Sheets Suplemento de planilhas

    Execute uma consulta salva do Google Ads na barra lateral e arraste os resultados para a planilha. Os colaboradores que compartilharam a planilha poderão atualizá-la por conta própria.

    Como funciona o Google Sheets

  4. Pergunte à Nova sobre anúncios do Google. Nova AI · texto para SQL

    Faça uma pergunta em linguagem simples. O Nova já conhece suas tabelas do Google Ads, escreve e executa o SQL, explica a resposta e a exibe em gráficos — sem necessidade de escrever consultas ou fornecer credenciais.

    Como funciona o Nova

  5. Visualizador de dados do Google Ads Compartilhamento de resultados · equipe, fornecedores, parceiros · celular, tablet, computador

    Compartilhe os resultados do Google Ads em tempo real com qualquer pessoa — um colega, um fornecedor, um parceiro — como uma tabela que pode ser adicionada aos favoritos e que é exibida novamente ao ser aberta em um celular, tablet ou computador. Eles veem os resultados, nunca o SQL ou as credenciais.

    Como funciona o Visualizador de Dados
  6. Para aplicativos e sistemas

  7. API REST do Google Ads endpoint HTTP

    Publique uma consulta do Google Ads como um endpoint JSON autenticado que qualquer aplicativo pode chamar, com uma especificação OpenAPI 3.1 e coleções prontas para Postman, Insomnia e Hoppscotch. Nenhuma porta de banco de dados é aberta.

    Como funciona a API REST

  8. Google Ads para Power BI Power Query M

    Cole o arquivo M do Power Query gerado no Editor Avançado do Power BI e o relatório exibirá os resultados do Google Ads em tempo real via HTTPS — sem driver ODBC ou porta de banco de dados aberta.

    Como funciona o Power BI

  9. Anúncios do Google para o Airtable Plataforma de automação

    Sincronize linhas do Google Ads com uma base do Airtable de acordo com uma programação ou busque-as dentro de um script de automação do Airtable.

    Como funciona o Airtable

  10. Anúncios do Google para Baserow Plataforma de automação

    Alimente uma tabela do Baserow a partir do Google Ads através do endpoint REST — hospedado localmente ou na nuvem do Baserow.

    Como funciona o Baserow

  11. Anúncios do Google para o SeaTable Plataforma de automação

    Mantenha uma base de dados do SeaTable atualizada com os dados do Google Ads sem exportar um arquivo ou expor o banco de dados.

    Como funciona o SeaTable

  12. Anúncios do Google para o Smartsheet Plataforma de automação

    Integre os resultados do Google Ads a uma planilha do Smartsheet para que os planos e relatórios sejam lidos do sistema de origem, e não da exportação da semana passada.

    Como funciona o Smartsheet

  13. Anúncios do Google para a Anvil Anvil Works · Plataforma de aplicativos

    Faça back-to-app de um aplicativo Anvil Python com anúncios do Google por meio do endpoint REST, em vez de incorporar as credenciais do banco de dados no aplicativo.

    Como funciona o Anvil
  14. Para ferramentas de IA

  15. Servidor MCP do Google Ads Clientes Claude, Cursor e MCP

    Conceda a um assistente de IA acesso somente leitura ao Google Ads com o esquema necessário para escrever SQL corretamente — sem credenciais no chat.

    Guia do Google Ads
  16. Entregue às pessoas

  17. Alertas e relatórios do Google Ads Slack · Discord · E-mail · Webhook

    Programe uma consulta do Google Ads para que os resultados sejam entregues no Slack, Discord, por e-mail ou por um webhook assinado — ou retenha a mensagem até que a contagem de linhas, um limite ou uma variação percentual ultrapasse o valor definido.

    Como funcionam os alertas e relatórios

Como funciona

5 etapas, sem alteração no firewall de entrada

01

Obtenha um token de desenvolvedor para sua conta do Google Ads e crie uma conta de serviço com delegação para todo o domínio.

02

Instale o Agente de Rede e forneça a chave da conta de serviço, o token de desenvolvedor, o e-mail a ser representado e o ID do cliente. O ID da conta de administrador é opcional e serve para acessar uma subconta.

03

Escolha qual das 12 tabelas sincronizar. Campanhas, grupos de anúncios, palavras-chave, termos de pesquisa, localização geográfica, dispositivos e a própria conta estão ativados por padrão.

04

Escreva SQL comum para gads.campaign, gads.search_term_view e o restante — ou deixe o Nova fazer isso.

05

Leia os dados no Excel, Planilhas, Power BI, MCP ou REST, integrados a qualquer plataforma que gere sua receita.

Análise detalhada do recurso

O que o Google Ads oferece a você

Os gastos devem estar relacionados à receita, em um único demonstrativo.

O Google Ads sabe quanto você gastou. Ele não sabe quanto o cliente pagou a você, e o relatório que importa precisa de ambas as informações.

  • A campanha gads.campaign armazena impressões, cliques, custo, conversões e valor de conversão por dia, integrando-se perfeitamente a qualquer campanha indexada pelo nome ou UTM.
  • gads.search_term_view é a consulta que alguém digitou, e é aí que geralmente se perde o dinheiro. — e pode ser integrado aos seus próprios dados de conversão, em vez de ficar preso na interface de anúncios.
  • O dinheiro chega em microssegundos, exatamente como a API o reporta. Um dólar equivale a 1.000.000, portanto, nada foi arredondado antes de você dividir por conta própria.

As 12 mesas

  • Estrutura — cliente, campanha, grupo_de_anúncios, grupo_de_anúncios_de_anúncios.
  • Procurar — visualização_de_palavra_chave, visualização_de_termo_de_busca, visualização_de_página_de_destino.
  • Avarias — visualização_geográfica, visualização_de_dispositivo, visualização_de_faixa_etária, visualização_de_gênero.
  • Auditoria — histórico_de_alterações.
  • Cada linha também armazena a resposta completa da API em uma coluna JSON raw_data, portanto, uma métrica que não seja uma coluna nomeada ainda estará presente.

Onde os números param, sinceramente?

Há dois aspectos dos dados de anúncios com os quais qualquer ferramenta precisa conviver, e isso deve ser dito abertamente, em vez de descoberto posteriormente.

  • Os relatórios são referentes a ontem, não a hoje. — Os números de hoje estão incompletos por parte do Google e só podem induzir a erros.
  • Cada execução incremental relê os últimos dias, bem como o novo, porque o atributo de conversões é contabilizado tardiamente e um número obtido na segunda-feira não será o mesmo que o Google utilizará na quinta-feira.
  • O histórico de alterações é limitado a 29 dias pela própria API do Google Ads. Trata-se de um feed de alterações recentes, não de um registro de auditoria permanente.
  • Algumas colunas geográficas contêm os IDs de critério do Google em vez de nomes de locais, e algumas colunas de texto de anúncios ainda não foram preenchidas. O que está presente é preciso; o que não está está vazio, e não incorreto.

Compartilhado por todos os conectores de API.

Como funciona cada conector de API

  • Sua conta se transforma em mesas — Os endpoints são mapeados para tabelas SQL tipadas com chaves primárias e índices, então você escreve SELECT, JOIN e GROUP BY em vez de percorrer o JSON.
  • Você escolhe o que será sincronizado e com que frequência. — Cada tabela tem seu próprio intervalo, ou nenhum. Quando a API do fornecedor oferece suporte, somente os registros que foram alterados desde a última execução são recuperados.
  • A cópia é sua. — Ele reside em um arquivo DuckDB criptografado com AES-256-GCM, localizado ao lado do agente, em sua máquina. Não está em nossa nuvem.
  • O fornecedor só recebe notícias suas. — o agente chama a API diretamente da sua própria rede, portanto, o Query Streams não precisa do seu token para responder a uma consulta.

Bom saber

  • É uma cópia sincronizada, não um proxy em tempo real. — Uma consulta lê o que já foi buscado, portanto, retorna na velocidade do SQL e nunca consome seu limite de taxa da API. Tabelas selecionadas também podem atualizar uma linha desatualizada à medida que você a lê.
  • Os limites de tarifa são respeitados para você. — cada conector opera bem dentro dos limites publicados pelo fornecedor, portanto, um relatório não pode fazer com que sua conta seja limitada para todos os outros usuários que o utilizam.
  • Nada é desperdiçado. — Os campos que a tabela não nomeia são mantidos em uma coluna JSON raw_data que você ainda pode consultar.
  • Integre-o aos seus bancos de dados. — Uma tabela de API e uma tabela do SQL Server na mesma instrução é uma consulta comum aqui, não um projeto de integração.

SQL entre fontes diferentes

Integre o Google Ads ao restante dos seus dados.

Os gastos ficam registrados no Google Ads, enquanto a receita fica em outro lugar, e é por isso que os dois geralmente são conciliados em uma planilha uma vez por mês. Um único extrato pode consultar a campanha, a conta que ela gerou e a fatura na qual foi emitida, tudo junto. Cada fonte processa apenas a parte que consegue, transmite o resultado de volta e a junção acontece de forma centralizada — as fontes nunca se comunicam entre si e nada é copiado para nenhum lugar.

3 conexões · 3 agentes

Anúncios do Google Anúncio
PostgreSQL Motor relacional
Listrado Pagamentos e faturamento

Uma declaração

-- gastos do Google Ads, a conta do seu banco de dados, receita do Stripe
SELECIONAR   g.campaign_name, SUM(g.cost_micros) / 1000000 AS spend, SUM(i.amount_due) AS invoiced
DE     anúncios.gads.campanha1       g
JUNTAR     pg_crm.clientes.públicos2 c LIGADO c.utm_campaign = g.campaign_name
JUNTAR     cobrança.stripe.faturas3 i LIGADO i.cliente = c.stripe_id
GRUPO POR g.nome_da_campanha
ORDER BY faturado DESC;

As três partes são conexão, esquema e tabela — e o nome da conexão é o que você escolheu. Colunas ilustrativas; suas tabelas serão suas tabelas. O custo é apresentado em microssegundos, conforme relatado pela API do Google Ads, portanto, a divisão é de sua responsabilidade e nada foi arredondado. O acesso somente leitura se aplica a cada componente: apenas SELECT, WITH e EXPLAIN, com um limite máximo de dados que uma única fonte pode fornecer para uma consulta. Como funcionam as consultas federadas

Detalhes da conexão

O que o Google Ads precisa

Autenticação
Uma chave de conta de serviço do Google com delegação em todo o domínio, um token de desenvolvedor e o e-mail que ela representa. Tudo armazenado no agente.
Conta
Um ID de cliente, além de um ID de conta de administrador opcional para acessar uma subconta.
Estendeu a mão por cima
HTTPS da sua rede para a API do Google Ads. Nada de entrada.
Esquema
gads — então gads.campaign, gads.search_term_view
Tabelas
12, das quais sete estão ativadas por padrão: customer, campaign, ad_group, keyword_view, search_term_view, geographic_view, device_view
Dinheiro
Em microssegundos, conforme informado pela API, divida por um milhão para obter o valor monetário.
Frescor
Executa até ontem. Cada passagem incremental lê novamente os três dias anteriores para que as conversões atribuídas tardiamente sejam contabilizadas.
História
90 dias na primeira sincronização. O histórico de alterações é limitado a 29 dias pelo Google.
Cópia local
Um arquivo DuckDB criptografado com AES-256-GCM ao lado do agente, em sua máquina.

O modo somente leitura é estrutural. O conector apenas emite as consultas de pesquisa do Google — não há nenhuma chamada de mutação nele — portanto, uma consulta não pode alterar um lance, pausar uma campanha ou gastar um centavo.

Em uma consulta entre fontes diferentes, a parte intermediária de uma referência de três partes é `gads`. Uma conexão chamada `ads` que lê a tabela `campaign` é escrita como `ads.gads.campaign`.

Documentação do fornecedor: anúncios.google.com

Perguntas frequentes

Perguntas sobre o Google Ads

Quais ferramentas conseguem ler dados do Google Ads por meio de fluxos de consulta?

Tudo isso, a partir de uma única conexão: Excel, Planilhas Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertas e relatórios agendados. Conecte a conta uma única vez e todas as plataformas lerão a mesma conexão somente leitura — não há configuração por ferramenta nem necessidade de uma segunda cópia dos dados.

Preciso abrir uma porta no firewall para minha conta do Google Ads?

Não. O Agente de Rede do Query Streams é executado dentro da sua rede e abre uma única conexão criptografada de saída. Nada fica à escuta do tráfego de entrada, nenhuma VPN é necessária e a conta mantém suas regras de firewall existentes.

É possível alterar dados nos fluxos de consulta do Google Ads por meio desses recursos?

Não. O agente impõe o modo somente leitura no ponto de execução — uma instrução por vez, apenas SELECT e similares. As credenciais permanecem no agente e nunca são enviadas para o Query Streams.

O que o Query Streams precisa para se conectar ao Google Ads?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto, nada é instalado na conta. Autenticação: uma chave de conta de serviço do Google com delegação em todo o domínio, um token de desenvolvedor e o e-mail que ele representa. Tudo armazenado no agente. Conta: um ID de cliente, além de um ID de conta de administrador opcional para acessar uma subconta. Acesso via: HTTPS da sua rede para a API do Google Ads. Nada de entrada. Esquema: gads — portanto, gads.campaign, gads.search_term_view.

Posso associar o Google Ads a outro banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar o Google Ads e suas outras conexões simultaneamente, escritas como conexão.esquema.tabela. Cada origem executa apenas a parte que consegue e transmite o resultado de volta; a junção ocorre centralmente, portanto, as origens nunca se conectam entre si e nada é copiado ou agendado. O modo somente leitura se aplica a cada parte — apenas SELECT, WITH e EXPLAIN — e há um limite para a quantidade de dados que uma origem pode fornecer em uma única consulta. Consultas federadas são um recurso do plano; a página de consultas federadas contém os limites atuais de origem e tamanho.

Coloque os anúncios do Google onde o trabalho acontece.

Instale o agente, aponte-o para sua conta e escolha um destino.

Comece gratuitamente Todos os conectores

Somente leitura Apenas envio As credenciais permanecem com o agente.