报告API浏览器
报告API浏览器
Beta测试版功能： 亚马逊将本技术文档作为预发布公测版的一部分提供。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅最新的发布说明。
报告API浏览器是开发者门户上的交互式查询构建器。您可以使用它来浏览报告API和Vitals API指标，以直观方式构造请求，以及根据实时数据执行请求，所有这些操作均无需编写任何代码。使用报告API浏览器进行初步浏览。
报告API浏览器可以为您生成以下内容：
- 完整的内联JSON响应
- Java、Python和Node.js中可直接复制的请求cURL命令代码片段
然后，您可以执行以下操作：
- 选择指标集、选择指标和维度、应用筛选条件，然后运行查询（所有这些操作均通过可视化界面完成）
- 在配置选项时实时查看生成的API请求更新
- 检查完整的内联JSON响应
- 复制请求以在自己的代码中使用
使用报告API浏览器
您可以从开发者门户App Analytics（应用分析）部分的API访问选项卡访问报告API浏览器。
有关报告API浏览器的使用方法，请参阅以下步骤。
1.选择您的应用程序包名称
在应用字段中选择或输入您的Android程序包名称（例如com.amazon.sampleapp）。此应用的所有者必须是您的供应商账户。
2.选择指标集
从Metric Set（指标集）下拉列表中，选择要查询的指标集：
| 指标集 | 用于衡量什么 |
|---|---|
| Crash（崩溃） | 崩溃率、用户感知的崩溃率和崩溃事件计数 |
| ANR（应用无响应） | ANR率、用户感知的ANR率和ANR事件计数 |
| LMK（低内存杀手） | LMK率、用户感知的LMK率和LMK事件计数 |
| Issues（问题） | 高频崩溃/ANR/LMK问题（按频率排序）与堆栈跟踪 |
3.选择汇总方式和时段
- Aggregation（汇总）： 选择
HOURLY（按小时）或DAILY（按日）。 - Time Period（时段）： 可以选择“Last 7 days”（最近7天）进行快速查询，也可选择“Custom date range”（自定义日期范围）以指定确切日期。
注意： 按小时查询的日期范围上限为15天。按日查询的日期范围限制为30天。
4.选择指标
使用Metrics（指标）多选下拉列表来选择要包含的指标。如果留空，则会查询所选指标集的所有指标。
可用指标因指标集而异。例如，LMK指标集提供了以下指标：
lmkRatelmkRate7dUserWeightedlmkRate28dUserWeighteduserPerceivedLmkRateuserPerceivedLmkRate7dUserWeighteduserPerceivedLmkRate28dUserWeighteddistinctDeviceslmkCount
5.可选： 添加维度
通过选择维度，可以对结果进行细分。每个维度都会在输出中添加一列。可用维度包括以下几项：
- Version Code（版本代码）
- Country Code（国家/地区代码）
- Device Model（设备型号）
- Device Type（设备类型）
- 设备操作系统
- 操作系统版本
6.可选： 应用筛选条件
通过设置筛选条件，可以在不添加细分的情况下缩小结果范围：
- Version Code（版本代码）： 筛选到特定应用版本
- Country（国家/地区）： 筛选到特定国家/地区（例如美国）
- Device Model（设备型号）： 筛选到特定设备型号
- Device Type（设备类型）： 按
AMAZON_FIRE_TV或AMAZON_TABLETS筛选 - 设备操作系统： 按Fire OS或Vega OS设备筛选
- OS Version（操作系统版本）： 按操作系统版本筛选
7.设置页面大小
选择每个响应的最大行数（默认： 1000行；最大： 100,000行）。
8.运行查询
单击Run Query（运行查询）执行查询。响应显示在右侧的Response（响应）面板中。
Request Preview（请求预览）面板
配置查询时，Request Preview（请求预览）面板会实时更新，显示：
- 完整的
POSTURL - 完整的cURL命令和JSON请求正文
您可以将预览展开，在全屏模式下查看以便于阅读，也可使用复制按钮将其复制到剪贴板。
Response（响应）面板
运行查询后，Response（响应）面板会显示完整的JSON响应，包括：
rows[]，其中包含时段、维度值和指标值- 分页令牌（如果有更多结果可供查看）
检查大型结果集时，可以将预览展开，在全屏模式下查看。
提示
请参阅有关报告API浏览器使用方法的以下提示：
- 从简单查询开始： 首先运行不包含任何维度或筛选条件的查询，以验证您的应用是否有数据，然后再添加细分。
- 检查新鲜度： 如果得到空结果，则说明所选时间范围可能晚于可用数据。请尝试使用更早的日期范围。
- 复制和集成： 使用Request Preview（请求预览）将确切的请求复制到您的应用代码中。
- 28日指标要求选择DAILY（按日）： 如果选择28日用户加权指标，请将汇总方式切换为DAILY（按日）（HOURLY（按小时）不适用）。
- 计数与发生率： 使用
crashCount/anrCount/lmkCount衡量事件的绝对数量。使用发生率指标对不同版本或设备进行标准化趋势比较。
相关主题
- 报告API： 销售、收益和订阅报表下载
- Vitals API概述： 可用指标、维度和常见问题解答
- Vitals API参考： 身份验证、终结点、代码示例和错误处理
Last updated: 2026年6月29日
