将 Google Search Console 连接到 Atoms 项目，以便在 Marketing 中查看该项目已发布网站的搜索效果和索引信息。

本指南说明如何授权正确的 Google 账号、为您的线上自定义域名连接或添加对应的 property、根据其 property 类型选择正确的验证方法、确认连接已成功，以及提交站点地图。

连接如何工作

Google Search Console 会将网站数据组织在一个 property 中。连接 Search Console 时，Atoms 会先授权一个 Google 账号，然后查找与当前 Atoms 项目所使用的自定义域名相匹配的 property。

连接分为 2 个阶段：

1. 授权 Google 账号。 使用一个能够访问或验证线上站点 Search Console property 的账号。
2. 匹配并验证 property。 当现有已验证的 property 与线上自定义域名匹配时，Atoms 会自动连接它。如果站点缺失或尚未验证，请先添加或验证后再完成连接。

property 连接后，Performance 和 Operations 可以显示 Search Console 返回的数据。这些视图并不描述 Sarah 生成了什么内容，而且 Sarah 进行 SEO 内容规划或创建也不需要此连接。

开始之前

在连接 Google Search Console 之前，请确保：

• 网站已发布到线上自定义域名。默认的 Atoms 地址不能用于此 Search Console 工作流。
• 您无需登录即可打开线上首页。
• 您拥有一个可以访问现有匹配的 Search Console property 或可以验证新 property 的 Google 账号。
• 您的浏览器允许来自 Atoms 的 Google 授权弹窗。
• 您有权限管理项目集成。如果连接控件不可用，请让工作区所有者或拥有此权限的管理员完成连接。

若要使用最短的自动验证路径，请使用 URL-prefix Search Console property，并通过用户授权流程连接线上站点所使用的 GA4 property。两个服务请使用同一个 Google 账号，并确保该账号对 GA4 property 具有 Edit 访问权限。此路径不适用于 Domain property，也不适用于由 Atoms 自动管理的 Analytics 设置。请参阅 连接 Google Analytics 4。

如果您需要自定义域名，请参阅 连接和管理域名。

切勿将 Google 密码、验证码、DNS 值、访问 Token 或其他凭据粘贴到聊天中。

连接 Google Search Console

打开 Search Console 连接器

1. 打开已发布网站对应的 Atoms 项目。
2. 在项目工具栏中选择 Marketing，然后打开 Operations。如果某个 SEO 任务已经完成，且 Overview → Marketing → SEO 显示 Open Dashboard，您也可以选择它作为进入同一报告区域的快捷方式。
3. 如果 Atoms 显示 Manage Domains，请先连接并验证自定义域名，然后再继续。
4. 选择 Connect Search Console。

授权 Google 账号

1. 在 Google 授权窗口中，登录可访问或验证该自定义域名对应 property 的 Google 账号。
2. 检查是否已选择正确的 Google 账号。
3. 查看 Atoms 请求的访问权限。仅在您同意时继续。
4. 返回 Atoms，并等待授权步骤完成。

如果浏览器阻止了 Google 授权窗口，请选择 Open authorization page 并在新标签页中继续。您也可以为 Atoms 允许弹窗后重试连接。

为您的自定义域名连接 property

授权后，Atoms 会查找与项目线上自定义域名匹配的 Search Console property。

• 如果存在匹配且已验证的 property： Atoms 会自动连接它。继续前往 检查连接是否成功。
• 如果找不到域名： 选择 Add site in Atoms。这会为当前自定义域名创建一个 URL-prefix Search Console property；不会再创建另一个 Atoms 网站。
• 如果找到了站点但尚未验证： 请使用下面的其中一种验证方法。

在选择验证方法之前，请先确认 property 类型。URL-prefix property 会区分 http 和 https，也会区分 example.com 与 www.example.com 等主机名。Domain property 会覆盖其协议和子域名，并且必须通过 DNS 进行验证。

验证站点

如果 Atoms 找到了站点，但显示其尚未验证，请选择与 property 类型匹配的方法。对于 URL-prefix property，仅当满足下方资格条件时才使用 Google Analytics；否则请使用手动方法。对于 Domain property，请完成 Google DNS 验证。

通过 Google Analytics 验证

仅当 URL-prefix property 的线上站点已使用 GA4、该 GA4 property 是由您在 Atoms 中连接的，并且同一个 Google 账号对该 Analytics property 具有 Edit 访问权限时，才可使用此路径。此路径不适用于 Domain property，也不适用于由 Atoms 自动管理的 Analytics 设置。

1. 在 Atoms 中选择 Analytics 标签。
2. 按照 连接 Google Analytics 4 中的步骤，使用线上站点对应的 GA4 property 完成连接。
3. 返回 Search Console 设置页面。
4. 选择 Refresh。
5. 当该选项可用时，选择 Auto Verify via Google Analytics。
6. 等待 Atoms 确认验证结果。

Google Analytics 验证还要求首页可公开访问，并带有受支持的 Analytics 标签。如果任一条件不满足，请使用相应的手动方法。请参阅 Google 的 站点所有权验证指南。

截图中显示了 Analytics 链接、Refresh、Auto Verify via Google Analytics 和手动验证链接。只有在满足上述 URL-prefix 和 Analytics 资格条件后，Auto Verify via Google Analytics 才会变为可用。

先连接 GA4 以进行自动验证，或手动验证站点

在 Google Search Console 中手动验证

1. 选择 Verify manually in Google Search Console。
2. 在 Google Search Console 中，为该 property 类型选择一种验证方法。对于 Domain property，请使用 Google 显示的 DNS 方法。对于 URL-prefix property，请使用 Google 提供且您能够完成的任意方法。
3. 按照 Google 的说明完成操作。可用方法取决于 property 类型以及您对网站或域名拥有的访问权限。
4. 返回 Atoms 并选择 Refresh。
5. 确认域名显示为 Verified in Google Search Console。

连接成功后，请勿删除验证文件、标签、DNS 记录或其他验证 Token。Google 之后可能会再次检查该 Token。

检查连接是否成功

1. 打开 Marketing → Performance。
2. 确认页面显示已连接的自定义域名以及 Search Console 报告布局。
3. 打开 Operations，并确认站点地图和已索引页面区域可用。
4. 如果该 property 是新建的，请稍后再回来查看数据。

Atoms 中的 Search Console 效果数据通常会延迟 2–3 天。因此，在 Google 开始收集或返回数据期间，已连接的仪表板可能会显示零值或 No data available。

查看 Search Console 效果数据

本指南中的 Analytics 和 Performance 截图出于隐私原因使用了虚构或打码处理的域名、查询和指标；Operations 截图根据已批准的例外情况，出于隐私原因有意裁剪了站点地图细节。您的数值可能会有所不同。

查看站点地图和已索引页面状态

提交站点地图

Atoms 仪表板可以从 Search Console 读取站点地图信息，但不会替您提交站点地图。若要通过 Google 的 Sitemaps 报告提交，您的 Google 账号需要拥有该 Search Console property 的所有者权限。

1. 确认 https://your-domain.com/sitemap.xml 无需登录即可打开、可被公开抓取、包含新的线上页面地址，并且使用的是自定义域名。
2. 为已连接的 property 打开 Google Search Console。
3. 打开 Sitemaps，并按照 Google 显示的字段提交线上站点地图地址或 /sitemap.xml。
4. 稍后返回并检查提交结果。

如果站点地图缺失、未包含新页面，或使用了占位域名，请让 Alex 修复并发布更正后的构建，然后再提交。有关 Google 的说明，请参阅 Sitemaps 报告指南。

常见问题

问题	处理方法
Google 授权窗口未打开	选择 Open authorization page，为 Atoms 允许弹窗，然后重试。
连接了错误的 Google 账号，或访问权限已被撤销	打开项目的连接器设置，断开 Search Console，然后使用正确的 Google 账号重新连接。
property 缺失或不匹配	检查线上站点的准确协议和主机名。选择 Refresh；如果不存在匹配的 property，请选择 Add site in Atoms 以创建 URL-prefix property。
连接控件不可用	确认您可以管理项目集成。否则，请让工作区所有者或拥有该权限的管理员完成连接。
验证失败	确认 property 类型。仅对符合条件的 URL-prefix property 使用 Google Analytics；对 Domain property 使用 DNS 方法。在 Google 中完成该方法后，返回 Atoms 并选择 Refresh。
仪表板没有数据	确认已连接的 property 与线上自定义域名匹配。Search Console 数据通常需要 2–3 天才会显示，但新添加的网站最多可能需要一周才会生成数据。
Google 报告站点地图错误	在 Search Console 中打开错误详情。确认站点地图可公开访问、使用线上自定义域名，并包含预期的线上页面地址。

如果问题仍然存在，请联系 Atoms Support，并提供项目、线上域名、失败阶段、可见错误、大致时间以及打码后的截图。请勿包含密码、验证码、DNS 值、访问 Token 或其他凭据。

有关 SEO 工作流以及如何解读 Performance、Operations、URL Inspection 和 Page Speed 的指导，请参阅 SEO 智能体。