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

AppStatistics

本页内容

应用级的用量快照。下载次数、唯一安装设备与启动次数分别解释,并按时区和统计范围读取。

如何阅读本模型

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

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

字段定义

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

字段必需说明
app_id 是

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

类型:string

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

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

类型:string

查看取值约束
  • 可选值 enterprise / distribution
  • enterprise — 企业签名
  • distribution — 普通应用分发
generated_at 是

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

类型:integer

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

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

类型:string

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

数据覆盖的留存范围。

类型:string

查看取值约束
  • 固定值 current_retained_counters
window 是

本次统计覆盖的日期和时间区间。

类型:object

window.start_date 是

区间首日,按响应中的 timezone 解释。

类型:string

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

区间末日,按响应中的 timezone 解释。

类型:string

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

时间区间起点,Unix 秒。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
window.end_at 是

时间区间边界,Unix 秒。

类型:integer

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

平台已准入的下载计数。

类型:object

downloads.unit 是

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

类型:string

查看取值约束
  • 固定值 admitted_downloads
downloads.total 是

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

类型:integer

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

统计时区内今日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
downloads.yesterday 是

统计时区内昨日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
downloads.last_7_days 是

近 7 个自然日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
downloads.last_30_days 是

近 30 个自然日的数量。

类型:integer

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

available 表示有数据,not_initialized 为未初始化,not_applicable 为此模块不适用。

类型:string

查看取值约束
  • 可选值 available / not_initialized / not_applicable
  • available — 计数可用
  • not_initialized — 尚未初始化
  • not_applicable — 此类应用不适用
installations 是

应用级安装设备统计。按返回口径跨版本去重,不能由各版本计数相加替代。

类型:object | null

installations.unit 是

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

类型:string

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

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

类型:integer

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

统计时区内今日的数量。

类型:integer

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

统计时区内昨日的数量。

类型:integer

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

近 7 个自然日的数量。

类型:integer

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

近 30 个自然日的数量。

类型:integer

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

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

类型:boolean

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

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

类型:object | null

launches.unit 是

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

类型:string

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

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

类型:integer

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

统计时区内今日的数量。

类型:integer

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

今日计数是否为历史兼容估计值。

类型:boolean

launches.current_rules_include_first_open 是

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

类型:boolean

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

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

类型:boolean

查看取值约束
  • 固定值 true
daily 是

本次统计窗口内的逐日计数,按返回的 timezone 解释日期。

类型:object[]

查看取值约束
  • 最少元素 30
  • 最多元素 30
daily[].date 是

本条统计对应的自然日。

类型:string

查看取值约束
  • 格式 ^\d{4}-\d{2}-\d{2}$
daily[].downloads 是

平台已准入的下载计数。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
daily[].new_installations 是

该自然日新增的安装设备数。

类型:integer | null

查看取值约束
  • integer (最小值 0,最大值 9007199254740991)

相关接口

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

作为成功响应