Ptengine在SPA网站中的测量配置指南

Ptengine在SPA网站中的测量配置指南

什么是SPA页面？

SPA是单页应用程序（Single Page Application）的缩写。

为了优化内容传递速度并提高整个网站的性能，越来越多的网站开始采用SPA。

为什么SPA页面的测量需要特殊处理

由于SPA使用与传统网站不同的方式加载内容，常规的测量方法无法自动检测到SPA页面内容和URL变化，这影响了对用户行为的正确分析。Ptengine使用标准基础标签时也无法正确测量SPA页面，需要特殊处理。

解决方法是配置Ptengine SPA专用标签，当页面内容更改时触发该标签，将更新后的页面URL等信息发送给Ptengine，从而正确进行测量。具体的配置方法如下所示。

实现逻辑说明

Ptengine基础标签在SPA页面加载后，在页面变化的瞬间通过"router change"函数调用Ptengine的SPA专用标签。

Google Tag Manager（以下简称GTM）可以轻松识别历史记录的变化，因此建议将其设置为触发器。当然，也可以手动配置，但需要技术团队的协助。

警告：

如果页面内容改变但URL不变，可以使用以下标签生成演示URL，然后用新URL测量数据。请注意，无法使用GTM，需要进行手动配置。有关"URL/#位置信息"的详细信息，请参考此文档中的setPVTag部分。

window._pt_sp_2 && window._pt_sp_2.push('setPVTag,URL/＃所情報,replace');

GTM配置方法

1. 在设置了基础标签的GTM容器中创建新标签。

2. 设置标签名称后，选择"自定义HTML"，输入以下标签，将触发器设置为"历史记录变化"并保存。

window._pt_sp_2 && window._pt_sp_2.push('setPVTag,'+ location.href +',replace');

1. 确认没有问题后，点击"发布"按钮进行发布。

手动配置方法

也可以手动触发setPVTag，如果要手动配置，请在页面更改的瞬间通过"router change"函数调用Ptengine的SPA专用标签，将以下标签添加到页面逻辑中。

window._pt_sp_2 && window._pt_sp_2.push('setPVTag,'+ location.href +',replace');

如果页面内容改变但URL不变，请使用以下标签。有关"URL/#位置信息"的详细信息，请参考此处文档中的"setPVTag"部分。

window._pt_sp_2 && window._pt_sp_2.push('setPVTag,URL/＃所情報,replace');