告诉我们要追踪什么：你的自定义事件需求表

你知道店铺需要埋点。你知道想要衡量什么——Newsletter 订阅、视频播放、批发询价。但当我们问「你需要哪些事件？」时，答案通常是「呃……所有？」这个工具就是来解决这个问题的。填好下面的表单，你会得到一份干净、结构化的需求表，告诉我们到底要建什么。

为什么我们需要这个

每次自定义埋点搭建都从同样的对话开始：

我们：「你想追踪什么？」
你：「呃……用户订阅 Newsletter 的时候？还有他们看视频的时候？」
我们：「好，这些事件应该叫什么名字？应该携带什么数据？」
你：「……我不知道，你们是专家啊？」

这样的来回可能要好几天。下面的需求表把它压缩到 15 分钟。你告诉我们发生了什么和在哪里发生，技术翻译我们来处理。

事件命名规则

在开始填表之前，先了解我们遵循的命名规则：

1. 全小写 + snake_case —— newsletter_signup，不是 Newsletter-Signup 或 newsletterSignup
2. 动词/名词短语 —— add_to_cart，不只是 cart
3. 不许空格与中文 —— product_view，不是 product view 或 产品浏览
4. 优先复用标准事件 —— 如果 GA4/Meta/TikTok 已经有标准事件（比如 add_to_cart），就用那个名字。标准事件覆盖不了才造自定义事件。

不确定标准事件在每个平台叫什么？看完整的事件对照表 →

构建你的事件需求表

填写下面的表单。你的工作会自动保存在浏览器里（localStorage）——如果你关掉标签页稍后再回来，内容还在。填完后，点击复制 Markdown 粘贴到邮件或微信，或点击下载 CSV 保存为表格。

注意： 这是一个演示工具。你输入的任何内容都不会上传到服务器——它只存在你的浏览器里。如果你清除浏览器缓存或换设备，你的工作会丢失。离开前记得复制或下载。

更喜欢用 Excel？

如果你更习惯用 Excel 填写，下载我们的模板：

下载事件需求表模板（Excel）

模板包含：

• 预填示例（Newsletter 订阅、视频播放、批发询价、加购）
• 命名规则参考页
• 空白行供你填写自定义事件

填好后通过邮件或微信发给我们。

接下来会发生什么

你把需求表发给我们之后，我们会这样做：

1. 审查 —— 检查命名冲突、缺失参数、平台兼容性
2. 映射 —— 把你的事件翻译成平台特定的实现（GA4 generate_lead、Meta Lead、TikTok Subscribe 等）
3. 搭建 —— 实现追踪代码，在每个平台的调试工具里测试，验证触发正确
4. 交付文档 —— 你会得到最终需求表，附带截图展示每个事件在 GA4 DebugView、Meta Events Manager、TikTok Events Manager 里的触发情况

从需求表到上线，整个流程通常 2-3 天。

你的店铺是 headless 架构？实现方式不同——看 headless 追踪的变化 →

示例

这是过去项目中的四个真实示例：

#	触发时机	页面/位置	事件名	参数	发送平台	类型	验收标准
1	点击「订阅 Newsletter」按钮成功	首页弹窗	newsletter_signup	page, source	GA4 + Meta (Lead)	自定义	Events Manager 可见 Lead 事件
2	视频观看超过 50%	产品页	video_play_50	video_id, product_id	GA4	自定义	DebugView 可见
3	批发询价表单提交	/wholesale	wholesale_inquiry	form_id, product_count	GA4 + Meta (Lead)	自定义	转化测试通过
4	加购	全站	add_to_cart（复用标准）	items, value, currency	GA4 + Meta + TikTok	标准	—

注意这个模式：发生了什么（触发时机）、在哪里（页面）、叫什么（事件名）、携带什么数据（参数）、发到哪里（平台）、怎么验证它有效（验收标准）。

常见问题

我需要填写每一列吗？

是的——但别想太多。如果你不确定事件应该携带什么参数，就写「产品信息」或「表单数据」，我们会把它翻译成技术字段。最重要的列是触发时机（发生了什么）和事件名（叫什么）。

如果我不知道事件名怎么办？

用大白话描述发生了什么就行——「用户提交联系表单」或「客户把产品加入收藏」——我们会建议合适的 snake_case 事件名。那是我们的工作。

我应该用标准事件还是自定义事件？

如果 GA4、Meta 或 TikTok 已经有标准事件对应你要追踪的东西（比如 add_to_cart、purchase、generate_lead），就用那个。标准事件有更好的报表、更好的优化、更好的受众构建。只有当标准事件不存在时才造自定义事件——比如 video_play_50 或 wholesale_inquiry。

如果我关掉浏览器，我的数据会怎样？

你的工作保存在浏览器的 localStorage 里，所以如果你关掉标签页稍后回来（同一个浏览器、同一台设备），内容还在。但如果你清除浏览器缓存、用无痕模式、或换设备，你的工作会丢失。离开前一定要复制或下载。

---

这个工具是我们事件追踪搭建流程的一部分。你把需求表发给我们之后，我们会审查、映射到平台特定实现、并搭建追踪代码。有问题？联系我们。