将 Google Analytics 4 (GA4) 连接到你的 Atoms 项目，以跟踪网站流量并了解用户如何与你已发布的网站互动。

本指南将带你完成完整的设置流程：打开 GA4 连接、授权正确的 Google 账号、为你的线上网站选择相应的属性、发布跟踪更新、确认数据正在被收集，以及为之后进行 Google Search Console 验证准备好该连接。

GA4 连接的工作方式

GA4 属性 是 Google Analytics 中用于收集和报告网站或应用数据的资源。Atoms 会使用你授权的 Google 账号来查找该账号可访问的 Analytics 账号和属性。请为你当前的 Atoms 项目连接已发布网站所使用的属性。

设置分为三个部分：

1. 授权一个 Google 账号。 登录可访问正确 GA4 属性的账号，并批准所请求的 Google 权限。
2. 连接匹配的属性。 选择你的项目线上网站所使用的 Analytics 账号和 GA4 属性。
3. 添加跟踪设置、发布并检查报告。 等待 Atoms 添加跟踪配置，检查并发布更新后的网站，然后确认已连接正确的属性且正在接收数据。

GA4 连接与 Sarah 的 SEO 内容工作流是分开的。Sarah 无需 GA4 也可以规划并生成 SEO 页面。该连接用于 Analytics 报告。

如果满足 Google 的要求，由用户授权的 GA4 连接还可以在你之后连接 Google Search Console 时支持自动网站验证。

开始之前

在连接 Google Analytics 4 (GA4) 之前，请确保：

• 你是 项目所有者。其他协作者可能可以查看项目，但只有所有者可以管理其 GA4 连接。
• 你拥有一个可访问你网站所用 GA4 属性的 Google 账号。
• 你知道哪个 GA4 属性属于已发布的网站。如果多个属性名称相似，请先在 Google Analytics 中检查网站或网页数据流。
• 你的网站已经生成，并且已发布或准备发布。如果 Marketing → Analytics 提示你先开始构建网站，请先完成生成后再继续。
• 你的浏览器允许来自 Atoms 的 Google 授权弹窗。
• 在你更改 Marketing 连接之前，当前任何 Sarah 或 Alex 任务都已完成。

你可以在自定义域名上线前连接 GA4。不过，在 Analytics 报告出现之前，你已发布的网站必须先向已连接的属性发送数据。

如果你计划使用 GA4 来帮助在 Google Search Console 中验证你的网站，请对这两个连接使用同一个 Google 账号。该账号还必须对 GA4 属性拥有 编辑权限。

如果你无法访问该属性，请让其 Google Analytics 管理员授予你所需的访问权限。请参阅 Google 的 Analytics 用户访问指南。

如果你的 Google 账号尚未拥有 Analytics 账号、属性或网页数据流，Atoms 可能会在设置过程中引导你创建。你也可以直接在 Google Analytics 中使用 Google 的 网站 Analytics 设置指南 创建这些内容。

Google Analytics 权限： 使用可访问此网站对应 Analytics 账号和 GA4 属性的 Google 账号。选择现有属性或网页数据流需要对该资源具有访问权限。在设置中创建 Analytics 账号、GA4 属性或网页数据流，则需要在相应 Analytics 层级拥有 Editor 权限（或同等权限）。如果某个资源缺失，或你没有所需权限，请让 Analytics 管理员先在 Google Analytics 中授予访问权限或创建该资源，然后返回 Atoms 并选择 Refresh。

切勿将 Google 密码、验证码、访问令牌或其他凭据粘贴到 Chat 中。

连接 Google Analytics 4

打开 GA4 连接器

1. 打开你想要衡量其已发布网站的 Atoms 项目。
2. 在项目工具栏中选择 Marketing。
3. 打开 Analytics。如果你从 Overview 开始，也可以在 Marketing 下找到 Analytics 卡片并选择 Set up Analytics。
4. 选择 Authorize GA4。这一步会授权 Google 账号；你将在后续步骤中连接属性。

从 Marketing 授权 Google Analytics 4

授权 Google 账号

1. 在 Google 授权窗口中，登录可访问此网站对应 GA4 属性的 Google 账号。
2. 检查是否已选择正确的 Google 账号。
3. 查看 Atoms 请求的访问权限。仅在你同意的情况下继续。
4. 返回 Atoms 并等待授权步骤完成。

如果浏览器阻止了授权窗口，请允许 Atoms 的弹窗后重试。如果 Atoms 提供 Open authorization page，请使用它在新标签页中继续。

为线上网站连接属性

在你授权 Google 账号后，Atoms 会显示你可访问的 Google Analytics 账号和属性。接下来你看到的内容可能会因与你账号关联的 Analytics 资源数量不同而有所变化。

1. 如果 Atoms 要求你选择一个 Analytics 账号，请选择包含你网站属性的那个账号。
2. 选择你的已发布网站所使用的 GA4 属性。如果你不确定该选哪一个，请先在 Google Analytics 中检查该属性。
3. 如果出现 网页数据流，请确认它使用的是正确的线上网站地址。
4. 选择 Connect property。
5. 保持页面打开，直到 Atoms 确认连接完成。

如果 Analytics 设置中缺少某一部分：

• 没有 Analytics 账号： 如果可用，请选择 Let Atoms create it for you fast，完成 Google 设置后返回 Atoms 并选择 Refresh。
• 没有 GA4 属性： 选择正确的 Analytics 账号，然后选择 Create property in Atoms 并等待新属性出现。
• 没有网页数据流： 选择该属性并在 Create web stream 下选择 Quick Create，或在 Google Analytics Admin 中手动创建一个。

如果本应已存在的账号、属性或数据流没有显示，请检查你是否使用了正确的 Google 账号并且拥有访问权限。如果它是最近才创建或共享给你的，请稍等片刻后选择 Refresh。

连接线上网站所使用的 GA4 属性

完成跟踪更新并发布

仅连接 Google 资源本身并不会让已发布的网站开始收集数据。在 Atoms 确认属性连接后，它会启动一个项目任务，将 Analytics 跟踪配置添加到网站中。

1. 等待跟踪任务完成。在更新运行期间，避免启动其他构建或 Marketing 任务。
2. 检查已完成的更改并预览网站。确认网站仍能正常加载且行为符合预期。
3. 发布更新后的项目。如果网站已经上线，请确保当前发布的是最新更新后的版本。
4. 在新标签页中打开已发布的首页，并像平常一样使用网站以生成一次测试访问。
5. 返回 Marketing → Analytics 检查连接状态，并在 Google 处理完该访问后检查报告状态。

预期结果： Atoms 会显示目标属性已连接，跟踪更新已存在于已发布版本中，并且线上网站开始向该属性发送新的活动数据。连接 GA4 不会为开始收集之前发生的活动创建历史数据。

检查连接是否成功

1. 返回 Marketing → Analytics。
2. 确认 Google Analytics 4 设置中不再显示初始连接提示。
3. 检查已连接的账号或属性是否与线上网站匹配。
4. 如果 Analytics 报告区域可用，请打开它并选择最近的日期范围。
5. 如果网站是新的，请访问已发布的网站，稍后再回来检查是否有已处理的数据。

报告为空并不一定意味着授权失败。请将“已连接属性状态”和“报告状态”视为两个独立的检查点。确认跟踪任务已完成、更新后的版本已发布，并且同一个属性正在接收来自线上网站的事件。Google 指出，许多标准 GA4 报告在开始收集后可能需要 24–48 小时才会填充；如果你需要更早检查收集情况，请使用 Google Analytics Realtime。请参阅 Google 的 数据收集验证指南。

在 GA4 数据可用后查看 Analytics 报告

从失败的 GA4 连接中恢复

请根据失败的状态来选择下一步安全操作。授权失败或资源列表加载失败，通常需要重新打开授权窗口、使用正确的 Google 身份，或在获得访问权限后刷新。属性已连接但没有报告数据，则需要在重试连接前先检查跟踪任务和发布情况。

• 授权或账号加载失败： 允许弹窗，如果提供了 Open authorization page 则重新打开它，确认目标 Google 身份，然后重试一次。
• 缺少账号、属性或数据流： 确认拥有所需访问权限以及用于创建的 Editor 权限，然后在最近创建或共享的资源可用后选择 Refresh。
• 属性已连接但跟踪或报告失败： 等待跟踪任务完成，预览并发布最新版本，确认已连接的属性与线上网站匹配，并在重试前使用 Google Analytics Realtime 或参考文档说明的报告延迟时间。

如果同一阶段在重试一次后仍然失败，请联系 Atoms Support 或你的工作区管理员。请提供项目名称、已连接的属性名称（如果有显示）、失败阶段、可见的状态或错误文本、大致时间以及已打码的截图。切勿包含密码、验证码、访问令牌、OAuth 代码或其他凭据。

将 GA4 与 Google Search Console 配合使用

基于 Google Analytics 的 Search Console 验证是有条件的。在 Atoms 中，Auto Verify via Google Analytics 需要符合条件的、由用户授权的 GA4 连接。由 Atoms 创建的托管式 GA4 设置无法使用此自动验证操作。如果你使用 Google 的手动验证方法之一，则不需要 GA4。

要在 Search Console 中设置并验证你的网站，请参阅 Connect Google Search Console 了解完整步骤和要求。

Google 的 Analytics 验证方法还要求公开的首页中包含受支持的 Analytics 标签，并且适用于 URL 前缀类型的 Search Console 属性，而不是 Domain 属性。如果由于 GA4 设置由 Atoms 托管，或未满足任何 Google 要求而无法进行自动验证，请继续使用 Verify manually in Google Search Console。请参阅 Google 的 网站所有权验证要求。

有关相关内容和报告工作流，请参阅 SEO 智能体。