指标集简介

借助 Google Play 开发者报告 API，您可以访问有关应用的指标、报告和时间轴信息。 为了尽可能简化 API 用法，我们使用 指标集来标准化指标访问。 指标集是相关指标的逻辑分组，这些指标具有共同的属性 （例如时效性和粒度），并且可以一起查询。 指标集还包含许多维度，您可以使用这些维度来过滤数据或生成细分数据。 除非另有说明，否则所有指标都可以按所有可用维度进行细分或过滤。

时效性

每个指标集资源都提供了一个标准 GET 方法，用于检索最新可用数据点（称为时效性）的 日期和时间。由于指标集可以 支持多种粒度（每日、每小时），因此该操作会为每个受支持的粒度返回一个时效性值 。

您可以直接将时效性值用作查询时间范围内的端点。

数据查询

如需访问指标集中的数据，您应使用自定义 QUERY 方法来发出查询。 每个查询都必须指定粒度和时间范围。除了要访问的指标之外，您还应指定用于细分汇总数据的维度。

请求时间轴时，应注意请求的日期范围，以便 时间范围的大小与应用的大小和细分的数量成反比。 例如，大型应用应在单个 查询请求中选择较少的日期，以避免因读取过多数据而导致查询超时。

可用指标集

下面的索引列出了您可以请求的所有端点和关联数据。

指标集 说明 支持的指标
vitals.anrrate 包含 ANR 数据和使用情况数据，用于生成与用户数无关的标准化指标。 anrRate (google.type.Decimal)：在汇总期间遇到过至少 1 次 ANR 的不同用户所占的百分比。
anrRate7dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 7 天内，anrRate 指标的用户加权平均值。
anrRate28dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 28 天内，anrRate 指标的用户加权平均值。
userPerceivedAnrRate (google.type.Decimal)：在汇总 期间遇到过至少 1 次用户感知的 ANR 的不同用户所占的百分比。目前，系统仅统计 “输入调度”ANR。
userPerceivedAnrRate7dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 7 天内，userPerceivedAnrRate 指标的用户加权平均值。
userPerceivedAnrRate28dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 28 天内，userPerceivedAnrRate 指标的用户加权平均值。
distinctUsers (google.type.Decimal)：在汇总期间有可用数据的用户的大致数量。
vitals.crashrate 包含崩溃数据和使用情况数据，用于生成与用户数无关的标准化指标。 crashRate (google.type.Decimal)：在汇总 期间遇到过至少 1 次崩溃的不同用户所占的百分比。
crashRate7dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 7 天内，crashRate 指标的用户加权平均值。
crashRate28dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 28 天内，crashRate 指标的用户加权平均值。
userPerceivedCrashRate (google.type.Decimal)：在汇总 期间，在应用处于活跃使用状态时遇到过至少 1 次崩溃的不同用户所占的百分比。
userPerceivedCrashRate7dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 7 天内，userPerceivedCrashRate 指标的用户加权平均值。
userPerceivedCrashRate28dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 28 天内，userPerceivedCrashRate 指标的用户加权平均值。
distinctUsers (google.type.Decimal)：在汇总期间有可用数据的用户的大致数量。
vitals.lmkrate 包含 LMK（低内存终止）数据和使用情况数据，用于生成与用户数无关的标准化指标 。 userPerceivedLmkRate (google.type.Decimal)：在 汇总期间，在主动使用应用时遇到过至少 1 次 LMK（低内存终止）的不同用户所占的百分比。如果应用显示任何 activity 或执行任何前台服务，则被视为处于活跃使用状态。
userPerceivedLmkRate7dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 7 天内，userPerceivedLmkRate 指标的用户加权平均值。
userPerceivedLmkRate28dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 28 天内，userPerceivedLmkRate 指标的用户加权平均值。
distinctUsers (google.type.Decimal)：在汇总期间有可用数据的用户的大致数量。
vitals.excessivewakeuprate 包含 AlarmManager 唤醒次数数据和进程状态数据，用于生成与用户数无关的标准化指标。 excessiveWakeupRate (google.type.Decimal)：在 汇总期间，每小时唤醒次数超过 10 次的不同用户所占的百分比。 excessiveWakeupRate7dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 7 天内， excessiveWakeupRate 指标的用户加权平均值。
excessiveWakeupRate28dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 28 天内，excessiveWakeupRate 指标的用户加权平均值。
distinctUsers (google.type.Decimal)：在汇总期间有可用数据的用户的大致数量。
vitals.stuckbackgroundwakelockrate 包含 PowerManager 唤醒锁时长数据和进程状态数据，用于生成与用户数无关的标准化指标。 stuckBgWakelockRate (google.type.Decimal)：在 汇总期间，在后台持有唤醒锁超过 1 小时的不同用户所占的百分比。 stuckBgWakelockRate7dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 7 天内，stuckBgWakelockRate 指标的用户加权平均值。
stuckBgWakelockRate28dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 28 天内，stuckBgWakelockRate 指标的用户加权平均值。
distinctUsers (google.type.Decimal)：在汇总期间有可用数据的用户的大致数量。
vitals.slowstartrate 包含按应用启动类型（冷启动、温启动、热启动）细分的启动缓慢的应用数据。 slowStartRate (google.type.Decimal)：在 汇总期间，发生过启动缓慢事件的不同用户所占的百分比。 slowStartRate7dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 7 天内，slowStartRate 指标的用户加权平均值。
slowStartRate28dUserWeighted (google.type.Decimal)：在截至指定日期（含）的 28 天内，slowStartRate 指标的用户加权平均值。
distinctUsers (google.type.Decimal)：在汇总期间有可用数据的用户的大致数量。
vitals.errors.counts 包含未标准化的错误报告计数。 请注意 ：此资源目前仅在 API 的 v1 alpha 版中提供。
errorReportCount (google.type.Decimal)：为应用收到的各个错误报告的绝对计数。

维度

每个指标集都支持一组不同的维度，用于过滤和细分数据。如需查看 API 中提供的维度列表，请参阅下面的维度索引。

维度 说明
versionCode 在捕获数据时，用户设备上运行的应用的版本代码 。此维度的字符串值可以解析为整数。如需详细了解 Android 上的应用版本控制方式，请点击 此处 。
countryCode 根据用户的 IP 地址确定的用户所在国家或地区的标识符，以 2 个字母的 ISO-3166 代码表示 （例如，美国为 US）。

设备维度

这些维度特定于设备及其软件和硬件特征。

维度 说明
apiLevel 在捕获数据时，用户设备上运行的 Android 的 API 级别。 此维度的字符串值可以解析为整数。如需查看 Android 版本列表及其与 API 级别的对应关系，请点击 此处 。
deviceModel 特定设备型号的标识符，由 Play 管理中心设备目录定义。
deviceType 特定设备外形规格的标识符，由 Play 管理中心设备目录使用。
deviceRamBucket 设备的 RAM，以 MB 为单位，按存储分区划分（3GB、4GB 等）。
deviceSocMake 设备主系统芯片的制造商，例如 Samsung。请点击 此处。
deviceSocModel 设备主系统芯片的型号名称，例如“Exynos 2100”。请点击 此处。
deviceCpuMake 设备 CPU 的制造商，例如 Qualcomm。
deviceCpuModel 设备 CPU 的型号，例如“Kryo 240”。
deviceGpuMake 设备 GPU 的制造商，例如 ARM。
deviceGpuModel 设备 GPU 的型号，例如 Mali。
deviceGpuVersion 设备 GPU 的版本，例如 T750。
deviceVulkanVersion 设备的 Vulkan 版本，例如“4198400”。
deviceGlEsVersion 设备的 OpenGL ES 版本，例如“196610”。
deviceScreenSize 设备的屏幕尺寸，例如 NORMAL、LARGE。
deviceScreenDpi 设备的屏幕密度，例如 mdpi、hdpi。