获取每日应用使用情况
在 Microsoft Store 分析 API 中使用此方法，以 JSON 格式获取给定日期范围（仅限最近 90 天）和其他可选筛选器条件下某个应用程序的聚合使用情况数据（不包括 Xbox 多人游戏）。 还可以在合作伙伴中心的使用情况报告中获取此信息。
在设备级别收集基于 Anaheim 的 PWA 应用的遥测数据。 因此，与用户相关的指标不适用于此类产品。 请参阅下面的“使用情况值”部分，以了解有关字段有效性的更多详细信息。
先决条件
若要使用此方法，首先需要执行以下操作：
- 完成 Microsoft Store 分析 API 的所有先决条件（如果尚未这样做）。
- 获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。 获取访问令牌后，在它到期前，你有 60 分钟的使用时间。 该令牌到期后，可以获取新的令牌。
请求
请求语法
| 方法 | 请求 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily |
请求头
| 标头 | 类型 | 说明 |
|---|---|---|
| 授权 | 字符串 | 必需。 Azure AD 访问令牌的格式为 Bearertoken<>。 |
请求参数
请求示例
以下示例演示了请求获取每日应用使用情况数据的请求。 将 applicationId 值替换为你的应用的 Store ID。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily?applicationId=XXXXXXXXXXXX&startDate=2018-08-10&endDate=2018-08-14 HTTP/1.1
Authorization: Bearer <your access token>
响应
响应正文
| 值 | 类型 | 说明 |
|---|---|---|
| Value | 数组 | 包含聚合使用情况数据的对象数组。 有关每个对象中的数据的详细信息，请参阅下表。 |
| @nextLink | string | 如果存在其他数据页，则此字符串包含一个你可用来请求下一页数据的 URI。 例如，当请求的 top 参数设置为 10000，但查询的评论数据超过 10000 行时，将会返回此值。 |
| TotalCount | int | 查询的数据结果中的行总数。 |
使用情况值
Value 数组中的元素包含以下值。
| Value | 类型 | 描述 | UWP 可用性 | 基于 Anaheim 的 PWA 可用性 | Xbox 可用性 |
|---|---|---|---|---|---|
| date | string | 使用情况数据的日期范围内的第一个日期。 如果请求指定了某一天，此值就是该日期。 如果请求指定了一周、月或其他日期范围，此值是该日期范围内的第一个日期。 | 是 | 是 | 是 |
| applicationId | string | 要检索使用情况数据的应用的 Store ID。 | 是 | 是 | 是 |
| applicationName | string | 应用的显示名称。 | 是 | 是 | 是 |
| deviceType | string | 以下字符串之一，用于指定使用时所用设备的类型：
|
是 | 是 | 是 |
| packageVersion | string | 使用发生时所在的包版本。 | 是 | 是 | 否 |
| market | string | 客户使用应用时所在市场的 ISO 3166 国家/地区代码。 | 是 | 是 | 是 |
| subscriptionName | string | 指示使用情况是否通过 Xbox Game Pass。 | 是 | 否 | 否 |
| dailySessionCount | long | 该日的用户会话数。 | 是 | 是 | 是 |
| engagementDurationMinutes | double | 用户主动使用你的应用的分钟数，度量时间为一个特定时间段，从应用启动（进程开始）时开始计算，到应用终止（进程结束）或处于非活动状态一段时间后结束。 | 是 | 是 | 是 |
| dailyActiveUsers | long | 该日使用应用的客户数。 | 是 | No | 是 |
| dailyActiveDevices | long | 所有用户每日用于与你的应用交互的设备数量。 | 是 | 是 | 是 |
| dailyNewUsers | long | 该日第一次使用应用的客户数。 | 是 | No | 是 |
| monthlyActiveUsers | long | 该月使用应用的客户数。 | 是 | No | 是 |
| monthlyActiveDevices | long | 一个不同时间段内运行应用的设备数，从应用启动（进程开始）开始算起，到应用终止（进程结束）或处于非活动状态一段时间后结束。 | 是 | 是 | 是 |
| monthlyNewUsers | long | 当月第一次使用应用的客户数。 | 是 | No | 是 |
| dailyNewDevices | long | 这一天首次使用此应用的客户数量。 | 否 | 是 | 否 |
| monthlyNewDevices | long | 在过去的 30 天内首次使用此应用的客户数量。 | 否 | 是 | 否 |
注意
如果一个字段对特定的产品无效，在响应中会将这些字段的值作为 0 或 null 发送。 新用户和新设备的计算是使用 3 年期的滚动窗口完成的，也就是说，如果用户/设备在 3 年和更长的时间内未使用应用程序，将在 3 年后将其视为新的用户/设备。
请求和响应示例
如下代码片段展示了这些请求的一些示例请求和 JSON 响应正文。
示例请求
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>
示例响应
{
"Value": [
{
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"deviceType": "All",
"packageVersion": "All",
"market": "All",
"dailySessionCount": 6102,
"engagementDurationMinutes": 75801.0,
"dailyActiveUsers": 3866,
"dailyActiveDevices": 3855,
"dailyNewUsers": 2041,
"monthlyActiveUsers": 85206,
"monthlyActiveDevices": 88995,
"monthlyNewUsers": 63184,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
}
],
"TotalCount": 1
}
示例请求
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily?applicationId=9NBLGGGZ5QDR&startDate=06/19/2022&endDate=07/20/2022&top=10&skip=0&groupby=applicationName,subscriptionName,deviceType,packageVersion,market,date
HTTP/1.1
Authorization: Bearer <your access token>
示例响应
{
"Value": [
{
"date": "2022-07-11",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "1.4.0.17837",
"market": "BR",
"dailySessionCount": 1,
"engagementDurationMinutes": 35.2,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 1,
"monthlyActiveDevices": 1,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-07-04",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AD",
"dailySessionCount": 1,
"engagementDurationMinutes": 2.7,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 1,
"monthlyActiveDevices": 1,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-24",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AE",
"dailySessionCount": 2,
"engagementDurationMinutes": 2.9,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 2,
"monthlyActiveDevices": 2,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-07-08",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AE",
"dailySessionCount": 1,
"engagementDurationMinutes": 0.5,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 2,
"monthlyActiveDevices": 2,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-26",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AO",
"dailySessionCount": 1,
"engagementDurationMinutes": 1.2,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 1,
"monthlyActiveDevices": 1,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-19",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 1,
"engagementDurationMinutes": 1.0,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 40,
"monthlyActiveDevices": 40,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-20",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 2,
"engagementDurationMinutes": 10.9,
"dailyActiveUsers": 2,
"dailyActiveDevices": 2,
"dailyNewUsers": 0,
"monthlyActiveUsers": 42,
"monthlyActiveDevices": 42,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 6,
"engagementDurationMinutes": 32.8,
"dailyActiveUsers": 3,
"dailyActiveDevices": 3,
"dailyNewUsers": 0,
"monthlyActiveUsers": 44,
"monthlyActiveDevices": 43,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 1,
"engagementDurationMinutes": 0.1,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 43,
"monthlyActiveDevices": 42,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-23",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 2,
"engagementDurationMinutes": 0.3,
"dailyActiveUsers": 2,
"dailyActiveDevices": 2,
"dailyNewUsers": 0,
"monthlyActiveUsers": 42,
"monthlyActiveDevices": 42,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
}
],
"@nextLink": "usagedaily?applicationId=9NBLGGGZ5QDR&startDate=2022/06/19&endDate=2022/07/21&groupby=applicationName,subscriptionName,deviceType,packageVersion,market,date&top=10&skip=10",
"TotalCount": 765
}
相关主题
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈