Google 广告标志

广告

连接 谷歌广告 适用于 Excel、Google Sheets、AI 和 REST

将广告系列、广告组、关键词和支出数据以可查询表格的形式呈现。您可以将这些数据与存储在 Postgres 或电子表格导出文件夹中的转化数据进行关联。

免费开始 13个目的地

一个连接，每个表面

您的 Google Ads 数据可以去哪里

谷歌广告 实时 API 数据 作为 SQL 表
联合查询 + 任何其他连接器 · 一条 SQL 跨来源 · 每个计划
网络代理
  • 1 出站连接
  • 0 入境口岸
  • 只读 · 凭据保留

运行

Query Streams 将 Google Ads 帐户转换为 12 个 SQL 表，包括广告系列、广告组、广告、关键字、搜索词、地理位置、设备、受众特征、着陆页和更改历史记录，这些表可通过 Microsoft Excel、Google Sheets、Power BI、MCP 上的 AI 助手以及 REST 端点读取。支出数据以列的形式呈现，您可以将其与收入数据关联起来，这正是关键所在：通常每月在电子表格中进行一次的对账工作，现在只需一份报表即可完成。

  1. 为您的团队、供应商和合作伙伴

  2. Google Ads 助力卓越 微软 Excel · Excel 加载项

    将实时 Google Ads 结果直接导入工作表，并可按需刷新——支持桌面版 Excel、Excel Online 和 Microsoft 365。

    Excel 的工作原理

  3. Google Ads 到 Google Sheets 表格插件

    从侧边栏运行已保存的 Google Ads 查询，并将结果行拖放到表格中。共享的协作者可以自行刷新表格。

    Google 表格的工作原理

  4. 向 Nova 咨询 Google Ads 相关事宜。 Nova AI · 文本转 SQL

    用简单的英语提问。Nova 已经了解您的 Google Ads 数据表，会自动编写并运行 SQL 查询，解释结果并绘制图表——无需编写查询语句，也无需提供任何凭据。

    Nova 的工作原理

  5. Google Ads 数据查看器 结果共享 · 团队、供应商、合作伙伴 · 手机、平板电脑、台式机

    您可以与任何人（同事、供应商、合作伙伴）分享实时 Google Ads 广告结果，将其以可收藏的网格形式呈现，无论在手机、平板电脑还是台式机上打开，都能立即显示最新结果。他们看到的是广告结果，而无需查看 SQL 代码或凭据。

    数据查看器的工作原理
  6. 对于应用程序和系统

  7. Google Ads REST API HTTP 端点

    将 Google Ads 查询发布为任何应用程序都可以调用的已认证 JSON 端点，符合 OpenAPI 3.1 规范，并已预置 Postman、Insomnia 和 Hoppscotch 集合。无需打开数据库端口。

    REST API 的工作原理

  8. Google Ads 到 Power BI Power Query M

    将生成的 Power Query M 粘贴到 Power BI 高级编辑器中，报表即可通过 HTTPS 读取实时 Google Ads 结果——无需 ODBC 驱动程序，也无需打开数据库端口。

    Power BI 的工作原理

  9. Google Ads 到 Airtable 自动化平台

    按计划将 Google Ads 行同步到 Airtable，或者在 Airtable 自动化脚本中获取它们。

    Airtable 的工作原理

  10. Google Ads 到 Baserow 自动化平台

    通过 REST 端点从 Google Ads 向 Baserow 表提供数据——无论是自托管还是 Baserow 云。

    Baserow 的工作原理

  11. Google Ads 到 SeaTable 自动化平台

    无需导出文件或公开数据库，即可使用 Google Ads 数据更新 SeaTable 数据库。

    SeaTable 的工作原理

  12. Google Ads 到 Smartsheet 自动化平台

    将 Google Ads 结果推送到 Smartsheet 表格中，以便计划和报告能够从源系统读取数据，而不是从上周的导出数据读取数据。

    Smartsheet 的工作原理

  13. Google Ads 转 Anvil Anvil Works · 应用平台

    通过 REST 端点为 Anvil Python 应用程序添加 Google Ads 支持，而不是将数据库凭据嵌入到应用程序中。

    Anvil 的工作原理
  14. 人工智能工具

  15. Google Ads MCP 服务器 Claude、Cursor 和 MCP 客户端

    赋予 AI 助手对 Google Ads 的只读访问权限，并提供它编写正确 SQL 所需的架构——聊天中不包含凭据。

    Google Ads 指南
  16. 已送达

  17. Google Ads 提醒和报告 Slack · Discord · 电子邮件 · Webhook

    将 Google Ads 查询设置为定时发送，并将结果发送到 Slack、Discord、电子邮件或签名 webhook，或者等到行数、阈值或百分比变化超过您设定的界限时才发送消息。

    警报和报告的工作原理

工作原理

5 个步骤，无需更改入站防火墙规则

01

获取 Google Ads 帐户的开发者令牌，并创建具有域范围委派的服务帐户。

02

安装网络代理，并为其提供服务帐户密钥、开发者令牌、要模拟的电子邮件地址和客户 ID。管理员帐户 ID 为可选，用于访问子帐户。

03

选择要同步的 12 个表中的哪些。默认情况下，广告系列、广告组、关键字、搜索词、地理位置、设备和帐户本身均已启用。

04

针对 gads.campaign、gads.search_term_view 等字段编写普通 SQL 语句——或者让 Nova 来编写。

05

从 Excel、Sheets、Power BI、MCP 或 REST 中读取数据，并将其连接到存储收入的任何系统。

专题深度解析

Google Ads 能给你带来什么

支出与收入，在一份报表中体现。

Google Ads 知道你花了多少钱，但它不知道客户最终支付了多少钱，而真正重要的报告需要同时包含这两项信息。

  • gads.campaign 按天记录展示次数、点击次数、费用、转化次数和转化价值，因此可以与按广告系列名称或 UTM 参数输入的任何内容无缝连接。
  • gads.search_term_view 是用户实际输入的查询语句，资金通常就是从这里流失的。 ——而且它可以与您自己的转化数据连接，而不是被困在广告界面中。
  • 资金以微克为单位到账，与 API 报告的完全一致。1 美元等于 1,000,000，因此在您自行除法之前，没有任何四舍五入的情况。

这12张桌子

  • 结构 — customer、campaign、ad_group、ad_group_ad。
  • 搜索 — keyword_view、search_term_view、landing_page_view。
  • 故障 — 地理视图、设备视图、年龄范围视图、性别视图。
  • 审计 — 变更历史。
  • 每一行还会将完整的 API 响应保存在 raw_data JSON 列中，因此即使没有命名列，指标仍然存在。

说实话，数字也就到此为止了。

关于广告数据，任何工具都必须面对两个问题，这一点必须坦诚相告，而不是事后才发现。

  • 报告截至昨天，而非今天。 — 谷歌方面目前掌握的数据并不完整，只会产生误导。
  • 每次增量运行都会重新读取最近几天的数据以及最新一天的数据，因为转化归因会延迟，你在周一获取的数字可能与谷歌在周四确定的数字不同。
  • Google Ads API 本身将变更历史记录限制在 29 天以内。它显示的是最近的变更信息流，而不是永久的审核日志。
  • 部分地理位置列使用的是谷歌的搜索条件 ID 而非地名，还有几列广告文案尚未填写。已填写的内容准确无误；未填写的内容为空，而非错误。

每个 API 连接器共享

每个 API 连接器的工作原理

  • 您的帐户将变成表格 — 端点映射到具有主键和索引的类型化 SQL 表，因此您可以编写 SELECT、JOIN 和 GROUP BY，而不是翻阅 JSON。
  • 您可以选择同步哪些内容以及同步频率。 每个表都有自己的时间间隔，或者根本没有时间间隔。如果供应商的 API 支持，则只会获取自上次运行以来发生更改的记录。
  • 副本归你所有 它以 AES-256-GCM 加密的形式存储在您本地的 DuckDB 文件中，与代理程序位于同一位置。它不在我们的云端。
  • 供应商只会收到你的消息。 — 代理直接从您自己的网络调用 API，因此 Query Streams 不需要您的令牌来回答查询。

知道这个很有用

  • 这是一个同步副本，而不是实时代理。 — 查询读取的是已经获取过的数据，因此返回速度与 SQL 查询相同，不会超出 API 速率限制。此外，所选表还可以在读取数据时刷新过期的行。
  • 您的速率限制将得到遵守。 — 每个连接器都会在供应商公布的限制范围内自行控制速度，因此报告不会导致您的帐户对使用它的其他所有帐户进行限速。
  • 没有东西会被扔掉 — 表中未命名的字段保存在 raw_data JSON 列中，您仍然可以对其进行查询。
  • 将其连接到您的数据库 — 在同一条语句中同时使用 API 表和 SQL Server 表在这里只是普通的查询，而不是集成项目。

跨源 SQL

将 Google Ads 与您的其他数据关联起来

广告支出和收入分别存储在不同的系统中，因此通常每月通过电子表格进行一次核对。一份报表可以同时查询广告系列、其产生的账户以及相应的发票。每个数据源只处理其能够处理的部分，并将结果流式传输回系统，然后集中进行合并——各个数据源之间互不通信，也不会复制任何数据。

3 个连接 · 3 个代理

谷歌广告 广告
PostgreSQL 关系引擎
条纹 付款与账单

一份声明

——来自 Google Ads 的支出、数据库中的帐户信息、Stripe 的收入
选择   g.campaign_name, SUM(g.cost_micros) / 1000000 AS spend, SUM(i.amount_due) AS invoiced
从     广告.gads.campaign1       g
连接     pg_crm.public.customers2 c ON c.utm_campaign = g.campaign_name
连接     计费.stripe.invoices3 i ON i.customer = c.stripe_id
GROUP BY g.campaign_name
ORDER BY 发票上的描述；

这三个部分分别是连接、模式和表——连接名称由您自行命名。列仅供参考；您的表就是您自己的表。费用以微克为单位，与 Google Ads API 报告的单位相同，因此除法运算由您自行完成，且未进行任何四舍五入。所有部分均为只读：仅支持 SELECT、WITH 和 EXPLAIN 语句，并且对单个数据源单次查询的费用上限进行了限制。 联合查询的工作原理

连接详情

Google Ads 需要什么

验证
代理程序持有一个具有域范围委托权限的 Google 服务帐户密钥、一个开发者令牌以及它所模拟的电子邮件地址。
帐户
客户 ID，以及用于访问子账户的可选经理帐户 ID
伸手够到
您的网络通过 HTTPS 连接到 Google Ads API。没有入站流量。
模式
gads — 所以 gads.campaign，gads.search_term_view
表格
共 12 项，其中 7 项默认启用：客户、广告系列、广告组、关键词视图、搜索词视图、地理视图、设备视图
钱
以微克为单位，如 API 报告的那样——除以一百万即可得到货币单位。
新鲜
运行至昨日。每次增量扫描都会重新读取前三天的数据，以便将延迟归因的转换也纳入统计。
历史
首次同步后保留 90 天。Google 将 change_history 限制为 29 天。
本地副本
代理程序旁边，您的计算机上有一个使用 AES-256-GCM 加密的 DuckDB 文件。

只读属性是结构性的。该连接器仅发出 Google 的搜索查询——其中完全没有 mutate 调用——因此查询无法更改出价、暂停广告系列或花费一分钱。

在跨源查询中，三部分引用的中间部分是 gads。读取 campaign 表的名为 ads 的连接写为 ads.gads.campaign。

供应商文档： ads.google.com

常问问题

关于谷歌广告的问题

哪些工具可以通过查询流读取 Google Ads 数据？

只需一次连接，即可访问所有平台：Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、定时提醒和报表。只需连接一次帐户，所有平台即可读取同一个只读连接——无需为每个工具单独设置，也无需创建数据副本。

我是否需要为我的 Google Ads 帐户打开防火墙端口？

不。Query Streams 网络代理运行在您的网络内部，并打开一个单独的出站加密连接。它不会监听入站流量，无需 VPN，并且帐户会保留其现有的防火墙规则。

查询流可以更改 Google Ads 中的数据吗？

不。代理在执行时强制执行只读模式——一次只执行一条语句，仅限 SELECT 及其相关语句。凭据保留在代理上，绝不会发送到查询流。

Query Streams 需要连接到 Google Ads 的哪些组件？

可访问的主机、角色及其密码——代理程序携带驱动程序，因此无需在帐户上安装任何内容。身份验证：具有域范围委派权限的 Google 服务帐户密钥、开发者令牌以及代理程序模拟的电子邮件地址。所有信息均保存在代理程序中。帐户：客户 ID，以及用于访问子帐户的可选管理员帐户 ID。访问方式：通过 HTTPS 从您的网络访问 Google Ads API。无入站请求。架构：gads——例如 gads.campaign、gads.search_term_view。

我可以在同一个查询中将 Google Ads 与其他数据库连接起来吗？

是的——这就是联合查询。一条语句可以同时引用 Google Ads 和其他连接，格式为 connection.schema.table。每个数据源只运行它能够执行的部分，并将结果流式传输回来；连接操作在中心进行，因此各个数据源之间不会相互连接，也不会进行任何复制或调度。所有部分（SELECT、WITH 和 EXPLAIN）都采用只读模式，并且单个数据源在单次查询中可以传输的数据量有限制。联合查询是一项套餐功能；联合查询页面会显示当前的数据源和大小限制。

将谷歌广告投放在工作发生的地方

安装代理，将其指向您的帐户，然后选择目标位置。

免费开始 所有连接器

只读 仅限出站 凭证保留在代理人身上。