3. 事件属性设计原则：维度分层、枚举值规范、扩展性考量

3.1 用户场景与业务问题

在行为事件追踪中，属性是分析数据的最小颗粒。某团队在用户访谈时发现，同一事件“点击购买”上报的属性混乱：

• 商品ID有时用 product_id，有时用 goods_id；
• 支付金额单位不一致，有的用分、有的用元；
• 平台字段值如“iOS”“iphone”“苹果”并存，导致统计失准。

业务问题本质：属性缺乏分层设计、枚举值无标准、扩展能力不足，最终分析团队需花费30%工时做数据清洗。

3.2 需求拆解：三原则模型

将用户痛点转化为设计原则，建立统一的事件属性规范：

3.3 方案表达：维度分层模型

将事件属性按归属三层分层：

• 公共维度 —— 所有事件必须携带：user_id、device_id、client_ts、app_version、platform、channel。
• 业务维度 —— 特定事件专属：product_id、order_type、amount、source_page。
• 技术维度 —— 系统标记：event_ver（事件格式版本）、sdk_version、trace_id、debug_flag。

3.4 枚举值规范

为每个枚举字段建立统一规范文档，示例：

3.5 扩展性考量

三个设计点保障未来扩展：

1. 版本号字段：每个事件携带 event_ver，当属性体系变更时发布新版本，旧事件仍可用。
2. 预留标签字段：使用 ext_ 前缀预留5个字符串字段（如 ext_1~ext_5），SDK 不上报空值，仅在需要时启用。
3. 标签化机制：允许为属性打标签（如“黑盒实验属性”），避免属性名称无限膨胀。

3.6 指标验证与验收标准

采用下述验收检查表确保设计落地：

3.7 交付物模板：事件属性设计文档

每次接入新事件/新属性时，须输出以下模板（节选）：

属性清单：
| 属性名           | 类型   | 层级     | 枚举值说明               | 校验规则           |
|-----------------|--------|----------|--------------------------|-------------------|
| user_id          | string | 公共     | 用户ID                  | 长度≤64           |
| product_id       | string | 业务     | 商品唯一标识             | 正则 ^[A-Z0-9]+$ |
| order_type       | int    | 业务     | 1普通 2团购 3秒杀       | 1-3               |
| event_ver        | int    | 技术     | 当前版本号               | 固定为1           |
| ext_1            | string | 技术     | 预留扩展                | 可选，不传空串    |

此模板与验收清单配合，形成属性设计SOP：每次新事件上线前，必须逐项打勾通过，否则不允许提测。