埋点方案通常卡在起名,而不是写代码。本文给出一套站得住的事件命名规范、悄悄破坏规范的常见错误,以及 TapCub 事件收件箱怎样把自动采集的交互变成候选,由你按自己的规则接受、合并或忽略。
读完你会知道
- 六条规则:对象_动作、过去式、snake_case、变体放属性
- 会把数字拆散的命名错误,以及每种的改法
- 收件箱怎么建议名字,以及为什么每个仍要有人确认
本次更新 · 2026 年 11 月 3 日
改写为事件命名规范指南:六条规则、常见错误表,以及收件箱现行流程(接受、合并、忽略)。
事件命名规范:埋点方案卡在哪里我们建议的规范破坏规范的常见错误事件收件箱怎么起草名字接受、合并或忽略自动采集不记录什么让事件词表保持干净常见问题
事件命名规范:埋点方案卡在哪里
本节新增
事件命名规范听上去像整理杂物,直到你要搭一个漏斗。问一个埋点方案做了一半的团队卡在哪,答案通常是那张表:四十行待定事件,一半有三种叫法,等着开会定。自动采集让埋点不再依赖工程师,但问题只是挪了个地方:数据都在,名字却是一串带着「免费开始」字样的按钮选择器,没人愿意拿 CSS 选择器搭漏斗。
规范解决的是那场会:规则写下来以后,给事件起名就是查表,而不是辩论。本文给出我们建议的规则、最常破坏规则的错误,以及 TapCub 事件收件箱怎样根据自动采集的交互起草名字,让你审核而不是从零发明。
我们建议的规范
本节新增
选定一种结构并坚持。Segment 的建议流传很广:用「对象 + 动作」结构(如 Blog Post Read),选定规范后坚持使用,事件名里不放具体值,值放进属性(Segment 文档)。Segment 的事件名用首字母大写;TapCub 要求注册的事件名用 snake_case,同样的意思写成 blog_post_read。具体规则:
- 对象在前、动作在后。
signup_completed、plan_selected、demo_requested。按名字排序时,同一对象的事件自然排在一起。 - 动作用过去式。 事件记录的是已经发生的事:
completed,不是complete。 - snake_case,字母开头,不超过 40 个字符。 这是 TapCub 事件目录对名字的要求;另外不能以
$、_或tc_开头,$留给 App 预置事件,双下划线留给自动采集。 - 变体放进属性。 一个
plan_selected事件加一个plan属性,而不是pro_plan_selected和vip_plan_selected两个事件。 - 各端同名。 网站、App、小程序上的同一个动作用同一个名字,全平台分析才能合在一起看。
- 上线后不改名。 TapCub 里事件名创建后不能修改,显示名称可以改。名字定一次,措辞上的调整放在显示名称里。
下面的调用符合这套规范:
// 对象_动作,snake_case,过去式;变体放进属性
tapcub.track('signup_completed', { method: 'email' });
tapcub.track('plan_selected', { plan: 'pro', billing: 'yearly' });
tapcub.track('demo_requested', { source_page: '/pricing' });
// 不要:'Clicked Start Free Button'、'signup-v2'、'pro_plan_selected'、'tc_signup'破坏规范的常见错误
本节新增
大多数混乱的事件词表不是一开始就乱,而是被几种反复出现的错误慢慢带偏。下表列出我们常见的几种和对应改法。
| 你会看到的名字 | 问题在哪 | 改成 |
|---|---|---|
| Clicked Start Free Button | 动词在前、有空格、用了会随文案变化的界面文字 | signup_started |
| signup / sign_up / SignUp | 一个动作三个名字,每个数字都被拆开 | 全端统一 signup_completed |
| pro_plan_selected | 变体写进名字,新增套餐就得新增事件 | plan_selected + plan 属性 |
| checkout_2026_q3 | 日期或活动写进名字 | checkout_started + campaign 属性 |
| button_click | 太笼统,所有按钮都是同一个事件 | 每个有意义的动作用 对象_动作 |
| tc_signup / _signup | 保留前缀,无法注册 | signup_completed |
事件收件箱怎么起草名字
本节新增
打开自动采集(控制台里叫全埋点)后,事件收件箱会在夜里整理前一天的交互;也可以点 立即生成候选。它按元素和页面把交互聚在一起,五个页面上的「免费开始」按钮会合成一个候选,并给出建议名称。建议名称旁的「规则圈选」或「AI 建议」标签只说明名字从哪来;旁边的次数是真实命中。
每个候选显示近 7 天的命中次数、访客数和最近出现时间。可以按高置信度、低置信度或「3 天未出现」筛选,按命中、访客或最近出现排序,展开一行看 7 天趋势、所在页面和前后动作。下面的示例来自演示项目。
事件收件箱 · 待处理候选
按近 7 天命中排序signup_started规则 · 按钮「免费开始」· 5 个页面2,318待处理plan_selectedAI · 按钮「选择专业版 / VIP」· /pricing1,104待处理docs_search_usedAI · 输入框「搜索文档」· /docs/*1,940待处理newsletter_subscribed规则 · 表单「newsletter」提交 · /blog286已接受demo_requested规则 · 表单「demo」提交 · /demo58已接受footer_social_clicked规则 · 链接 · 页脚 · 3 个目标72已忽略
接受、合并或忽略
本节新增
每个候选要做三选一的决定,在有人做决定之前,它都不是正式事件:
- 接受:按你的规范填事件名、显示名称、分类和描述。系统会创建匹配规则,并回填近 90 天的自动采集数据,今天搭的漏斗就有历史可看。
- 合并:把这个交互加进已有事件的匹配规则,比如第二个「免费开始」按钮也算作
signup_started。新增部分会回填。 - 忽略:候选移到「已忽略」,以后仍然可以接受。
收件箱负责建议,规范负责决定。把建议名称当草稿,接受前按上面的规则改好,因为名字定了就改不了。接受后的事件就是普通事件,和代码发送的事件一样可以用在漏斗、分群、目标和监控里。已经用 track() 发送的事件不会被收件箱的任何规则改名。生成、接受、合并和忽略需要分析师及以上角色。
自动采集不记录什么
本节新增
自动采集记录可点击的元素,不记录用户输入的内容。它不采集密码框、data-tc-ignore 区域内的任何内容和客服窗口。文本采集默认关闭,且只在采集等级为 3 时生效。表单跟踪只存表单的 id、name 和 action,不存字段值。需要某个值,比如订单金额或套餐名称,就用 track() 显式发送,由你决定哪些数据离开页面。完整清单见文档自定义事件与自动采集。
让事件词表保持干净
本节新增
规范没人看就会走样。三个习惯能让它保持下去:
- 每月看一次「未规划」列表。 用
track()发了但没注册的名字会显示为未规划。按规范注册,或者如果它不该存在,就把状态设为「已拦截」;不点接受并不会停止存储,只有 已拦截 才会。 - 用隐藏代替删除。 隐藏只是把名字从查询选择器里拿掉,可以恢复;删除会去掉定义和规则,但不会删已存储的事件。
- 埋点方案和收件箱放在一起用。 如果方案在表格里,就按已有名字接受和方案一致的候选,其余的当作方案原本不知道的交互。词表是拿来做什么的,见词条自动采集和转化漏斗优化清单。
常见问题
本节新增
好的事件命名规范是什么样的?
对象在前、动作在后,用 snake_case 和过去式,比如 signup_completed。套餐、来源这类变体放进属性,各端同名,上线后不改名。
事件名用 snake_case 还是首字母大写?
只要全程统一,哪种都行。TapCub 事件目录要求 snake_case,所以在这里用 snake_case,属性键也用 snake_case。
事件收件箱会自动创建事件吗?
不会。它给出候选,名字来自规则或模型。只有有人接受候选、或把它合并进已有事件之后,事件才存在。
接受候选后,历史数据怎么办?
接受会创建匹配规则,并回填近 90 天的自动采集交互,基于新事件的漏斗和趋势从一开始就有历史。
以后能给事件改名吗?
事件名不能改,创建后就固定了。可以改显示名称,或者隐藏旧名、注册新名,但基于旧名的分析不会自动迁移过去。
更新记录1
- 大改改写为事件命名规范指南:六条规则、常见错误表,以及收件箱现行流程(接受、合并、忽略)。
- 首次发布
这篇文章对你有帮助吗?
我们会根据反馈修改和补充这篇内容。
提交没有成功,请稍后再试。
谢谢你的反馈,我们会据此改进这篇内容。你已经反馈过这篇了,谢谢。




