获取桌面应用的洞察数据

2025-06-20

在 Microsoft 应用商店分析 API 中使用此方法，以获取与已添加到 Windows 桌面应用程序计划的桌面应用运行状况指标相关的洞察数据。合作伙伴中心桌面应用程序的健康报告中也提供了此数据。

先决条件

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

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

请求

请求语法

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

请求标头

标题	类型	DESCRIPTION
授权	字符串	必填。 Azure AD 访问令牌，形式为Bearer<token>。

请求参数

参数	类型	DESCRIPTION	必选
应用ID	字符串	用于获取产品分析数据的桌面应用程序的产品 ID。若要获取桌面应用程序的产品 ID，请在合作伙伴中心（如运行状况报告）中打开桌面应用程序的任何分析报告，并从 URL 检索产品 ID。如果未指定此参数，响应正文将包含注册到您帐户的所有应用的洞察数据。	否
开始日期	日期	要检索的见解数据的日期范围内的开始日期。默认值为当前日期之前的 30 天。	否
结束日期	日期	要检索的洞察数据日期范围的结束日期。默认值为当前日期。	否
过滤器	字符串	一个或多个用于筛选响应中行的语句。每个语句都包含响应正文中的字段名称和值，这些字段名称与 eq 或 ne 运算符相关联，语句可以使用和、或进行组合。字符串值必须用筛选器参数中的单引号括起来。例如，filter=dataType eq “acquisition”。目前此方法仅支持筛选器健康。	否

请求示例

以下示例说明获取洞察数据的请求。将 applicationId 值替换为桌面应用程序的相应值。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights?applicationId=10238467886765136388&startDate=6/1/2018&endDate=6/15/2018&filter=dataType eq 'health' HTTP/1.1
Authorization: Bearer <your access token>

响应

响应体

价值	类型	DESCRIPTION
价值	数组	包含应用见解数据的对象数组。有关每个对象数据的更详细信息，请参阅下面的洞察值部分。
总计数	整数 (int)	查询的数据结果中的行总数。

洞察价值

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

价值	类型	DESCRIPTION
应用ID	字符串	用于检索见解数据的桌面应用程序的产品 ID。
insightDate （洞察日期）	字符串	我们识别出特定指标变化的日期。此日期表示我们检测到指标与前一周相比显著增加或减少的一周结束。
数据类型	字符串	一个字符串，指定此见解所提供信息的通常分析领域。目前，此方法仅支持健康状况。
insightDetail	数组	一个或多个 InsightDetail 值，代表有关当前洞察的详细信息。

InsightDetail 的值

价值	类型	DESCRIPTION
事实名称	字符串	一个字符串，指示当前见解或当前维度描述的指标。目前，此方法仅支持 HitCount的值。
子维度	数组	一个或多个用于描述某个见解的单一指标的对象。
百分比变化	字符串	指标在整个客户群中变化的百分比。
维度名称	字符串	当前维度中描述的指标的名称。示例包括 EventType、 Market、 DeviceType 和 PackageVersion。
维度值	字符串	当前维度中描述的指标的值。例如，如果 DimensionName 是 EventType，那么 DimensionValue 可能是崩溃或挂起。
事实值	字符串	见解被检测出时的指标绝对值。
方向	字符串	变化的方向（正或负）。
日期	字符串	我们识别出与当前洞察或维度相关变化的日期。

响应示例

以下示例演示此请求的示例 JSON 响应正文。

{
  "Value": [
    {
      "applicationId": "9NBLGGGZ5QDR",
      "insightDate": "2018-06-03T00:00:00",
      "dataType": "health",
      "insightDetail": [
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "21",
              "DimensionValue:": "DE",
              "FactValue": "109",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "crash",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "71",
              "DimensionValue:": "JP",
              "FactValue": "112",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "hang",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
      ],
      "insightId": "9CY0F3VBT1AS942AFQaeyO0k2zUKfyOhrOHc0036Iwc="
    }
  ],
  "@nextLink": null,
  "TotalCount": 2
}

Windows 桌面应用程序程序
健康报告
通过 Microsoft 应用商店服务获取分析数据

通过