跳转到内容
Docs

行为分析

适用于Alpha

行为分析回答的是「用户在这个项目和环境里做了什么」。它和错误监控共用一份数据——这正是重点: 完成转化的那个会话和报错的那个会话,是同一批行。

这页是其余所有内容的地基。看懂之后,去自定义事件 学怎么上报,或者去漏斗、路径与留存开始查。

分析读四种事件类型,由存储后的事件推导得出,而不是由 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: 维度换成内置维度

相关:调查路径、术语与核心概念、Browser SDK。

Release Alpha · commit local