取得傳統型應用程式的深入解析資料

  • 發行項

在 Microsoft Store 分析 API 中使用此方法，取得已新增至 Windows 傳統型應用程式計畫之傳統型應用程式健康情況計量的相關深入解析資料。 此資料也可在合作夥伴中心傳統型應用程式的健康情況報告中取得。

必要條件

要使用此方法，您需要先執行以下操作：

  • 如果您尚未執行此操作，請完成 Microsoft Store 分析 API 的所有必要條件。
  • 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後，您可以取得新的權杖。

要求

要求語法

方法 要求 URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights

要求標頭

標題 類型 描述
授權 字串 必要。 持有人<權杖>形式的 Azure AD 存取權杖。

要求參數

參數 類型 描述 必要
applicationId 字串 您想要取得深入解析資料之傳統型應用程式的產品識別碼。 若要取得傳統型應用程式的產品識別碼，請在合作夥伴中心開啟傳統型應用程式的任何分析報告 (例如健康情況報告)，並從 URL 擷取產品識別碼。 如果您未指定此參數，回應本文將會包含向您的帳戶註冊之所有應用程式的深入解析資料。 否
startDate date 要擷取深入解析資料之日期範圍的開始日期。 預設值為目前日期的前 30 天。 否
endDate date 要擷取深入解析資料之日期範圍的結束日期。 預設值是目前的日期。 否
篩選器 字串 篩選回應中的資料列的一或多個陳述式。 每個陳述式都包含回應本文的功能變數名稱，以及與 eq 或 ne 運算子相關聯的值，而且可以使用 and 或 or 結合陳述式。 字串值必須以 filter 參數中的單引號括住。 例如，filter=dataType eq 'acquisition'。

目前這個方法只支援篩選 health。

 否

要求範例

下列範例示範取得深入解析資料的要求。 將 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>

回應

回應本文

值 類型 描述
值 陣列 物件的陣列，其中包含應用程式的深入解析資料。 如需關於每個物件中的資料的詳細資訊，請參閱下方的深入解析值一節。
TotalCount int 查詢的資料結果中的總列數。

深入解析值

Value 陣列中的元素包含下列值。

值 類型 描述
applicationId 字串 您已擷取深入解析資料之傳統型應用程式的產品識別碼。
insightDate 字串 我們在特定計量中發現變更的日期。 此日期代表我們在計量中偵測到與前一週相比，有顯著增加或減少情形的當週結束日。
dataType 字串 指定此深入解析所通知之一般分析區域的字串。 目前，此方法僅支援 health。
insightDetail 陣列 一或多個 InsightDetail 值，代表目前深入解析的詳細資料。

InsightDetail 值

值 類型 描述
FactName 字串 指出目前深入解析或目前維度所描述之計量的字串。 目前，此方法僅支援值 HitCount。
SubDimensions 陣列 描述深入解析單一計量的一或多個物件。
PercentChange 字串 計量在整個客戶群中變更的百分比。
DimensionName 字串 目前維度中所述的計量名稱。 範例包括 EventType、Market、DeviceType 和 PackageVersion。
DimensionValue 字串 目前維度中所述的計量值。 例如，如果 DimensionName 是 EventType，DimensionValue 可能是 crash 或 hang。
FactValue 字串 偵測到深入解析之日期的計量絕對值。
方向 字串 變更的方向 (Positive 或 Negative)。
Date 字串 我們發現與目前深入解析或目前維度相關變更的日期。

回應範例

下列範例示範此要求的範例 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
}