怎样让 Codex 读取 Google Search Console 数据

前言：从 GA4 到 Search Console

上一篇文章介绍了如何让 Codex 读取 GA4 数据，以分析用户进入网站后的行为及转化情况。然而，若要洞察用户在进入网站前的自然搜索表现，则必须接入 Google Search Console（GSC）。

通过 GSC 与 Codex 的结合，您可以直接查询以下核心问题：

本文将跳过复杂的 API 结构讲解，专注于实际操作流程，助您快速完成对接。

资源复用：无需重新创建账号

若您已完成上一篇文章中的 GA4 对接，以下三项资源可直接复用，无需重新创建项目或下载新的密钥文件：

本次操作仅需完成四个步骤：启用 Search Console API、复制服务账号邮箱、在 GSC 添加用户权限、让 Codex 验证数据。

前置条件：网站所有权验证

开始前，请确保您的网站已在 Google Search Console 中完成绑定。登录 GSC 后台，确认左上角可选择目标网站。

对于 Shopify 用户，常见做法是在 GSC 添加网站后，将提供的 HTML 验证标签嵌入 Shopify 主题中以完成所有权验证。若后台已能正常查看网站及搜索数据，则无需重复此步骤。

操作步骤

第一步：启用 Search Console API

登录 Google Cloud 控制台，确认当前选中的是之前创建服务账号时使用的项目，然后按以下步骤操作：

若按钮显示为“管理”，则表示 API 已启用，无需重复操作。

第二步：复制服务账号邮箱

在 Google Cloud 控制台中执行以下操作：

服务账号邮箱格式通常如下：

ga4-reader@你的项目 ID.iam.gserviceaccount.com

即使账号名称为"ga4-reader"，也可用于读取 Search Console 数据。该名称仅为标识，不限制其功能范围。

第三步：在 Search Console 添加用户

登录 Google Search Console，按以下步骤授权服务账号：

“受限”与“完整”权限均可读取搜索表现数据。鉴于 Codex 仅用于数据分析，选择“受限”权限通常已足够。若已授予“完整”权限，亦无需修改。

注意：服务账号无需接收邮件或点击邀请链接。若找不到“添加用户”按钮，请切换至拥有网站所有权管理权限的 Google 账号进行操作。

第四步：指令 Codex 验证连接

最后，只需向 Codex 提供两项信息：JSON 密钥文件的本地完整路径、以及目标网站域名。

参考指令如下：

Codex 会自动匹配服务账号权限下的网站。若账号关联多个网站，请务必指定具体域名以避免数据混淆。

成功验证标准

连接成功的标志并非仅是 Codex 回复“连接成功”，而是能够返回真实的搜索表现数据，包括：

随后，您可进一步指令 Codex 分析搜索关键词、流量页面、国家分布、设备类型及每日趋势等维度。

最终成功标志：Codex 能返回包含真实日期、点击量、曝光量、点击率及平均排名的具体数据报表。

数据时效性说明

建议将查询的结束日期设定为三天前。Google 官方指出，Search Console 的搜索表现数据通常需要 2-3 天才能完全更新。因此，为确保数据稳定性，复盘时建议避开最近两天的数据。例如今天是 12 号，建议查询至 9 号的数据。这并非连接故障，而是 GSC 数据处理机制所致。

常见问题排查

1. Codex 无法找到任何网站

请优先检查：

2. Codex 识别了错误的网站

若服务账号被授权访问多个网站，请在指令中明确指定目标域名。日常使用无需关注 API 参数细节，仅在自动匹配失败时，可要求 Codex 列出所有可访问网站以供选择。

3. Search Console 点击数与 GA4 会话数不一致

此为正常现象。Search Console 统计的是 Google 搜索结果中的点击（进站前），而 GA4 统计的是用户进站后的会话和行为。Cookie 同意弹窗、页面加载延迟、隐私设置、时区差异及数据处理逻辑均会导致数据偏差。

最佳实践是：利用 Search Console 分析自然搜索的曝光与点击趋势，结合 GA4 分析用户进站后的浏览与转化行为，而非强求两者数值完全一致。

实战应用示例

连接完成后，您可以直接向 Codex 提出以下高阶分析需求：

至此，Search Console 与 Codex 的对接已全部完成。日常使用中，无需重复配置 API 参数，只需直接提问即可获取数据洞察。

下期预告：如何将 Shopify 接入 Codex，以及单店与多店架构下的不同连接策略。