Google Analytics 4 徽标

Web 分析

连接 谷歌分析 4 适用于 Excel、Google Sheets、AI 和 REST

GA4 事件和流量数据以 SQL 格式提供。无需 BigQuery 导出往返，即可将其与 Search Console 和产品数据库配合使用。

免费开始 13个目的地

一个连接，每个表面

您的 GA4 数据可以去哪里

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

运行

Query Streams 将 GA4 属性转换为 9 个 SQL 表——流量概览、流量来源、页面、事件、互动、地理位置、电子商务、交易以及实时活跃用户表——这些表可通过 Microsoft Excel、Google Sheets、Power BI、MCP 上的 AI 助手以及 REST 端点读取。无需导出到 BigQuery，无需链接项目，也无需等待 24 小时才能看到表格：只需提供服务帐户密钥和属性 ID，即可查询数据。

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

  2. GA4 到 Excel 微软 Excel · Excel 加载项

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

    GA4 指南

  3. GA4 转 Google Sheets 表格插件

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

    GA4 指南

  4. 向Nova询问GA4的情况 Nova AI · 文本转 SQL

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

    Nova 的工作原理

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

    您可以与任何人（同事、供应商、合作伙伴）共享实时 GA4 结果，将其以可收藏的网格形式呈现，无论在手机、平板电脑还是台式机上打开，都会自动重新显示。他们看到的是结果，而不是 SQL 语句或凭据。

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

  7. GA4 REST API HTTP 端点

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

    REST API 的工作原理

  8. GA4 到 Power BI Power Query M

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

    Power BI 的工作原理

  9. GA4 转 Airtable 自动化平台

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

    GA4 指南

  10. GA4 至 Baserow 自动化平台

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

    GA4 指南

  11. GA4 至 SeaTable 自动化平台

    无需导出文件或公开数据库，即可使用 GA4 数据保持 SeaTable 数据库的最新状态。

    GA4 指南

  12. GA4 转 Smartsheet 自动化平台

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

    GA4 指南

  13. GA4 至 Anvil Anvil Works · 应用平台

    通过 REST 端点向 Anvil Python 应用程序提供 GA4 支持，而不是将数据库凭据嵌入到应用程序中。

    GA4 指南
  14. 人工智能工具

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

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

    GA4 指南
  16. 已送达

  17. GA4 警报和报告 Slack · Discord · 电子邮件 · Webhook

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

    警报和报告的工作原理

工作原理

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

01

创建一个 Google 服务帐户，并授予其对 GA4 资产的读取权限。

02

安装网络代理，并为其提供服务帐户密钥和数字属性 ID。密钥将保留在代理上。

03

选择要同步的9个表格中的哪些。流量概览、流量来源、页面浏览量和事件默认开启。

04

针对 ga4.traffic_sources、ga4.page_views 等字段编写普通 SQL 语句——或者让 Nova 来编写。

05

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

专题深度解析

GA4能给你带来什么

无需绕道 BigQuery

通常将 GA4 数据导入 SQL 的方法是：链接一个 BigQuery 项目，等待导出开始，支付存储费用，然后查询嵌套事件表。而这种方法可以跳过所有这些步骤。

  • 数据来自 GA4 自己的报告 API，因此无需配置导出功能，也无需等待。
  • 它会在首次同步时读取 GA4 于 2020 年 10 月发布时的数据，因此历史记录就在那里，而不是从你设置它的那天开始。
  • 行以按日粒度聚合的形式到达，并带有命名列。 — 日期、来源、媒介、活动、渠道、会话、用户、参与度 — 而不是需要解嵌套的嵌套事件块。
  • 完整的 API 响应数据保存在 raw_data JSON 列中。

九张桌子

  • 交通 —流量概览、流量来源、页面浏览量、用户参与度。
  • 观众 — 地理数据，事件。
  • 商业 — 电子商务概览，交易。
  • 现在 — 实时活跃用户。

两台钟，哪张桌子靠哪台钟运行

GA4 分为批处理部分和实时部分，它们的运行方式不同。明确这一点，是生成一份值得信赖的报告和一份令人质疑的报告之间的区别。

  • 这八个批次表格的数据截至昨天。GA4 不会立即最终确定当天的数据，而是需要一两天时间，因此每次增量运行都会重新读取前三天的数据，让数字稳定下来，而不是冻结它最初读取到的版本。
  • realtime_active_users 确实实时 — 滚动式 30 分钟窗口，当查询触及该窗口时按需刷新，并具有 30 秒的新鲜度窗口。
  • 该表格显示的是当前网站的快照，而不是历史记录：它回答的是现在谁在网站上，而不是昨天下午四点谁在网站上。

每个 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

将 GA4 连接到您的其余数据

GA4 知道会话来自哪个来源，但不知道会话价值多少。您的数据库知道账户信息，您的支付处理商知道金额。一条语句即可将这三者并排显示。每个来源只运行其能够处理的部分，并将结果流式传输回数据库，连接操作在中心进行——各个来源之间互不通信，也不会复制任何数据。

3 个连接 · 3 个代理

谷歌分析 4 Web 分析
PostgreSQL 关系引擎
条纹 付款与账单

一份声明

——来自 GA4 的会话数、数据库中的帐户信息、Stripe 的收入
选择   g.session_source, SUM(g.sessions) AS sessions, SUM(i.amount_due) AS invoiced
从     ga4_site.ga4.traffic_sources1 g
连接     pg_crm.public.customers2      c ON c.utm_source = g.session_source
连接     计费.stripe.invoices3      i ON i.customer = c.stripe_id
GROUP BY g.session_source
ORDER BY 发票上的描述；

这三个部分分别是连接、模式和表——连接名称就是您自己命名的。这些列仅供参考；您的表就是您自己的表。GA4 批量表会运行到昨天，因此此类报告中的最新日期是前天——这是 GA4 自身的最终确定窗口，而非同步延迟。所有部分都采用只读模式：仅支持 SELECT、WITH 和 EXPLAIN 语句，并且对单个查询中每个数据源可以提交的数据量有限制。 联合查询的工作原理

连接详情

GA4需要什么

验证
代理持有的具有对该房产读取权限的 Google 服务帐户密钥。只读权限
财产
数字 GA4 属性 ID
伸手够到
从您的网络到 GA4 数据 API 的 HTTPS 连接正常。没有入站请求。
模式
ga4 — 因此包括 ga4.traffic_sources、ga4.page_views
表格
9，其中四项默认启用：流量概览、流量来源、页面浏览量、事件
新鲜
批次表的数据截至昨天，GA4 最终确定时，每次都会重新读取前三天的数据。
历史
首次同步时间点回溯至 2020 年 10 月 1 日
实时刷新
仅实时活跃用户数——滚动30分钟窗口，并设有30秒新鲜度窗口。
本地副本
代理程序旁边，您的计算机上有一个使用 AES-256-GCM 加密的 DuckDB 文件。

实时表仅包含 Google 快照返回的前几百个组合，这是实时 API 的限制，而非此连接器的限制。要查看全天的完整数据，请使用批处理表。

在跨源查询中，三部分引用的中间部分是 ga4。名为 ga4_site 的连接读取流量源，写成 ga4_site.ga4.traffic_sources。

供应商文档： marketingplatform.google.com

常问问题

关于 Google Analytics 4 的问题

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

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

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

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

查询流能否更改 Google Analytics 4 中的数据？

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

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

可访问的主机、角色及其密码——代理程序携带驱动程序，因此无需在帐户上安装任何内容。身份验证：代理程序上持有的具有对该属性读取权限的 Google 服务帐户密钥。只读范围。属性：GA4 属性的数字 ID。访问方式：通过 HTTPS 从您的网络访问 GA4 数据 API。无入站流量。架构：ga4——例如 ga4.traffic_sources、ga4.page_views。

我可以在同一个查询中将 Google Analytics 4 连接到另一个数据库吗？

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

将 GA4 放置在工作地点。

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

免费开始 所有连接器

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