设备指纹
使用控制台数据概览

指标计算口径

数据概览: 指标计算口径

指标分子、分母与去重键

指标分子分母建议去重键
识别事件当前范围内的识别事件数量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%

页面应同时显示当前值和变化方向,不建议只展示百分比而隐藏两个周期的原始数量。