怎样让 Codex 直接读取 GA4 数据

导读

将 Shopify、GA4、Search Console 和 Google Ads 接入 Codex 听起来复杂，但我们可以分步实施。本文专注于第一步：让 Codex 直接读取 GA4 数据。

配置完成后，您无需再手动打开 GA4、筛选时间、截图并发送给 AI。您可以直接通过自然语言提问：

帮我看一下网站最近 7 天的流量、活跃用户、购买次数和收入。

对比最近 7 天和之前 7 天，哪些渠道的流量变化最大？

最近哪些落地页有流量，但转化比较差？

本文专为非技术人员编写，请按顺序完成每一步操作。

连接原理：我们在连接什么？

我们并非将个人 Google 账号密码交给 Codex，而是通过在 Google Cloud 创建Service Account（服务账号）来实现安全连接。这相当于为程序创建一个专用的 Google 身份。

该身份仅被授予目标 GA4 媒体资源的“查看者”权限。整体逻辑如下：

Codex → 本机密钥文件 → 服务账号 → GA4 查看者权限 → 读取报表数据

此方式无需使用管理员的个人登录凭证，也无需授予 GA4 编辑权限，确保了数据安全。

准备工作清单

01一个可登录 Google Cloud 的 Google 账号；

02该账号需具备管理目标 GA4 媒体资源访问权限的能力；

03已安装并可正常使用的 Codex；

04明确需连接的网站及对应的 GA4 媒体资源。

若在 GA4 左下角看不到“管理”或“媒体资源访问权限管理”，说明当前账号权限不足，请先联系管理员确认。

STEP 01：在 Google Cloud 新建项目

登录 Google Cloud 控制台，按以下步骤操作：

01点击顶部项目名称或“选择项目”；

02在弹窗中点击“新建项目”；

03项目名称建议填写 AI-GA4-Connection；

04“组织”和“位置”若无强制要求，保持默认即可；

05点击“创建”；

06创建完成后，确认页面顶部已切换至新项目。

验证成功：页面顶部显示的是刚创建的项目名称。

STEP 02：启用 Google Analytics Data API

项目创建后，需启用相应的 API 以允许读取 GA4 数据：

01点击左上角菜单；

02进入"API 和服务”；

03点击“库”；

04搜索框输入 Google Analytics Data API；

05选择名称完全匹配的结果；

06点击“启用”。

若按钮显示为“管理”，则表示 API 已启用。

验证成功：页面显示 API 已启用或按钮变为“管理”。

注意：务必启用 Google Analytics Data API，而非其他名称相似的 API。

STEP 03：创建服务账号

为 Codex 创建专用的数据读取身份：

01打开 Google Cloud 左上角菜单；

02进入"IAM 和管理”；

03点击“服务账号”；

04点击“创建服务账号”；

05名称填写 ga4-reader；

06ID 自动生成，无需修改；

07点击“创建并继续”。

若出现“授予访问权限”步骤，可直接点击“继续”或“完成”。GA4 的查看权限将在后续步骤中单独配置。

验证成功：列表中出现新账号，且拥有以 iam.gserviceaccount.com 结尾的邮箱地址。

STEP 04：下载 JSON 密钥文件

生成 Codex 所需的身份凭证：

01点击刚创建的 ga4-reader 账号；

02进入“密钥”标签页；

03点击“添加密钥”；

04选择“创建新密钥”；

05类型选择 JSON；

06点击“创建”。

浏览器将自动下载 .json 文件。请将其保存至电脑本地安全目录，严禁上传至网盘、发送至微信群或上传至 GitHub。

验证成功：本地已保存 Google 下载的 .json 文件，并知晓其存储路径。

重要安全规则

只需将“文件路径”告知 Codex，切勿将 JSON 文件内容复制到对话框中。

路径示例：

/Users/你的用户名/GA4 密钥/你的密钥文件.json

路径仅指示文件位置，JSON 内的私钥才是敏感信息。若密钥泄露，请立即在 Google Cloud 删除旧密钥并重新创建。若“创建新密钥”按钮不可用，可能是公司安全策略限制，需联系管理员处理。

STEP 05：将服务账号加入 GA4

复制服务账号邮箱（格式如 ga4-reader@项目 ID.iam.gserviceaccount.com），然后在 Google Analytics 中进行授权：

01确认选中目标网站；

02点击左下角“管理”；

03在“媒体资源”列点击“媒体资源访问权限管理”；

04点击右上角加号；

05选择“添加用户”；

06粘贴服务账号邮箱；

07角色仅勾选“查看者”；

08点击“添加”。

添加完成后，该账号即获得只读权限，无需接收邮件或点击链接。

验证成功：用户列表中可见该服务账号，角色为“查看者”。

STEP 06：获取 GA4 Property ID

在 GA4 后台查找媒体资源 ID：

01点击左下角“管理”；

02进入“媒体资源设置”或“媒体资源详情”；

03找到“媒体资源 ID"。

正确的 ID 为纯数字（如 123456789）。注意：勿将以 G- 开头的衡量 ID（Measurement ID）误作 Property ID。

验证成功：已记录一串纯数字的媒体资源 ID。

STEP 07：配置 Codex

向 Codex 提供两项关键信息：

01GA4 Property ID；

02JSON 密钥文件的本地完整路径。

参考指令：

请帮我验证 GA4 是否已经连接成功。GA4 Property ID：[填写纯数字 ID] JSON 文件路径：[填写本机完整路径] 请读取最近 7 个完整自然日的数据，先验证 sessions 和 activeUsers；成功后再读取 ecommercePurchases 和 totalRevenue。不要显示或复制 JSON 文件中的私钥内容。

建议先验证基础访问数据（sessions、activeUsers），再验证电商数据，以便区分是连接问题还是电商追踪配置问题。

STEP 08：验证连接结果

真正的成功标准是 Codex 返回实际数据行，包含：

日期；

会话数 sessions；

活跃用户数 activeUsers；

电商购买次数 ecommercePurchases；

总收入 totalRevenue。

建议人工核对 GA4 后台相同日期范围的数据趋势。由于时区、归因模型和处理延迟，数值可能存在微小差异，重点确认指标口径和趋势一致性。

常见问题排查 (Troubleshooting)

1. 提示 403 或 Permission Denied

检查服务账号邮箱是否已正确添加至目标 GA4 媒体资源，且拥有“查看者”权限。常见错误是将账号加错了媒体资源。

2. 提示 404 或找不到媒体资源

确认填写的是否为纯数字 Property ID。若填写了 G-XXXXXXXXXX，则是混淆了衡量 ID 与媒体资源 ID。

3. 能读到流量，但购买和收入为 0

若 sessions 和 activeUsers 有数据，说明连接正常。收入为 0 通常是因为网站未正确配置 GA4 电商事件，或所选时间段内无成交记录。此时应检查网站追踪代码，而非重建服务账号。

4. 找不到“创建新密钥”

可能是公司组织策略禁止创建服务账号密钥。需联系管理员采用合规的身份验证方式，切勿尝试绕过安全策略。

实战应用：接通后如何提问？

连接成功后，避免提出过于宽泛的问题。建议从具体维度入手：

对比最近 7 天和之前 7 天的 sessions、activeUsers、ecommercePurchases 和 totalRevenue，并说明变化最大的指标。

最近 30 天，网站的主要流量渠道有哪些？请按会话数排序。

最近 30 天，访问量最高的 10 个落地页分别是什么？哪些页面有流量但购买表现偏弱？

按国家查看最近 30 天的用户和收入，找出流量与收入不匹配的市场。

至此，Codex 已从简单的聊天工具转变为能读取真实经营数据的数据助理。

GA4 揭示了用户在站内的行为，而用户如何通过搜索关键词进入网站、哪些页面获得了 Google 曝光？这些问题需要借助 Google Search Console。下一篇将讲解如何将 Google Search Console 接入 Codex。

AI DATA COCKPIT · 02

#兵哥说独立站 · 兵哥