事件定义
分析、目标和监控都按事件名取数，事件定义让同一种行为只有一个名字。代码里调用了 track() 但未登记的名字会出现在「未规划」里；全埋点候选要点「接受」后才变成定义。
定义表在这个页面的「事件定义」页签。同组 控制台全端分析数据管理事件与属性 只按时间看触发次数、独立访客、占比、7 天趋势和属性值分布，不改定义。设计阶段的清单见 埋点方案与校验。
状态
| 状态 | 从哪来 | 接下来可以 |
|---|---|---|
| 已创建 | 新建定义 | 到已批准，或已拦截 |
| 已批准 | 已创建或未规划 | 到生效、已拦截，或退回已创建 |
| 生效 | 已批准或未规划 | 到已拦截 |
| 已拦截 | 任一可拦截状态 | 回到生效或已批准 |
| 未规划 | 上报了但没有定义 | 到已批准、生效或已拦截 |
状态不拦截采集，只有「已拦截」会在入库前丢掉整条事件，也不计配额。「隐藏」与状态无关，只影响查询里是否出现，可撤销。
「来源」列取值为「AI 建议」「规则圈选」「代码埋点」「服务端」「未规划」「行业包预置」「系统」。接受全埋点候选会建匹配规则，并回溯最近 90 天。代码对话框里，近 24 小时收到代码或服务端上报后，可以点「标记为已验证」；这是标记，不是一种状态。
如何使用
点「新建事件」登记事件名、显示名、分类、说明和属性，必填属性用于齐全率和代码片段。事件名创建后不能改。之后可以改显示名和属性、按上表切换状态，或「隐藏」「显示」。
删除只删定义和关联规则，已采集数据保留；被目标引用的定义删不掉。再次上报会重新出现在「未规划」。
权限与限制
查看不限角色。新建、编辑和改状态需要分析师及以上。删除需要所有者或管理员。全埋点候选的生成还受套餐里的候选额度限制，见 事件收件箱（待认领）。
常见问题
「已创建」是不是还没采到？ 不是。状态不影响采集，只有「已拦截」会丢事件；隐藏的定义也仍在入库。
缺了必填属性会被拦截吗？ 不会。必填属性只用于齐全率和代码片段，除非你在属性字典里另设校验。
属性定义
属性字典管的是键的类型、敏感分类和入库规则：错误类型会让求和、筛选失真，直接标识应在列表和导出里脱敏。用户档案上的具体值见 用户属性与标签。
控制台全端分析数据管理属性字典页签是「用户属性」「事件属性」「账户属性」。列有「键」「类型」「PII」「样例」「出现」「最近」。
指标与口径
- 类型：「文本」「数值」「布尔」「时间」「列表」。
- 敏感分类：「直接标识」「间接标识」「非个人」。直接标识默认脱敏。「属性级脱敏」对所有角色生效，并与成员脱敏策略取更严的一档。
- 人工确认：扫描能发现新键；你保存过编辑之后，后来的扫描不再覆盖类型和敏感分类。
校验与治理
「校验规则」在入库时做：期望类型、必填于事件、正则、最大长度、最小最大值、枚举值。违规处置：
| 处置 | 事件是否入库 | 结果 |
|---|---|---|
| 仅告警 | 是 | 数据质量页记一次告警 |
| 删除该属性 | 是 | 去掉这个键 |
| 拦截整条事件 | 否 | 不进隔离区 |
| 进隔离区 | 否 | 暂存供排查，见 数据质量 |
「治理规则」还可以拦截该键（不入库）、设白名单（名单外记为 __other，原值待认领），或标成「只进导出」（分析界面不能按它拆分）。
如何使用
点「立即扫描」，或等每日自动扫描。点「编辑」改显示名、类型、敏感分类和规则，保存即视为人工确认。白名单每行一个值，最多 100 个。删除字典项不删除已经入库的历史值。
权限与限制
查看不限角色。扫描和编辑需要分析师及以上。控制台的删除按钮只对所有者和管理员显示。
常见问题
「只进导出」会删除数据吗？ 不会，值仍在事件行里，导出可以拿到。
高基数标记从哪来？ 来自近 7 天去重值，处理入口在数据质量页。
枚举和正则什么时候生效？ 只在你保存了校验规则之后。
事件收件箱
全埋点先记下交互，不要求事先起名；收件箱按元素和页面聚类，给出规则或模型建议的名字，确认之后才能当正式事件用。未规划事件是 track() 用了定义表里没有的名字。
页签有「待处理」「已接受」「已忽略」「事件定义」。顶部数字是「待处理候选」「未规划事件」「已定义事件」「已验证接入」。定义的状态见 事件定义。
指标与口径
候选卡片有「7 日触发」「7 日人数」「最近出现」。可按「高置信度」「低置信度」或「3 天未出现」过滤，按次数、人数或最近出现排序。展开可看近 7 日趋势、首次出现、出现页面、前后动作。
建议名旁边的「规则」或 AI 只表示名字是怎么来的，数字仍是真实触发。
如何使用
开启全埋点后，每天会整理前一天的交互，也可以点「立即生成候选」。对每个候选三选一：
- 接受：填写事件名（字母开头）、显示名、分类和说明。会创建匹配规则，并回溯最近 90 天的全埋点记录，量大时要几分钟。
- 合并：把这次交互加进已有事件的匹配规则，历史增量回溯。
- 忽略：候选留在「已忽略」，需要时可以再接受。
权限与限制
生成候选、接受、合并和忽略需要分析师及以上。套餐不含候选额度时，页面提示当前套餐不含 AI 事件收件箱与全埋点。未开启全埋点时不会产生新候选，去项目设置打开。
常见问题
不点接受，未规划事件会停止入库吗？ 不会。要停掉某个名字，把它的定义设为「已拦截」。
虚拟事件与属性
适合埋点已经上线、但想在漏斗里直接选「看过定价页」，或想按路径前缀给事件分类而 SDK 没报这个属性的情况。先用规则把口径跑起来，等真实埋点上线后再替换。
控制台全端分析数据管理虚拟事件属性页面分两个页签：「虚拟事件」「虚拟属性」。列表显示「规则」条数、「7 日命中」和状态。
指标与口径
虚拟事件。 一条定义由若干规则组成，任意一条规则命中就生成一条同名事件。规则之间是「或」，一条规则内的条件之间是「且」。每条规则可以指定源事件，留空表示任意事件；$pageview 表示页面浏览。写入时，副本带 $virtual_source 属性记录源事件名，来源标记为自动，不参与会话计数。生成后它和普通事件一样，出现在事件列表里，可以用在所有分析模型中，见 事件定义。
虚拟属性。 按顺序检查规则，取第一条命中规则的输出值写入属性；都不命中时写默认值，默认值为空就不写。输出值里可以用 {属性键} 引用源属性，例如 {$path}。事件上已经有同名真实属性时，不覆盖。
条件的左侧可以是内置字段，也可以是事件属性里的键。内置字段有页面路径、域名、页面标题、来源渠道、来源域名、三个 UTM、国家或地区、设备类型、平台、浏览器、操作系统。运算符有：等于、不等于、包含、开头是、结尾是、属于列表、大于、小于、大于等于、小于等于、存在、不存在、匹配正则。属于列表用逗号或换行分隔。数值比较会把值转成数字。
如何使用
- 点「新建虚拟事件」或「新建虚拟属性」。
- 填名称：字母、数字、下划线，2 到 60 个字符，不能以数字开头，不能用
$或__开头。创建后不能改名。显示名和说明可以之后改。 - 添加规则。一条定义最多 20 条规则，界面里每条规则最多 10 个条件。
- 点「运行预览」，在近 7 天的真实数据上试算：虚拟事件显示命中事件数、命中访客数和每条规则各命中多少；虚拟属性显示输出值的分布。
- 保存。
示例：把「页面浏览，且路径以 /pricing 开头」命名为 pricing_viewed，之后漏斗里直接选它。或者建一个虚拟属性 section，规则一为路径以 /blog 开头输出「博客」，规则二为路径以 /docs 开头输出「文档」，默认值填「其它」。
暂停与恢复。 暂停后不再生成新数据，已经写入的保持不动。
历史回填。 新定义只对之后进来的事件生效。要补历史，在定义里选天数（1 到 365，默认 30）后开始回填。回填是同步执行的，数据量大时要等一会儿。重复回填会先清掉上次的结果再写，所以可以反复跑。状态有回填中、已完成、失败。
删除。 删除虚拟事件时，服务端会把它已写入的副本一并清掉，并删除对应的事件定义；删除虚拟属性只是不再写新值。已写进事件里的属性值不会回头抹掉。
权限与限制
任何能看这个项目的人都能看列表。新建、编辑、暂停、删除、预览和回填需要分析师及以上。创建、修改、删除和回填会写进审计记录。规则缓存约 1 分钟，改完规则后新事件最长要等这么久才按新规则处理。
常见问题
预览有数，漏斗里为什么没有？ 预览看的是已入库的原始事件。虚拟事件只对规则生效之后进来的新事件产生副本，历史要先回填。
预览为什么显示没有命中？ 检查源事件名、属性键和条件值。属性键区分大小写，条件里的路径比较的是入库后的页面路径。
虚拟事件能和真实事件同名吗？ 不能。名称已被真实事件占用时会提示换一个。
它会影响会话数吗？ 不会。虚拟事件副本不参与会话计数，也不带去重标识。