如何在您的网站上设置 Google Analytics 4

要设置 Google Analytics 4，请先在 analytics.google.com 创建账户和媒体资源，为您网站的网址添加网络数据流，并复制其衡量 ID（以 G- 开头）。然后将带有该 ID 的 Google 代码添加到每个页面的 <head> 中，发布网站，并检查「实时」报告。如果是单页应用，请确保页面在路由切换时触发页面浏览；如果您的访问者来自欧盟或英国，请将代码与同意横幅相连接。

GA4 能为您提供什么

Google Analytics 4（GA4）用于衡量访问者到达您的网站后的行为：有多少人访问、来自哪里（搜索、社交、邮件、广告）、查看了哪些页面，以及完成了哪些操作，例如注册、购买、提交联系表单。它将所有数据记录为事件；页面浏览只是一个名为 page_view 的事件。

GA4 免费、应用广泛，并可与 Google Ads 和 Search Console 相连接。其代价是复杂性、Cookie（在某些地区会带来同意要求），以及数据会传送给 Google。

您到底应不应该使用 GA4？

对于投放 Google Ads 的营销网站，GA4 通常是首选。对于只想统计访问人数的简单网站，注重隐私的工具往往更省事。对于应用内的行为，产品分析工具更为合适。如何为应用添加分析功能对这些方案做了更深入的比较。

分步操作

以下步骤遵循 Google 截至 2026 年 9 月的官方设置指南。GA4 的菜单名称偶尔会变化；如果标签有所不同，请在「管理」页面中搜索。

1. 创建账户

访问 analytics.google.com，点击开始衡量。输入账户名称（通常为您的公司名称），并选择数据共享设置。请使用您的企业将会长期保留的 Google 账户。

2. 创建媒体资源

媒体资源是一个网站或应用（或一组网站或应用），其数据会被一起报告。输入媒体资源名称、报告时区和货币，然后选择您的行业和业务目标。时区决定报告中「今天」从何时开始计算，因此请选择您所在的时区。

3. 添加网络数据流

选择网络，输入您网站的网址和数据流名称。保持增强型衡量处于开启状态：它会自动收集页面浏览、滚动、外部链接点击、网站搜索、表单互动、视频互动和文件下载，无需额外代码。

创建数据流后，其详情页面会显示您的衡量 ID，以 G- 开头。

4. 将 Google 代码添加到您的网站

GA4 会提供一段代码片段，以 `` 注释开头。Google 的说明是将其紧接在每个页面的开始 <head> 标签之后放置。大多数网站构建工具和内容管理系统都有填写衡量 ID 的字段，如果您的工具提供了这一字段，请直接使用它。对于 AI 构建的网站，可以这样请求：

添加衡量 ID 为 G-XXXXXXXXXX 的 Google Analytics 4。在每个页面的 head 中加载 gtag.js 代码片段，且仅在正式构建中加载 —— 不要在本地开发或预览中加载。这是一个单页应用，因此请确保每次路由切换都恰好记录为一次页面浏览。

如果您已经有或需要同意横幅，请在同一请求中一并说明（参见第 7 步）。

5. 检查单页应用中的页面浏览

许多 AI 构建的网站都是单页应用（SPA）：在页面之间切换时，网址会改变，但页面不会重新加载。在增强型衡量设置中，页面浏览选项有一个高级设置，即基于浏览器历史记录事件的页面更改 —— 它会监听 SPA 路由器产生的历史记录变化。开启此选项后，GA4 会自行记录 SPA 的导航。

常见的错误是重复计数：既使用基于历史记录的页面浏览，又从路由器手动发送 page_view。请二选一。可以通过在页面之间点击并观察「实时」报告或 DebugView 来检查。

6. 确认其正常工作

发布网站，在普通浏览器窗口中打开（广告拦截器通常会拦截 GA —— 可以尝试在没有拦截器的浏览器中打开），然后查看报告 → 实时。Google 表示数据收集可能需要长达 30 分钟才开始。标准报告的数据比实时报告需要更长时间才能填充完整。

7. 处理同意管理

在欧盟、英国及其他一些地区，分析类 Cookie 通常需要先获得访问者的同意。Google 的同意模式可以让代码尊重访问者的选择：您可以在代码加载之前设置默认值（例如将 analytics_storage 设为拒绝），然后在访问者做出选择时发送更新。对于来自欧洲经济区的流量，Google 的同意模式还需要 ad_user_data 和 ad_personalization 信号。如何添加 Cookie 同意更详细地介绍了横幅和同意模式。以上为一般性信息，不构成法律建议。

8. 设置关键事件

「关键事件」（2024 年前称为转化）是对您的业务至关重要的操作。当重要的事情发生时发送一个事件，然后将其标记为关键事件：在管理 → 事件中，点击该事件旁边的星标。截至 2026 年 9 月，标准媒体资源最多可以标记 30 个关键事件。

当用户完成注册时发送名为 sign_up 的 GA4 事件；联系表单成功提交时发送 generate_lead；已确认付款后发送带有 value 和 currency 的 purchase 事件。每次操作只发送一次，并且切勿在事件参数中包含姓名、邮箱或其他个人信息。

使用 Google 推荐的事件名称（如 sign_up、generate_lead、purchase），可以让某些报告自动填充。

9. 整理设置

• 数据保留：对于标准媒体资源，GA4 会将用户级和事件级数据保留 2 个月或 14 个月。这会影响探索分析，不影响标准报告。如果您希望进行同比探索分析，请选择 14 个月。
• 内部流量：将您办公室的 IP 地址定义为内部流量并进行过滤，以免您自己的访问影响数据。
• 关联 Search Console，以便在查看用户行为的同时查看搜索查询。
• 添加用户，使用他们自己的 Google 账户，并授予其所需的最低权限。

常见错误

• 部分页面缺少代码，因为只添加到了一个模板中。
• 单页应用中页面浏览被重复计数。
• 追踪开发和预览流量。 请仅在正式环境中加载代码。
• 事件或网址中包含个人数据。 Google 的政策禁止发送可识别个人身份的信息，例如邮箱地址；请注意网址查询字符串中的邮箱。
• 在需要同意的情况下，先于同意加载 GA；或者横幅中没有可以接受的选项，导致您根本收不到数据。
• 自定义事件过多，却没有人查看。 请只追踪能告诉您网站是否正常运作的五项操作。
• 使用个人 Google 账户，导致账户随设置人员离开而离开公司。

设置检查清单

• 账户和媒体资源已在企业 Google 账户下创建
• 已创建网络数据流，并开启增强型衡量
• 每个页面都有带正确 G- ID 的 Google 代码，且仅在正式环境中加载
• 在单页应用中，每次路由切换只记录一次页面浏览
• 「实时」报告中可以看到您自己的访问
• 在需要的地方，已通过同意模式连接同意横幅
• 已定义并标记关键事件
• 已设置数据保留、内部流量过滤器，并关联 Search Console
• 事件和网址中不包含个人数据

在 Mythex 上使用 Google Analytics

Mythex 不为您的应用提供自带的访问者分析功能；分析工具是您需要自行添加的，与其他第三方脚本无异（构建落地页将其列为需自备的工具）。将第 4 步中的提示词连同您的衡量 ID 粘贴到聊天中即可。由于 ID 是公开的，它可以放在前端代码中；所有真正的机密信息请保存在项目设置中（环境变量与机密）。Mythex 的新应用默认为单页应用，因此请检查第 5 步。然后再次发布 —— 代码只会在已发布的网站上收集数据。

常见问题