Vitals API概述
Vitals API概述
Beta测试版功能： 亚马逊将本技术文档作为预发布公测版的一部分提供。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。
您可以使用Vitals API，以编程方式查看Fire TV和Fire平板电脑应用的应用运行状况指标，例如崩溃率、应用无响应 (ANR) 率和低内存杀手 (LMK) 率。这些指标被划分为多个指标集，即相关指标的逻辑分组。同一指标集中的相关指标具有一些共同属性（新鲜度和粒度），可以一起查询。每个指标集都支持多个维度，这些维度可用于筛选结果或生成细分。
Vitals API的使用受程序材料许可协议的约束。
先决条件
注意： Vitals API使用与现有报告API相同的身份验证和基本URL。因此，如果已将安全配置文件映射到报告API，则无需完成任何其他设置即可开始使用Vitals API。
在调用API之前，您需要具备以下条件：
- 具有管理员级别凭证的亚马逊开发者账户
- 映射到报告API的安全配置文件（通过开发者控制台 >“我的设置”>“API访问”创建）
- 配置文件的“Web设置”选项卡中显示的客户端ID和客户端密钥
- 您的应用的程序包名称
工作方式
数据从设备上的原始崩溃日志和性能遥测数据流入按日和按小时汇总表。
- 按日指标每天提供一个数据点，对应于T-1天。
- 按小时指标每小时提供一个数据点，对应于T-2小时。发布后进行早期回归检测时，这种方式非常实用。
新鲜度
每个指标集都提供了一种标准GET方法来检索最新可用数据的时间戳，即“新鲜度”。由于一个指标集可以支持多个粒度（按天、按小时），因此对于每个支持的粒度，该操作都会返回一个新鲜度值。
| 汇总时段 | 新鲜度SLA | 留存 | 最大查询范围 |
|---|---|---|---|
| DAILY（按天） | T-1天 | 30天 | 每个请求30天 |
| HOURLY（按小时） | T-2小时 | 15天 | 每个请求15天 |
在查询之前务必要检查新鲜度，以了解返回数据的日期范围。
数据查询
要查看指标集中的数据，请使用POST :query方法。每个查询都必须指定粒度和时间范围。除了要查看的指标外，还可以指定维度以对汇总结果进行细分，或是指定筛选条件以在不添加细分的情况下缩小结果范围。
根据您是否在查询中指定了维度，结果会有所不同。
- 查询包含维度： 对于每个时段的每个唯一维度组合，都会生成一行。
- 查询不包含维度： 对于每个时段，只生成一个汇总数字。
可用指标集
下表列出了所有可用指标集及其支持的指标。
注意： 28日用户加权平均值仅适用于
DAILY（按日）粒度。distinctDevices指标代表一个近似计数，不可跨时段求和。计数指标（crashCount、anrCount、lmkCount）代表发生错误事件的总次数（一台设备崩溃5次 = 5）。| 指标集 | 描述 | 支持的指标 |
|---|---|---|
crashMetricSet |
崩溃发生率和事件计数 | crashRate（小数）：发生过至少一次崩溃的不重复用户的百分比。 crashRate7dUserWeighted（小数）： 7日用户加权滚动平均值。 crashRate28dUserWeighted（小数）： 28日用户加权滚动平均值。 userPerceivedCrashRate（小数）：在前台使用期间发生崩溃的用户百分比。 userPerceivedCrashRate7dUserWeighted（小数）： 前台崩溃率的7日滚动平均值。 userPerceivedCrashRate28dUserWeighted（小数）： 前台崩溃率的28日滚动平均值。 distinctDevices（整数）： 活跃设备的大致数量。 crashCount（整数）： 发生崩溃事件的总次数。 |
anrMetricSet |
ANR发生率和事件计数 | 结构与崩溃指标相同，但指标变为anrRate和userPerceivedAnrRate，以及distinctDevices和anrCount（整数）： 发生ANR事件的总次数。 |
lmkMetricSet |
LMK发生率和事件计数 | 结构与崩溃指标相同，但指标变为lmkRate和userPerceivedLmkRate，以及distinctDevices和lmkCount（整数）： 发生LMK事件的总次数。 |
issuesMetricSet |
高频崩溃/ANR问题（按频率排序） | errorEventCount（整数）： 一个崩溃签名对应的错误事件总数。 affectedDeviceCount（整数）： 受影响的不重复设备数。 reportText（字符串）： 崩溃堆栈跟踪或ANR跟踪。 |
注意：
crashRate是一个标准化比率（崩溃的设备/活跃的设备）。crashCount是该时期内崩溃事件的绝对数量。使用发生率对不同版本或设备的趋势进行比较。需要原始卷时使用计数。 注意： 各个发生率指标集会返回时序数据，而
issuesMetricSet不同，会按所请求的整个时间范围进行汇总，然后针对每个唯一崩溃签名返回一行，按errorEventCount降序排序（造成最大影响的问题排在第一位）。它需要一个reportType参数来指定错误类型（CRASH或ANR）。每行都包含崩溃堆栈跟踪（如适用）。此指标集专为深入调查而设计，用于确定哪些特定崩溃签名导致发生率指标集中出现发生率骤增。不支持LMK，因为LMK事件是系统触发的，没有可供调试的堆栈跟踪。维度
每个指标集都支持一组通用的维度，用于筛选和细分。除非另有说明，否则所有指标均可按所有可用维度进行细分或筛选。
| 维度 | 类型 | 描述 |
|---|---|---|
versionCode |
int64 | 捕获数据时在用户设备上运行的应用的版本代码。 |
countryCode |
字符串 | 基于用户所在位置的ISO-3166国家/地区代码，由2个字母组成（例如US）。 |
deviceModel |
字符串 | 设备型号易记型名称（例如AFTSS、AFTSSS）。 |
deviceType |
字符串 | 设备外形规格： AMAZON_FIRE_TV或AMAZON_TABLETS。 |
deviceOS |
字符串 | 设备操作系统类型： FIRE_OS或VEGA_OS。 |
osVersion |
字符串 | 操作系统的版本（例如，RS8401/2542）。 |
相关主题
- Vitals API参考： 先决条件、身份验证、API终结点、代码示例、错误处理和最佳实践
- 报告API： 销售、收益和订阅报表下载
- “应用运行状况洞察”控制面板： 相同指标的可视化仪表板
Last updated: 2026年6月29日
