AppStatistics
本页内容
应用级的用量快照。下载次数、唯一安装设备与启动次数分别解释,并按时区和统计范围读取。
如何阅读本模型
先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。
应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。
字段定义
“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。
| 字段 | 必需 | 说明 |
|---|---|---|
app_id |
是 | 业务应用的完整 ID,来自列出应用或预留新应用的响应。 查看取值约束
|
module |
是 | 业务模块。enterprise 为企业签名,distribution 为普通应用分发。 查看取值约束
|
generated_at |
是 | 本次结果的生成时间,Unix 秒。 查看取值约束
|
timezone |
是 | 统计日期或预算周期采用的时区。 查看取值约束
|
record_scope |
是 | 数据覆盖的留存范围。 查看取值约束
|
window |
是 | 本次统计覆盖的日期和时间区间。 |
window.start_date |
是 | 区间首日,按响应中的 timezone 解释。 查看取值约束
|
window.end_date |
是 | 区间末日,按响应中的 timezone 解释。 查看取值约束
|
window.start_at |
是 | 时间区间起点,Unix 秒。 查看取值约束
|
window.end_at |
是 | 时间区间边界,Unix 秒。 查看取值约束
|
downloads |
是 | 平台已准入的下载计数。 |
downloads.unit |
是 | 此金额或计数的单位,结合所在对象解释。 查看取值约束
|
downloads.total |
是 | 当前保留范围内的累计数量。 查看取值约束
|
downloads.today |
是 | 统计时区内今日的数量。 查看取值约束
|
downloads.yesterday |
是 | 统计时区内昨日的数量。 查看取值约束
|
downloads.last_7_days |
是 | 近 7 个自然日的数量。 查看取值约束
|
downloads.last_30_days |
是 | 近 30 个自然日的数量。 查看取值约束
|
installation_statistics_state |
是 | available 表示有数据,not_initialized 为未初始化,not_applicable 为此模块不适用。 查看取值约束
|
installations |
是 | 应用级安装设备统计。按返回口径跨版本去重,不能由各版本计数相加替代。 |
installations.unit |
是 | 此金额或计数的单位,结合所在对象解释。 查看取值约束
|
installations.total |
是 | 当前保留范围内的累计数量。 查看取值约束
|
installations.today |
是 | 统计时区内今日的数量。 查看取值约束
|
installations.yesterday |
是 | 统计时区内昨日的数量。 查看取值约束
|
installations.last_7_days |
是 | 近 7 个自然日的数量。 查看取值约束
|
installations.last_30_days |
是 | 近 30 个自然日的数量。 查看取值约束
|
installations.cross_version_deduplicated |
是 | 是否已经跨版本按同一设备去重。 查看取值约束
|
launches |
是 | 记录到的设备启动事件次数,按返回口径解释。 |
launches.unit |
是 | 此金额或计数的单位,结合所在对象解释。 查看取值约束
|
launches.total |
是 | 当前保留范围内的累计数量。 查看取值约束
|
launches.today |
是 | 统计时区内今日的数量。 查看取值约束
|
launches.today_estimated |
是 | 今日计数是否为历史兼容估计值。 |
launches.current_rules_include_first_open |
是 | 当前启动计数规则是否包含首次打开。 查看取值约束
|
launches.legacy_totals_may_exclude_first_open |
是 | 旧版累计计数是否可能缺少首次打开。 查看取值约束
|
daily |
是 | 本次统计窗口内的逐日计数,按返回的 timezone 解释日期。 查看取值约束
|
daily[].date |
是 | 本条统计对应的自然日。 查看取值约束
|
daily[].downloads |
是 | 平台已准入的下载计数。 查看取值约束
|
daily[].new_installations |
是 | 该自然日新增的安装设备数。 查看取值约束
|
相关接口
下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。