查看安装统计与设备记录
本页内容
查看企业签名应用的安装设备数、启动次数、单版本统计和安装受限记录。先确认统计口径,再使用数据进行业务分析,避免将下载次数或版本安装量误当作应用总设备数。
了解统计口径
| 数据 | 如何理解 |
|---|---|
| 下载次数 | 平台记录的下载准入次数,不代表文件已经下载完成或安装成功。 |
| 应用安装设备数 | 同一应用内按已获准登记的设备标识去重,并跨版本去重。 |
| 版本安装设备数 | 以单个签名版本为范围。同一个设备使用多个版本时,可以分别出现在多个版本中。 |
| 启动次数 | 平台实际记录的启动事件次数。当前规则包含首次打开;旧累计数据可能缺少首次打开。 |
例如,同一设备标识先使用版本一,再使用版本二,应用汇总仍按一个设备计算;两个版本可以各有一个安装设备。不能将版本安装量直接相加,作为应用的唯一设备总数。
设备标识用于本站统计,不是硬件真实性证明。请结合返回的 device_identifier、留存范围和统计状态解释数据。
前提条件
统计读取、版本统计、设备记录和设备导出分别授权。设备 IP与地区还需独立的 enterprise:ReadDeviceNetwork;没有该权限时可能返回空值,不能解释为设备没有网络信息。
查询应用汇总
调用 查询应用安装、启动与下载统计取得当前保留的汇总及近期日数据。接口没有自定义日期范围参数;使用返回的 window、timezone 和 record_scope 显示实际覆盖范围。
当安装统计尚未初始化时,检查 installation_statistics_state,不要将缺少数据解释为零安装。启动量还需关注 today_estimated 和 legacy_totals_may_exclude_first_open,以免把兼容估计当作精确历史数据。
查询单版本统计
调用 查询单个签名版本统计,传入同一应用的版本 ID。先判断 statistics_scope,再展示计数。
def read_statistics(client, app_id, version_id):
application = client.get_app_statistics(app_id)["data"]
version = client.get_version_statistics(app_id, version_id)["data"]
return application, version
# 汇总按 application 的口径解释;单版本先检查 statistics_scope。| statistics_scope | 含义 |
|---|---|
independent | 该签名版本独立统计。 |
merged | 保存的是旧数据合并统计,不能归为某一次签名的独立使用量。 |
merged_member | 该版本属于旧合并统计范围,不应重复累加。 |
source | 原始上传包。 |
disabled | 该版本没有可用的独立统计。 |
查询设备与安装受限记录
列出已登记设备返回已登记设备;查询超限安装记录返回安装量超限等受限记录。按所需条件分页查询,并保持翻页条件不变。
def read_devices(client, app_id, cursor=None):
parameters = {"limit": 50, "state": "all"}
if cursor is not None:
parameters["cursor"] = cursor
return client.list_devices(app_id, parameters)["data"]受限记录的 pending 表示尚未恢复准入,recovered 表示已恢复。它记录一次或多次受限尝试,不应直接加入成功安装总数。需要扩容时,先核对当前权益与安装量上限。
导出设备记录
- 选择已登记设备或受限记录,以及必要筛选条件。
- 每页导出使用一个已保存的幂等键。检查响应中的格式、行数、摘要和下一页游标。
- 解码
content_base64,校验 SHA-256,将 JSONL 内容保存在受限位置。 - 有
next_cursor时,将原游标带入下一页,并为下一页保存独立幂等键。
import base64
import hashlib
def export_device_page(client, app_id, write_key, cursor=""):
data = client.export_devices(app_id, {
"source": "devices", "state": "all", "limit": 100, "cursor": cursor,
}, write_key)["data"]
if data["content_base64"] is None:
raise ValueError("本次响应只有回执,没有可用的导出内容")
content = base64.b64decode(data["content_base64"], validate=True)
if hashlib.sha256(content).hexdigest() != data["sha256"]:
raise ValueError("导出内容的摘要不匹配")
return content, data["next_cursor"] # 私有保存;有游标时继续下一页。导出返回的是一页数据,不是全库快照;遍历期间记录可能发生变化。幂等重放可能只返回回执而没有内容,请检查空值。设备数据不要输出到普通业务日志或公开下载目录。