API浏览器
API浏览器是开发者门户上的交互式查询构建器。您可以使用它来探索Vitals和Monetization API指标、可视化构建请求，并针对您的实时数据运行它们，完全无需编写任何代码。在将API集成到您自己的应用之前，这是尝试查询的最快方法。
对于您构建的每个查询，API浏览器为您提供以下内容：
- 完整的内联JSON响应
- 可直接复制的cURL命令
- Java、Python和Node.js中的代码片段
使用可视化界面，您可以执行以下操作：
- 选择API和查询类型、选择指标和维度、应用筛选条件以及运行查询
- 在更改选项时实时查看生成的API请求更新
- 检查完整的内联JSON响应
- 将请求复制到您自己的代码中
使用API浏览器
从开发者门户App Analytics（应用分析）部分的API访问选项卡打开API浏览器，然后按以下顺序填写表单。
1.选择API
在API字段中，选择所需的数据。您的选择将决定可用的查询类型、指标集、维度以及筛选条件。
| API | 包含的内容 |
|---|---|
| Vitals | 应用运行状况和性能： 崩溃、ANR和LMK率及其背后的高频问题，加上启动延迟、就绪时间、慢启动率和流畅度 |
| Monetization | 订阅： 注册、续订、取消、重新激活、活跃订阅、健康状况、取消调查以及履行情况 |
2.选择查询类型
对于 Vitals，选择查询类型：
- 指标： 查询指标集（比率、计数和时间），可选择按维度细分，并通过筛选条件缩小范围。
- 问题： 返回按频率排序的高频问题，并附带堆栈跟踪。在此模式下，您可以选择报告类型而不是指标集。
Monetization仅支持指标，因此查询类型是固定的。
3.选择您的应用
在应用字段中选择或输入您的Android程序包名称（例如com.amazon.sampleapp）。此应用的所有者必须是您的供应商账户。
4.选择指标集或报告类型
对于问题查询类型（仅限Vitals），选择报告类型： Crash（崩溃）或ANR。
对于指标查询类型，选择指标集。选项取决于API。
Vitals指标集
| 指标集 | 用于衡量什么 |
|---|---|
| Crash（崩溃） | 崩溃率、用户感知的崩溃率和崩溃事件计数 |
| ANR（应用无响应） | ANR率、用户感知的ANR率和ANR事件计数 |
| LMK（低内存杀手） | LMK率、用户感知的LMK率和LMK事件计数 |
| 应用延迟 | 冷启动和热启动期间首次应用活动出现的时间 |
| 准备就绪 | 冷启动和热启动期间应用完全渲染并可用的时间 |
| 慢启动率 | 经历慢速冷启动或热启动的不重复设备的百分比 |
| 流畅度 | 丢帧率以及经历渲染缓慢的不重复设备的百分比 |
Monetization指标集
| 指标集 | 用于衡量什么 |
|---|---|
| 订阅注册 | 新订阅注册量和注册收入 |
| 订阅续订 | 订阅续订量和续订收入 |
| 订阅取消 | 取消的订阅量和退款金额 |
| 订阅重新激活 | 之前取消但已重新激活的订阅数，以及由此产生的收入 |
| 活跃订阅 | 特定日期内的活跃订阅总数 |
| 订阅运行状况 | 自动续订和宽限期活动 |
| 取消调查 | 订阅者报告的取消原因 |
| 订阅履行 | 收据交付状态和开发者确认延迟 |
COLD或WARM。此字段为必填。5.选择汇总方式和时段
- Aggregation（汇总）： 选择
HOURLY（按小时）或DAILY（按日）。 - Time Period（时段）： 选择预设日期（例如，过去7天或过去30天），或者使用自定义日期范围来指定确切的日期。
查询窗口取决于汇总方式。所有时间均以UTC为单位。
- DAILY： 仅统计完整天数，截至昨天。今天不包括在内，因为它尚未结束。例如，如果今天是9月28日，过去30天涵盖从8月29日到9月27日（包含首尾两天）。最长回溯时间为30天。
- HOURLY： Monetization指标最多可提前3小时（T-3小时），而Vitals指标最多可提前2小时（T-2小时）。
6.选择指标
使用指标多选下拉列表来选择要包含的指标。如果留空，则会查询所选指标集的所有指标。
可用指标因指标集而异。例如：
- Vitals LMK：
lmkRate、lmkRate7dUserWeighted、lmkRate28dUserWeighted、userPerceivedLmkRate、userPerceivedLmkRate7dUserWeighted、userPerceivedLmkRate28dUserWeighted、distinctDevices、lmkCount - Monetization订阅注册：
signups、signupRevenue - Monetization订阅履行：
totalReceipts、fulfilled、unavailable、pending、notEligible、existingPurchase、notDelivered、p50AcknowledgementDelay、p90AcknowledgementDelay、p95AcknowledgementDelay
7.可选： 添加维度
通过选择维度，可以对结果进行细分。每个维度都会在输出中添加一列。可用的维度取决于所选API和指标集：
- Vitals： 版本代码、国家/地区代码、设备型号、设备类型、设备操作系统、操作系统版本
- Monetization： 市场、期限SKU、设备类型、设备操作系统、订阅类型、续订类型、取消类型、取消原因、购买渠道
8.可选： 应用筛选条件
筛选条件可在不添加细分列的情况下缩小结果范围。设置一个或多个筛选条件值。可用的筛选条件取决于API。
Vitals筛选条件
- 版本代码： 筛选到特定应用版本
- 国家/地区： 筛选到一个或多个国家/地区（例如
US） - 设备型号： 筛选到特定设备型号
- 设备类型： 按设备系列筛选
- 设备操作系统： 按Fire OS或Vega OS设备筛选
- OS Version（操作系统版本）： 按操作系统版本筛选
Monetization筛选条件
- 市场： 筛选到特定市场
- 期限SKU： 筛选到特定订阅产品SKU
- 设备类型： 按设备系列筛选
- 设备操作系统： 按Fire OS或Vega OS设备筛选
- 订阅类型、续订类型、取消类型、取消原因、购买渠道： 按相应的订阅属性筛选
FIRE_OS或IAP），因此您的筛选值与响应完全匹配。9.设置页面大小
选择每个响应的最大行数（默认值：1,000，最大值：100,000）
10.运行查询
选择运行查询。响应显示在右侧的响应面板中。
请求预览面板
配置查询时，请求预览面板会实时更新，并显示以下内容：
- 完整的
POSTURL - 完整的cURL命令和JSON请求正文
您可以将预览展开，在全屏视图下查看以便于阅读，也可使用复制按钮将其复制到剪贴板。
响应面板
运行查询后，响应面板会显示完整的JSON响应，包括以下内容：
rows []，其中每一项都包含时段、维度值和指标值- 分页令牌 (
nextPageToken)（如果有更多结果可供查看）
检查大型结果集时，可以将预览展开，在全屏视图中查看。
提示
请参阅有关API浏览器使用方法的以下提示：
- 从简单查询开始： 首先运行不包含任何维度或筛选条件的查询，以验证您的应用是否有数据，然后再添加细分。
- 检查结果是否为空： 如果得到空结果，则说明所选时间范围可能晚于可用数据。有关详细信息，请参阅步骤5中的查询窗口。请尝试使用更早的日期范围。
- 复制和集成： 使用请求预览将确切的请求复制到您的应用代码中。
- 28日指标要求选择DAILY：对于HOURLY汇总，不提供28日用户加权指标。将汇总方式切换到
DAILY。 - 计数与比率： 使用
crashCount、anrCount或lmkCount衡量事件的绝对数量。使用比率指标对不同版本或设备进行标准化趋势比较。
相关主题
- 报告API： 销售、收益和订阅报表下载
- Vitals API V2概述： 可用指标和维度
- Vitals API V2参考： 身份验证、终结点、代码示例和错误处理
- Monetization Metrics API概述： 可用指标和维度
- Monetization Metrics API参考： 先决条件、身份验证、API终结点、代码示例、错误处理和最佳实践
Last updated: 2026年10月13日
