衡量单页应用

本文档适用于希望使用 Google Analytics 衡量单页应用中的网页浏览量的开发者。

单页应用 (SPA) 是指仅加载一次 HTML 文档，然后使用 JavaScript API 获取任何其他内容的网站。

示例：假设您有一个用于获取潜在客户的表单。该表单包含三个界面：

• 用于采集客户信息的第一个界面。
• 第二个界面，客户可在其中表明对特定服务的兴趣。
• 第三个屏幕页面，用于注册与客户兴趣相关的网络研讨会。

正确衡量 SPA 的网页浏览量的关键在于，统计用户互动的每个屏幕的网页浏览量，并正确获取网页引荐来源网址，以便正确跟踪用户历程。

准备工作

本页面假定您已具备以下条件：

• 适用于您网站的 Google Analytics 4 账号和媒体资源。了解如何设置 Google Analytics。

• 在网页首次加载时触发的 Google 代码。了解如何设置 Google 代码。

实现单页应用衡量

如需实现准确的 SPA 衡量，请使用以下方法之一来触发新的虚拟网页浏览：

• 浏览器历史记录更改（推荐）：如果您的 SPA 使用 History API（尤其是 pushState() 和 replaceState() 方法）来更新屏幕，请使用此选项。

• 自定义事件：如果您的网站使用 DocumentFragment 对象来呈现不同的屏幕，请使用此选项。

浏览器历史记录实现 自定义事件实现

浏览器历史记录更改实现

在 GA4 中启用增强型衡量功能

如需根据浏览器历史记录自动衡量 page_views，请执行以下操作：

1. 打开 Google Analytics

2. 在管理界面中，依次点击数据收集和修改 > 数据流 > 网站。

3. 在“增强型衡量功能”下，将开关滑动到开启，以启用所有选项。

4. 点击即可修改各个选项。在网页浏览量下，点击显示高级设置。请务必同时启用网页加载和根据浏览器历史记录事件判断的页面更改。

   

5. 保存所做的更改。

验证效果衡量设置

如需验证单页应用是否正确衡量网页浏览量，请执行以下操作：

1. 为 SPA 衡量设置中的每个代码启用调试模式。了解如何在 DebugView 中监控事件。

2. 点击单页应用。当您点击进入新的虚拟屏幕时，应该会在 DebugView 中看到新的 page_view 事件。将 page_view 事件参数与前面的 page_view 事件进行比较，以检查网页引荐来源网址和网页位置是否已正确更新。