获取每日应用使用情况

2025-06-10

在 Microsoft Store 分析 API 中使用此方法，以 JSON 格式获取给定日期范围（仅限最近 90 天）和其他可选筛选器条件下某个应用程序的聚合使用情况数据（不包括 Xbox 多人游戏）。还可以在合作伙伴中心的使用情况报告中获取此信息。

在设备级别收集基于 Anaheim 的 PWA 应用的遥测数据。因此，与用户相关的指标不适用于此类产品。请参阅下面的“使用情况值”部分，以了解有关字段有效性的更多详细信息。

先决条件

若要使用此方法，首先需要执行以下操作：

完成 Microsoft Store 分析 API 的所有先决条件（如果尚未这样做）。
获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。获取访问令牌后，在它到期前，你有 60 分钟的使用时间。该令牌到期后，可以获取新的令牌。

请求

请求语法

方法	请求 URI
获取	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily`

请求头

标头	类型	说明
授权	字符串	必需。 Azure AD 访问令牌的格式为 Bearer<>。

请求参数

参数	类型	说明	必需
应用ID	字符串	要检索其评论数据的应用的 Store ID。	是
开始日期	日期	要检索的评论数据日期范围中的开始日期。默认是当前日期。	否
结束日期	日期	要检索的评论数据日期范围中的结束日期。默认是当前日期。	否
顶部	整数 (int)	要在请求中返回的数据行数。如果未指定，最大值和默认值为 10000。当查询中存在多行数据时，响应正文中包含的下一个链接可用于请求下一页数据。	否
跳过	整数 (int)	要在查询中跳过的行数。使用此参数可以浏览较大的数据集。例如，top=10000 和 skip=0，将检索前 10000 行数据；top=10000 和 skip=10000，将检索之后的 10000 行数据，依此类推。	否
过滤器	字符串	在响应中筛选行的一条或多条语句。每条语句包含的响应正文中的字段名称和值使用 eq 或 ne 运算符进行关联，并且语句可以使用 and 或 or 进行组合。 filter 参数中的字符串值必须使用单引号引起来。可以指定响应正文中的以下字段：市场设备类型软件包版本	否
排序	字符串	对结果数据值进行排序的语句。语法为 orderby=field [order],field [order],...，其中 field 参数可以是以下字符串之一：日期应用程序 ID 应用程序名称市场软件包版本设备类型订阅名称每日会话次数互动时长分钟每日活跃用户 dailyActiveDevices 每日新用户月活跃用户每月活跃设备每月新增用户每日新增设备每月新设备 order 参数是可选的，可以是 asc 或 desc，用于指定每个字段的升序或降序排列。默认值为 asc。下面是一个 orderby 字符串的示例：orderby=date,market	否
按组分类	字符串	仅将数据聚合应用于指定字段的语句。可以指定响应正文中的以下字段：应用程序名称订阅名称设备类型软件包版本市场日期返回的数据行将包含 groupby 参数中指定的字段以及以下字段：应用程序 ID 订阅名称每日会话次数互动时长分钟每日活跃用户 dailyActiveDevices 每日新用户月活跃用户每月活跃设备每月新增用户每日新增设备每月新设备 groupby 参数可以与 aggregationLevel 参数结合使用。例如：&groupby=ageGroup,market&aggregationLevel=week	否

请求示例

以下示例演示了请求获取每日应用使用情况数据的请求。将 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>

响应

响应正文

值	类型	说明
值	数组	包含聚合使用情况数据的对象数组。有关每个对象中的数据的详细信息，请参阅下表。
@nextLink	字符串	如果存在其他数据页，则此字符串包含一个你可用来请求下一页数据的 URI。例如，当请求的 top 参数设置为 10000，但查询的评论数据超过 10000 行时，将会返回此值。
总计数	整数 (int)	查询的数据结果中的行总数。

使用情况值

Value 数组中的元素包含以下值。

值	类型	说明	UWP 可用性	基于 Anaheim 的 PWA 可用性	Xbox 可用性
日期	字符串	使用情况数据的日期范围内的第一个日期。如果请求指定了某一天，此值就是该日期。如果请求指定了一周、月或其他日期范围，此值是该日期范围内的第一个日期。	是	是	是
应用ID	字符串	要检索使用情况数据的应用的 Store ID。	是	是	是
应用程序名称	字符串	应用的显示名称。	是	是	是
设备类型	字符串	以下字符串之一，用于指定使用时所用设备的类型：电脑电话 Console-Xbox One Console-Xbox 系列 X 平板电脑物联网服务器全息未知	是	是	是
软件包版本	字符串	使用发生时所在的包版本。	是	是	否
市场	字符串	客户使用应用时所在市场的 ISO 3166 国家/地区代码。	是	是	是
订阅名称	字符串	指示使用情况是否通过 Xbox Game Pass。	是	否	否
每日会话计数	长整型	该日的用户会话数。	是	是	是
参与持续时间（分钟）	翻倍	用户主动使用你的应用的分钟数，度量时间为一个特定时间段，从应用启动（进程开始）时开始计算，到应用终止（进程结束）或处于非活动状态一段时间后结束。	是	是	是
每日活跃用户	长整型	该日使用应用的客户数。	是	否	是
dailyActiveDevices	长整型	所有用户每日用于与你的应用交互的设备数量。	是	是	是
每日新增用户	长整型	该日第一次使用应用的客户数。	是	否	是
每月活跃用户	长整型	该月使用应用的客户数。	是	否	是
每月活跃设备	长整型	一个不同时间段内运行应用的设备数，从应用启动（进程开始）开始算起，到应用终止（进程结束）或处于非活动状态一段时间后结束。	是	是	是
每月新增用户	长整型	当月第一次使用应用的客户数。	是	否	是
每日新增设备	长整型	这一天首次使用此应用的客户数量。	否	是	否
每月新增设备	长整型	在过去的 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
}

通过

获取每日应用使用情况

先决条件

请求

请求语法

请求头

请求参数

请求示例

响应

响应正文

使用情况值

请求和响应示例

示例请求

示例响应

示例请求

示例响应

相关主题

反馈

其他资源