自定义事件追踪：如何测量网站上的任何用户互动

发布于 2026年5月27日 • statpx 团队 • 7 分钟阅读 • 功能

标准分析自动追踪页面浏览量。但许多发生在你网站上最重要的事情并不是页面浏览——访客播放演示视频、点击你的定价 CTA、下载文件或提交表单。自定义事件让你追踪所有这些互动。

本指南解释自定义事件追踪如何工作、你可以用它追踪什么，以及如何用一行 JavaScript 将其添加到你的网站。

什么是自定义事件？

自定义事件是任何你明确定义和追踪的用户互动。 与每次页面加载时自动记录的页面浏览不同，事件必须有意触发——通常通过添加一小段 JavaScript 代码，在特定操作发生时激活。

事件有一个名称（发生了什么）和可选的类别（如何分组）。例如：名称 = demo_play，类别 = video。或者名称 = pricing_click，类别 = cta。这些标签完全由你决定——分析工具只是用时间戳记录它们并将其关联到当前会话。

你可以用事件追踪什么

几乎任何互动都适用。常见的用例包括：

参与度操作

视频播放 / 暂停 / 完成
打开手风琴或常见问题部分
在产品功能部分切换标签页
图库导航
复制按钮点击（代码片段、促销代码）

转化相关操作

CTA 按钮点击（"开始免费试用"、"预约演示"）
表单提交（通讯注册、联系表单）
文件下载（PDF 指南、白皮书）
指向外部注册页面的出站链接点击

导航信号

使用搜索框
在产品目录中应用筛选或排序
无限滚动到达新的内容"页面"

如何用 statpx 追踪事件

statpx 使用简单的 JavaScript 函数调用来记录自定义事件。一旦追踪代码片段在你的页面上，你就可以在你的任何 JavaScript 中触发事件：

// 基本事件 — 仅限名称
_st('event', 'demo_play');

// 带类别的事件
_st('event', 'pricing_click', 'cta');

// 附加到按钮点击
document.getElementById('demo-btn').addEventListener('click', function() {
  _st('event', 'demo_play', 'video');
});

第一个参数始终是 'event'。第二个是你的事件名称。第三个（可选）是你可以用来在事件选项卡中分组相关事件的类别字符串。

追踪出站链接点击

出站点击特别有用，因为它们代表访客离开你的网站——你想知道哪些外部链接被点击。这是追踪它们的一个模式：

document.querySelectorAll('a[href^="http"]').forEach(function(link) {
  if (!link.href.includes(location.hostname)) {
    link.addEventListener('click', function() {
      _st('event', 'outbound_click', link.hostname);
    });
  }
});

这为每次点击出站链接时触发事件，使用目标主机名作为类别。在你的事件选项卡中，你会看到访客点击了哪些外部网站。

在你的仪表板中读取事件数据

在 statpx 中，所有自定义事件都显示在事件选项卡中。对于每个事件名称，你会看到总出现次数、触发它的唯一会话、它被触发的页面以及每个单独事件的时间戳。出站表显示完整的旅程上下文——访客在哪个页面、他们去哪里、他们的位置和他们的设备。

事件直接与转化目标集成。你可以设置任何事件名称作为目标触发器——例如，如果你在成功注册后触发 _st('event', 'signup_complete')，你可以创建一个将该事件的每次出现都计为转化的目标，并随时间追踪它。

用 statpx 免费追踪按钮点击、表单提交等

一行 JavaScript。仪表板中的即时事件数据。无需配置屏幕、标签管理器或插件。

免费设置事件 →

事件 vs. 页面浏览：何时使用各自

经验法则很简单：对导航（加载新 URL）使用页面浏览，对发生在页面内的互动使用事件。如果用户点击加载应用中新路由的按钮，那可能是页面浏览。如果他们点击播放视频或提交表单而不重新加载页面的按钮，那就是事件。

对于用 React、Vue 或类似框架构建的单页应用（SPA），这种区别变得特别重要——阅读我们关于在 SPA 中追踪分析的指南，了解正确处理客户端导航的具体细节。

总结

自定义事件连接了"某人访问了一个页面"和"某人在该页面上做了有意义的事情"之间的gap。设置很小——一个单一的 JavaScript 调用，在操作发生的任何地方。一旦你有几个事件流入，模式会迅速浮现：哪些 CTA 被点击，哪些功能被使用，哪些内容推动对你业务最重要的操作。这是你可以直接采取行动的数据。