跳转到主要内容
1签 (OneSign)

VersionStatistics

本页内容

指定安装包版本的安装和启动统计。结合 statistics_scope 判断独立版本数据或历史合并统计。

如何阅读本模型

先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。

应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。

字段定义

“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。

字段必需说明
app_id 是

业务应用的完整 ID,来自列出应用或预留新应用的响应。

类型:string

查看取值约束
  • 格式 ^A[a-f0-9]{32}$
version_id 是

完整版本 ID。从同一应用的历史版本列表或成功上传结果取得。

类型:string

查看取值约束
  • 格式 ^V[a-f0-9]{32}$
module 是

业务模块。enterprise 为企业签名,distribution 为普通应用分发。

类型:string

查看取值约束
  • 固定值 enterprise
package_type 是

original 为原始上传包,signed 为签名后的产物。

类型:string

查看取值约束
  • 可选值 original / signed
  • original — 原始上传包
  • signed — 签名后的安装包
generated_at 是

本次结果的生成时间,Unix 秒。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
timezone 是

统计日期或预算周期采用的时区。

类型:string

查看取值约束
  • 固定值 Asia/Shanghai
date 是

本条统计对应的自然日。

类型:string

查看取值约束
  • 格式 ^\d{4}-\d{2}-\d{2}$
record_scope 是

数据覆盖的留存范围。

类型:string

查看取值约束
  • 固定值 current_retained_version_counters
statistics_scope 是

版本计数口径。用于区分独立统计、旧包合并及缺少独立数据的版本。

类型:string

查看取值约束
  • 可选值 independent / merged / merged_member / disabled / source
  • independent — 该签名版本独立统计
  • merged — 旧数据合并统计
  • merged_member — 属于旧合并统计范围
  • disabled — 此版本缺少独立统计
  • source — 原始上传包
installations 是

此版本范围内的安装设备统计。与其他版本可能有同一设备,不直接相加作为应用总量。

类型:object | null

installations.unit 是

此金额或计数的单位,结合所在对象解释。

类型:string

查看取值约束
  • 固定值 unique_admitted_device_fingerprints_per_version
installations.total 是

当前保留范围内的累计数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
installations.today 是

统计时区内今日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
installations.cross_version_deduplicated 是

是否已经跨版本按同一设备去重。

类型:boolean

查看取值约束
  • 固定值 false
launches 是

记录到的设备启动事件次数,按返回口径解释。

类型:object | null

launches.unit 是

此金额或计数的单位,结合所在对象解释。

类型:string

查看取值约束
  • 固定值 recorded_launch_events
launches.total 是

当前保留范围内的累计数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
launches.today 是

统计时区内今日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
launches.current_rules_include_first_open 是

当前启动计数规则是否包含首次打开。

类型:boolean

查看取值约束
  • 固定值 true
launches.legacy_totals_may_exclude_first_open 是

旧版累计计数是否可能缺少首次打开。

类型:boolean

相关接口

下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。

作为成功响应