行为分析
适用于Alpha
行为分析回答的是「用户在这个项目和环境里做了什么」。它和错误监控共用一份数据——这正是重点: 完成转化的那个会话和报错的那个会话,是同一批行。
这页是其余所有内容的地基。看懂之后,去自定义事件 学怎么上报,或者去漏斗、路径与留存开始查。
行为分析看得见什么
Section titled “行为分析看得见什么”分析读四种事件类型,由存储后的事件推导得出,而不是由 SDK 声明:
| 类型 | 来源 | event_name |
|---|---|---|
page_view |
导航类型不是 route_change 的页面访问 |
page_view |
navigation |
导航类型是 route_change 的页面访问(SPA 路由切换) |
navigation |
click |
自动采集的 ui.click 自定义事件 |
click |
custom |
其他所有自定义事件 | 你自己的事件名 |
带 synthetic 标记的事件——Demo 种子数据和测试事件——在所有行为查询里都被排除,
所以装了 Demo 数据的实例不会把演示流量当成真实流量报出来。
每个行为指标都可以按一个维度拆分:
| 维度 | 取值 | 来源 |
|---|---|---|
country |
国家代码,或 unknown |
会话的第一条事件 |
device |
desktop、mobile、tablet、bot、unknown |
User-Agent |
browser |
浏览器名,或 unknown |
User-Agent |
source |
来源域名,或 direct |
Referrer 域名 |
property:<key> |
你的属性值,或 (not set) |
自定义事件的属性 |
<key> 必须匹配 ^[a-zA-Z][a-zA-Z0-9_.-]{0,63}$。
| 指标 | 含义 |
|---|---|
events |
去重事件数,近似值(uniqCombined64) |
estimated |
按 1 / 采样率 加权后的事件数,即估算的真实量 |
uniqueUsers |
去重匿名访客数,近似值 |
uniqueSessions |
去重会话数,近似值 |
所有计数在设计上都是近似的,响应里会带 approximate: true 让控制台如实标注。调低过采样率、
想知道真实量级时看 estimated;想知道实际存了多少时看 events。
分析类查询在真正执行之前会先估算扫描量,超了就直接拒绝,返回 422 QUERY_TOO_EXPENSIVE。
代价随时间范围上升,property: 维度是内置的四倍;加过滤则下降。解法通常是这几个之一:
- 缩短时间范围
- 加环境过滤(÷4)
- 加事件类型或事件名过滤(÷4,仅行为查询)
- 把
property:维度换成内置维度
- 自定义事件 —— 载荷契约和
ui.click保留 schema - 埋点场景 —— 注册、下单、功能采用率、搜索
- 漏斗、路径与留存 —— 三种探索查询和各自的限制
- 和 GA4 的对比 —— 逐条对比,包括缺口
相关:调查路径、术语与核心概念、Browser SDK。
Release Alpha · commit local