使用控制台数据概览
指标计算口径
数据概览: 指标计算口径
指标分子、分母与去重键
| 指标 | 分子 | 分母 | 建议去重键 |
|---|---|---|---|
| 识别事件 | 当前范围内的识别事件数量 | 无 | request_id |
| 独立访客 | 当前范围内不同设备数量 | 无 | device_id |
| 风险事件 | 命中至少一个风险信号的事件数量 | 无 | request_id |
| 事件/访客比 | 识别事件数 | 独立访客数 | 分子按 request_id,分母按 device_id |
| 单个风险信号命中次数 | 包含该信号的事件数量 | 无 | 通常按 request_id,同一事件对同一信号只计一次 |
如果某个指标没有足够数据,页面应显示“暂无数据”或使用明确的占位符,不应把无法计算误显示为 0。
成功事件与计费事件
需要核对套餐额度时,请同时查看哪些事件会计入用量。
“成功形成事件”和“计费事件”是两个相关但不一定完全相同的概念:
- 成功事件:GEELAB 已完成识别处理,并形成可查询的事件记录。
- 计费事件:根据当前套餐和计费规则纳入用量或费用计算的请求。
某些产品规则可能只对成功下发 Token 且满足计费条件的识别请求计入计费用量;被拒绝、失败、测试或特定排除规则处理的请求,可能不会计费,但是否形成日志或可查询事件需要以正式计费和 API 说明为准。
因此:
- 概览事件数不应直接当作账单金额。
- 概览中的用量卡片应明确标注“识别事件”还是“计费调用”。
- 账单页面和套餐用量页面应使用统一的计费口径。
- 对账时应同时记录时间范围、应用、Region 和套餐版本。
当前周期与上一周期
当前周期是用户在页面选择的时间段。上一周期是紧邻当前周期、长度相同的前一个时间段。
示例:
当前周期:2026-08-13 至 2026-08-19
上一周期:2026-08-06 至 2026-08-12“今天”的上一周期通常是昨天;“近 7 天”的上一周期是前一个完整 7 天;“近 30 天”的上一周期是前一个完整 30 天。
如果当前周期正在进行,当前周期的数据可能还会继续增加。上一周期通常是已经结束的完整周期,因此两者不一定具有相同的数据完整程度。
环比变化率
当上一周期有可比较数据时,环比变化率通常按以下公式计算:
环比变化率 = (当前周期值 - 上一周期值) / 上一周期值 × 100%例如:当前周期有 1,200 个事件,上一周期有 1,000 个事件:
(1,200 - 1,000) / 1,000 × 100% = +20.0%页面应同时显示当前值和变化方向,不建议只展示百分比而隐藏两个周期的原始数量。