追踪代码：如何在您的网站上安装 statpx 追踪

在 statpx 的任何仪表盘能够向您展示数据之前，您的网站需要先安装追踪代码。追踪代码页面（snippet.php）就是您获取代码、验证其是否正常工作，并控制可选品牌徽章的地方——按网站单独设置，因为每个网站都有自己独一无二的追踪 ID。

获取追踪代码

打开某个网站，点击侧边栏中的追踪代码。您会看到该网站专属的两行代码块：

第一行设置了两个全局变量：window._stid（您网站的追踪 ID）和 window._stendpoint（track.js 发送数据的目的地）。第二行加载 track.js 本身，采用异步方式，绝不会阻塞页面渲染。将这两行代码粘贴到 </head> 或 </body> 之前均可——因为无论加载顺序如何，track.js 都会等待这些全局变量就绪。如果您使用模板系统或 CMS，只需将其添加到全局布局中一次，每个页面就会自动继承。

验证安装

添加追踪代码并亲自访问一次您的网站后，返回追踪代码页面并点击验证安装。statpx 会抓取您的网站，检查脚本是否存在且配置正确，然后报告成功或未能找到的具体原因——例如追踪 ID 不匹配，或脚本完全缺失。如果验证失败，请仔细检查追踪代码是否已上线到实际页面（而不仅仅是暂存副本），以及是否有广告拦截器或 CSP 规则剥离了该脚本。

一旦某个网站通过验证，statpx 还会在后台定期重新检查，并在追踪代码停止响应时通知您——例如网站改版时不小心遗漏了它。

SPA 支持

track.js 会自动拦截 history.pushState 调用，因此使用 React、Vue 或类似框架构建的单页应用可以在客户端路由切换时获得准确的浏览量追踪，无需任何额外配置——不需要在每次导航时手动触发事件。有关这一机制如何运作，以及在某些边缘情况（例如基于模态框的"页面"）下您可能仍需要手动调用浏览事件的更深入介绍，请参阅追踪单页应用。

可选徽章

在追踪代码下方，一个复选框可以让您切换一个附加到代码上的"Analytics by statpx"小徽章。这是一个指向 statpx 的 do-follow 链接，保持启用是帮助 statpx 保持免费的方式之一——完全可选，切换它会实时更新代码块，方便您复制想要发布的确切版本。

常见错误

• 复制了旧的追踪 ID。 每个网站都有自己独一无二的 ID——把一个网站的追踪代码粘贴到另一个网站的页面上，会把那部分流量归属到错误的网站。
• 只在部分页面安装。 如果追踪代码只出现在首页模板中，其他所有页面都不会被追踪。应将其添加到共享布局中，而不是单个页面。
• 从不运行验证安装。 这只需要几秒钟，却能立即发现安装问题，而不是等到几天后才注意到仪表盘是空的。

总结

追踪代码页面是每个 statpx 功能都依赖的一次性设置步骤：粘贴两行脚本、验证，即可开始追踪。SPA 支持和可选徽章补充了细节，但核心步骤设计得很简单。安装并验证完成后，直接前往实时页面确认您的第一次访问是否到达，然后随着数据积累转向统计页面。