TapCub 正式上线:统计、分析、客服一个平台免费用
帮助中心

怎么统计自定义事件?

用 tapcub.track(name, props) 发送自己的事件。调用方式、脚本加载前怎么排队、命名规则、属性限制,以及事件在哪里看。

数据分析1 分钟阅读最后更新 2026 年 11 月 4 日TapCub 团队所属指南: 全埋点与 AI 事件收件箱

还有其他问题?

没找到答案?每条消息都有真人阅读,工作日通常几小时内回复。

在线咨询

简短回答

脚本加载后调用 tapcub.track(name, props),加载前就推进 window.__tcq 队列。名称用 snake_case、不超过 40 个字符,最多 20 个字符串、数字或布尔属性。事件在「网站统计 → 事件」里看。

调用方式

页面上有了 TapCub 脚本后,用一个名称和可选的属性发送事件:

tapcub.track('signup', { plan: 'pro' });

如果你的代码可能在脚本加载之前执行,就先推进队列。脚本一启动,排队的调用就会发出去:

<script defer src="https://static.pathclue.com/client.js" data-site="YOUR_SITE_KEY"></script>
<script>
  window.__tcq = window.__tcq || [];
  window.__tcq.push(['track', 'signup', { plan: 'pro' }]);
</script>

调用失败也不会在你的页面上抛错。

命名规则

  • 要登记进事件目录的名称,用 snake_case、以字母开头、不超过 40 个字符:signup、add_to_cart、video_play。
  • 不要以 $、_ 或 tc_ 开头,这些是保留前缀。以双下划线开头的名称给自动事件用。
  • 事件一旦在用,就不要改名。名称是数据里的键,要改就改显示名。
  • 网站、App 和小程序上的同一个动作用同一个名称,全端分析才能合在一起看。

属性限制

限制值
每个事件的属性数20 个键
键的长度50 个字符
字符串值的长度200 个字符
值的类型字符串、数字、布尔

超长的名称和值会在浏览器里截断,事件照样发送。对象和数组不会作为值保存。只加你会用来筛选或拆分的属性,绝不要把姓名、邮箱这类原始输入放进去。

采集端会丢掉一秒内完全相同的重复(同一访客、页面、名称和属性),所以双击不会算两次。

在哪里看事件

新事件会出现在 网站统计事件,带次数、独立访客和 7 天趋势。要命名、加说明或隐藏,用 全端分析数据管理事件收件箱 的事件定义页签。拆分和公式用事件分析。审核名称见怎么审核事件候选。

金额和订单

购买和其他金额从服务端发送,不要从浏览器发,这样关掉页面或被拦截都不会丢。见开发者文档。

确认能用

在线上网站亲自做一次这个操作,然后打开 网站统计实时,几秒内就会看到这个事件。总数和属性在 网站统计事件。

另见:追踪按钮点击、埋点方案。

这篇回答解决你的问题了吗?

我们会根据反馈修改和补充这篇内容。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie