GIO Logo

事件与属性怎么设计?一份埋点需求表的填写示例

Source:达人观点Updated: 2026-11-17

事件设计先定业务语义与粒度:事件回答“做了什么”,属性回答涉及对象与当时上下文,主体属性回答“这个人是谁”。尝试、成功、核销分母不同,不能混算。字段要写含义、样例值、出现事件、必填与缺失处理;同一按钮语义不同应拆事件。用正常、失败、重试样本验收,并记录版本、使用报表和变更负责人,保证可交接。

同一个按钮叫“咨询”,点下去可能打开表单,也可能跳到客服。两处都叫咨询点击,汇总很方便,解释却很困难。事件、属性、指标分别承担不同工作。拆对了,产品改版以后仍能比较历史,拆错了,每多一个页面就要重写一次报表。

事件粒度决定以后还能回答什么

分析云 XBA 的资料用主体、事件和维度关系描述行为模型。用通俗的话讲,主体回答谁做了,事件回答做了什么、什么时候发生,维度回答这个动作涉及哪个页面、商品或其他对象。三个问题彼此相关,却承担不同含义。比如一位会员领券,会员是主体,领取是动作,券或活动是被关联的对象。把券名称拼进事件名,每上线一张新券都要加一条事件;以活动编号关联维度,仍能用一个领取事件做全局汇总,再钻到某场活动。

事件粒度也要服从业务结果。领取按钮点击可以用来衡量入口吸引力,领券成功衡量实际权益发放,核销则对应权益被使用。每个动作都可能有相同的会员和活动属性,但生命周期阶段不同。报表如果只按点击估算发放,会把资格校验失败、库存不足和重复尝试都算成成功。反过来,如果只保留最终核销,运营就失去了判断问题发生在领取还是使用阶段的依据。

属性究竟应该跟事件走还是跟主体走

事件属性保存当时情况,主体属性适合回答关于这个人的问题。一个会员在领取时是普通会员,月底升级了。看当时的活动人群,宜按领取时的会员等级;看今天的高等级会员过去参加过哪些活动,可以用当前等级圈人,再回溯事件。两个答案都能用,但发布的分析结论应写明按哪个时点取值。涉及商品类目、门店归属等可变维度时,当前维护值与历史快照同样要区分。

尝试、成功与核销各有自己的分母

假设 1,000 名会员点击领券,其中 800 人实际领到,最终 240 人完成核销。点击到领取为 80%,领取到核销为 30%。如果把点击当作发放,核销率会变成 24%,相差 6 个百分点。前一个指标帮助判断领取环节,后一个指标帮助判断权益使用。

属性回答分析时要按什么切分

先填字段含义,再填样例值

表单入口可以取产品页、内容页和帮助中心三个枚举值。如果同一页面有横幅和浮层两个入口,入口位置可以成为另一个字段。版本应取实际渲染的表单版本,不从页面地址猜测。错误类型取稳定的业务分类,配置文档写清枚举负责人。直接上报浏览器错误原文既难合并,也可能夹带输入内容。需要更细时可以传排查代码,由有权限的同事回业务系统查日志。

每项属性都要规定在哪些事件出现、必填还是可空、缺失如何处理。例如提交尝试时读取入口和表单版本,后台成功时从业务记录携带这些上下文。后端入口未知可记录为未知并持续监测比例,不能默认填成首页,否则渠道分析会高估首页贡献。金额或耗时等数字字段写明单位,避免同一个值一端用秒、一端用毫秒。

区分动作上下文和用户当前状态

用户本周在免费套餐时使用过一次功能,下周升级。如果分析历史使用时读取他现在的套餐,升级前行为就可能被归入付费套餐。需要还原事件发生时的业务状态,就在事件发生时保留套餐快照或通过有版本的历史状态回查。如果问题是“现在付费的用户过去用过什么”,当前标签才适合做筛选。两套视角都合理,指标说明要把日期和状态的取值时点写在一起。

相关方法可参阅埋点方案怎么写?从业务问题到事件设计与验收。

同一个按钮在不同页面出现,什么时候需要拆事件

如果产品页和内容页都打开同一套咨询表单,并且分析需要比较入口贡献,使用同一事件加入口属性通常更容易汇总。如果另一个按钮虽叫“咨询”,实际执行的是在线客服开聊,成功条件和后续责任完全不同,就应另设业务事件。判断时可以问两件事。动作的业务含义是否一致,团队能否用同一条成功标准验收。只凭按钮名称、样式或页面位置拆分,往往会让全站报表依赖维护一长串事件名。

产品改版时先看语义是否变过。展示从弹层改成独立页面,只要“用户确实进入可填写状态”的含义一致,可以保留事件并新增界面样式属性。提交从“发起请求”改成“完成后台创建”则涉及实质语义变化,应迁移到新事件。记下新定义生效日期,必要时对一段时间做并行核对。历史数据无法用新口径复算时,报表应说明可比较区间。

相关方法可参阅埋点上线怎样验收?从触发、上报到报表核对的检查清单。

用数据样本验收事件和属性

先准备一个正常账号,从产品页进入并在同一会话完成咨询。预期记录入口为产品页,尝试一次,后台成功一次。再从内容页进入,输错格式后修正,确认错误类型正常,最终只产生一次记录。第三个样本测试在弱网中重试,确认后台在同一个业务请求下复用已有记录,平台分析中的成功数不会重复增长。最后安排一次明显不同的路径,例如进入后立即关闭,验证是否只有展示,没有提交或成功。

产品经理交付时,可以把每个样本写成“操作、原始事件预期、业务结果预期”三部分。研发提供原始事件核对,数据同事检查入库后的字段类型和空值,运营在最终报表按入口和版本切分验证。若原始上报正确、报表里没有值,先检查解析规则、字段注册或筛选。若只有后台成功事件缺入口,优先核对入口上下文有没有随请求进入业务系统,避免给成功事件随意补值。

让需求表能经得起人员交接

维护人需要知道字段改动会影响谁。可以为事件注明使用报表、当前生产版本与变更负责人。在增加渠道枚举时,说明未知值如何被展示,历史报表是否需要调整。在废弃字段前列出仍依赖它的看板。每一次变更保留测试账号和结果,尤其要记录失败预期。新人按需求表能复现一次成功、一次失败和一次重试,说明文档已经具备交接价值。

填一条能直接进入研发排期的需求

以“咨询记录创建成功”为例,数据团队可以指定事件键为 consultation_created,业务含义为后台产生一条可跟进的咨询记录。实现方是咨询服务,触发点是记录写入并进入约定的有效状态。事件携带咨询记录标识、入口类型、表单版本和来源端。记录标识用于对账,分析报表按角色控制可见范围。接口失败、仅保存草稿和重复消费同一成功消息,均按约定处理。每个字段标注提供方,入口由客户端在打开表单时确定,表单版本由实际使用配置给出,记录状态由后台提供。

为字段写一个有效值和一个边界值。例如入口为产品页是正常值,旧版没有传入口时应进入未知分类。对未知值可以安排一条监测,确认它是否集中在旧版本或从未配置的入口。若团队需要区分直接访问和数据缺失,可把直接进入表单定义为合法枚举,把上下文未取得留为未知。将两者混作一个值会误导分析,运营看到“直接入口”突然增加时,可能会调整本来没有问题的投放策略。

上线后核查属性能否回答最初的问题

在第一份按入口拆分的周报里,同时保留总成功人数及未知入口人数。如果有效入口占比偏低,先决定该报表是否足以支持渠道调整。假定观察到产品页转化最高,但缺少入口的大部分记录恰好来自内容页,那么排序就需要补充验证。此时按版本筛选,再用记录编号抽查业务侧保存的来源,能判断是否为采集缺失。若历史上下文无从恢复,就注明这一段时间不能用于入口排名,并从下一个完整周期重新建立基线。

同样需要计划字段退出。假设旧版“入口页面”原本存完整地址,改版后改为有限枚举。应新增语义明确的字段或定义版本,保留转换规则与边界示例,明确哪些历史地址无法映射。上线初期找一位没参与开发的运营同事,用需求表配置报表,检查他是否能理解未知、直接访问和其他入口的区别。若仍需问研发才能解释一个常见值,说明定义需要补写。报表评审可以抽查两个正常样本和一个异常样本的实际数据,再确认字段可用于日常决策。

Frequently asked questions

事件和属性如何分工?
事件表示动作及业务阶段,如点击、领取、核销;属性描述动作涉及的对象和当时情况。关于用户当前状态的问题可用主体属性,但结论要注明取值时点。
同一个按钮什么时候要拆事件?
看业务含义和成功标准是否一致。都打开同一表单可共用事件加入口属性;一个打开表单、一个开在线客服,成功条件和后续责任不同,应拆成不同业务事件。
需求表如何验收和交接?
用正常、失败、弱网重试等样本核对原始事件、业务结果和报表;字段写明提供方、枚举、未知值处理,并记录版本、依赖报表和变更负责人。
Drive business growth with data

We would like to use cookies to understand how you use this website and improve your experience. To learn about cookies and how to withdraw or manage your consent, please read our Privacy Policy. By selecting Agree, you consent to the use of cookies.

Agree