跳到主要内容
2026年7月19日 · 手册

手册:连接 Search Console 与 Analytics

本文描述的是发布时的产品情况。有关当前功能,请参阅 AI 构建器智能体团队

手册:连接 Search Console 与 Analytics

创建服务账号只需四分钟。首次同步即可回填十六个月的 Search Console 历史数据。已验证并授权的域名只需两秒。还有两个月——这个数字引发的支持工单比其他三个加起来还多,因为这是 GA4 默认的数据保留期限,而几乎没人会在连接前想到要检查它。

设置本身很简单:在设置 → Google 账号中填入一个凭据,在域名管理中点击两个连接按钮,之后你基本就会忘记这个页面的存在。但那个「两个月」的数字值得详细说明,因为它解释了为什么有些域名第一天就能看到丰富有用的 Analytics 历史数据,而另一些域名却几周内几乎什么都看不到——出现这种情况并不是平台故障。

一次授权的单一凭据

你上传的是一个 Google 服务账号密钥——一个 JSON 文件,而不是个人登录信息。这是机器人身份,不是那种会过期或因密码更改而失效的人工 OAuth 令牌。Google Cloud 只签发一次,之后会一直有效直到你删除它,这也正是平台能在凌晨三点无人登录的情况下自动同步的原因。

如果你从未做过,创建一个大约需要那四分钟:新建或选择已有项目,进入 IAM 和管理 → 服务账号 → 创建,下载密钥。权限的重要性比下拉菜单看起来的要高——只在 Search Console 属性和 Analytics 属性上授予查看者权限,不要更高。我见过有团队因为「编辑者」是列表顶部选项就直接选了它,结果六个月后没人能说清为什么一个机器人账号对他们的 GA4 配置拥有写入权限。只读权限才是正确做法;平台从不会去改动你的设置。

一个密钥可以覆盖该 Google Cloud 项目下的所有域名。如果你是运营着十几个客户网站的代理商,这更适合为每个客户单独建立一个服务账号,而不是一个通用账号——这样解约一个客户只需删除一个密钥,而不必去排查哪些域名悄悄和某个已经离职的人共享了凭据。

Search Console:快的时候很快,麻烦的时候很麻烦

  • 在某个域名上打开连接。Search Console 和 Analytics 各有一张卡片,Analytics 有一个「与 Search Console 相同」的快捷选项,因为通常一个密钥就能同时覆盖两者。
  • 如果已经验证过并授权给你的服务账号?瞬间完成——只是一次权限检查,大约两秒。
  • 尚未验证:如果你提供注册商的 API 密钥(Cloudflare、Route 53 等),可以自动完成 DNS 验证;否则需要你自己添加一条手动 TXT 记录。

手动方式最容易让人失去耐心。传播时间确实会因情况而异——有时九十秒,有时四小时,取决于 TTL 和解析器缓存。平台会持续轮询,你添加记录后就可以先放着不管。如果过了一天还没验证成功,通常不是传播延迟的问题,而是记录值有误,或者记录添加到了错误的区域(顶级域名和子域名弄反了)。在归咎于 Google 之前,先用 `dig TXT` 检查一下实际生效的记录。

API 密钥方式会自动帮你写入记录,省去这些麻烦,但代价是要把 DNS 的写入权限交给第三方工具——如果这个 DNS 承载着生产流量,我认为犹豫一下并不过分。手动方式前期多花几分钟,但换来的是以后再也不用操心这件事。

Analytics,以及那个没人提醒你的数据保留缺口

Analytics 的连接方式是发现而非验证——平台会查找该域名下是否已有 GA4 属性,如果你的服务账号有访问权限就直接连接,因为 GA4 的权限已经由 Google 那边把关了。如果没有属性存在,平台可以帮你创建一个,但这个功能只应用于真正的新网站。如果你是从 Universal Analytics 迁移过来的,或者已有一个积累了多年历史数据的属性,请明确连接到那个属性。一个只有三天数据的全新属性,起点要比一个积累了九年、包含季节性规律的旧属性差得多,而优化循环对这类历史数据的依赖程度远超连接流程所暗示的。

这里有个容易让人措手不及的缺口:Search Console 在首次同步时会回填长达十六个月的查询数据,因为无论你何时连接,Google 都会在服务器端保留这么长时间的历史。GA4 没有类似的保证——它的回填上限取决于该属性自身的数据保留设置,而这个设置默认是两个月,除非你们组织里有人改过。因此同一天、同一套设置流程,一个域名可能在连接的瞬间就显示出十六个月的展示量和点击量,而会话数据却只有两个月。这不是同步失败,而是 Google 的保留期默认设置正在按配置正常运作。如果你想让今后的数据保留更久,解决方法是直接去 GA4 的属性设置里修改保留期限,这与本平台无关。这一点最好在连接前就查清楚,而不是等出现数据不匹配再来困惑。

共享属性,以及连接之后会发生什么

Analytics 还有一个小细节:如果你们组织用一个 GA4 属性同时采集五个网站的数据——这种情况并不少见,通常是几年前有人设置了跟踪代码后就一直没有拆分——连接依然可以正常工作,但每次查询都会在后台按主机名进行过滤。这不是一个可以勾选的选项,也不是任何人能不小心关掉的东西。这也是为什么仪表盘上始终只显示这个域名的数据,而绝不会显示该属性的总数据。

为什么这个保证很重要:它是在查询层面强制执行的,而不是由某个可以被取消勾选的设置来保证的。如果你在运营一个代理商仪表盘,一个客户看到另一个客户的流量数据可不是小麻烦——那是无法挽回的信任破裂。

两个连接都建立之后,同步会按你设定的日程每天运行(参见日程章节),平台上构建的任何内容都会自动关联对应的商店数据分析。域名行会显示待处理、部分完成或已激活状态——「部分完成」意味着两个连接中有一个已生效而另一个没有,这提示你应该去检查哪张卡片是红色的,而不是只信任汇总状态。

实际出问题的地方

我见过的工单几乎都属于三类,没有一种是罕见情况。第一:服务账号密钥本身有效,但绑定的 Google Cloud 项目不对,所以密钥虽然能上传成功,权限检查却一无所获。第二:没有人真正把服务账号的邮箱地址添加进去——类似这样 [email protected] ——作为查看者身份出现在 Search Console 或 GA4 自己的访问设置中;把密钥上传到平台并不会在 Google 那端为其授予任何权限。第三种更隐蔽的情况:某个域名在旧服务账号被删除后重新绑定到新的服务账号,但计划任务却在使用过期凭据的情况下悄悄失败了一整周,直到有人发现数据不再更新才注意到。

这些都不是平台故障——它们只是一个机器人账号需要在两个独立的 Google 产品上分别获取权限所带来的常规成本,而 Google 自己的模式并没有把这一点讲清楚。为你的第一个域名预留十五分钟,而不是流程暗示的两分钟。之后每个域名都会很快,因为凭据和操作经验都可以沿用。

手册
分享XLinkedInFacebookRedditQuoraWhatsAppTelegram邮箱
← 所有文章