指标口径

每个指标怎么算。仪表盘、Agent、OpenAPI 用的是同一套规则、同一个查询，改口径时先改这一页。

三条总规则：

• 时间边界用项目时区。from、to 都是 YYYY-MM-DD，包含首尾两天。
• 一周从周一开始，一月从 1 号开始。
• 默认不抽样，所有人数都是精确去重。

计数

事件次数event_cnt

event_type = track 的条数。identify 和用户属性（profile_set 等）会入库，但不计入次数。

PVpv

track 且事件名是 $pageview 的条数。

UVuv

所选范围内按 distinct_id 精确去重的人数。

事件人数与人均次数users · per_user

事件人数：某个事件下按 distinct_id 去重的人数。人均次数 = 次数 ÷ 人数，人数为 0 时结果为 0。

日活、周活、月活dau · wau · mau

日活：一个项目日内有 $pageview 的去重人数。周活：从周一起到当天的去重人数；月活：从 1 号起到当天的去重人数。周活不是 7 个日活相加。

跨日 UV

区间 UV 是整个区间里去重后的人数：日聚合里存的是去重状态，区间查询时把状态合并。

注意

不能把每天的 UV 加起来当区间 UV。同一个人周一、周二都来了，周 UV 是 1，两天相加是 2。

distinct_id：有登录用户 ID（userId）时等于它，否则等于匿名 ID。两段不会自动并成一个人。SDK 重试可能让极少数事件入库两次，本期不按 event_id 去重。

会话

会话类指标只看 $pageview，在明细上计算。

会话session_cnt

同一个 distinct_id 相邻两条页面浏览的间隔不超过 30 分钟，算同一次会话。区间内没有页面浏览时，会话数、人均会话、平均时长、跳出率都记 0。

人均会话session_per_user

会话数 ÷ UV。

平均时长avg_duration_sec

每次会话的时长 = 会话里最后一条与第一条页面浏览的时间差，只有一条时为 0。平均时长是这些会话时长的平均，单位秒。

访问深度

一次会话里的页面浏览条数。

跳出率bounce_rate

只有 1 条页面浏览的会话 ÷ 会话数。

入口页与退出页pages/entry · pages/exit

入口页是会话第一条页面浏览的路径，退出页是最后一条的路径。退出率 = 在这个路径结束的会话数 ÷ 这个路径的 PV。

新老、留存、流失

新访客

第一次出现的日期落在所选区间里的人。「第一次出现」长期保存，明细过期之后，老用户也不会变回新访客。

回访

区间内有事件，并且第一次出现早于区间开始的人。

留存rates

起始日做过起始事件的人组成队列，第 N 个项目日（或周）做过回访事件的比例就是第 N 列。rates[0] = 1，表示队列本身。一个人只属于他在区间内第一次完成起始事件的那一天；回访事件不能早于他在起始日的起始事件。平均一行按队列人数加权。

流失churned · churn_rate

对比区间（紧挨在前、等长的上一段）里出现过、当前区间没有出现的人数；流失率 = 流失人数 ÷ 上一段的人数。

沉默silent

历史上来过，最后一次页面浏览距 to 不少于 N 天（7 / 14 / 30）的人。

回流returned

当前区间有页面浏览，并且区间开始之前已经连续沉默不少于 N 天的人。

漏斗与路径

漏斗funnel

2～8 个事件，严格按顺序；相邻两步的间隔不超过 window_hours（默认 24，最大 168）。人数按 distinct_id，同一个人只取第一次走完的过程。conv_from_prev 相对上一步，conv_from_first 相对第一步，第一步的两个比率都是 1。

路径path

选定事件之后 30 分钟内，同一个人的下一条 track 事件的事件名，按人数取 Top 10。

来源与搜索

直接访问

来源域名为空的访问。

来源网站visitors/referrers

非空的来源域名，去掉本站：项目白名单里的域名，或者与这条事件页面地址的域名相同。

渠道visitors/channels

按 UTM 五列分组，没带参数的单独一行「未设置」。

站内搜索search/internal

当前页面地址的查询参数里取词，参数名来自项目的「站内搜索参数名」，默认 q,keyword,wd,search,query。

站外搜索search/external

来源域名命中内置的搜索引擎（百度、Google、Bing、搜狗、360 搜索、神马）时，取对方常见的关键词参数；没有词时记「未提供关键词」。

地域与设备

地域country · province · city

国家、省、市在入库之前用本地 IP 库写入。内网地址和解析失败记为「未知」。换 IP 库不改已经写入的数据。

设备、系统、浏览器device · os · browser

从 User-Agent 解析，解析不出的记「未知」。

对比

对比上一段compare=prev

上一段与当前区间等长，紧挨在 from 之前，按日对齐。比率类指标（跳出率、转化率）各自计算，不会把两段的比率再平均。

筛选与选表

属性筛选pf

多个条件之间是「并且」。没有筛选时，日、周、月的次数和人数读预先聚合好的表；加了属性筛选就改查明细，范围大时会慢一些，数字规则不变。

超时与部分结果

部分结果partial

会话类指标在明细上计算，偶尔会超时。超时不影响同一个响应里的 PV、UV、事件次数；partial 列出没算出来的部分，界面显示「计算超时」，不会用 0 冒充。