取得深入解析資料
在 Microsoft Store 分析 API 中使用此方法，在特定日期範圍期間和其他選擇性篩選條件取得與應用程式的獲取、健康情況和使用計量相關的深入解析資料。 此資訊也可在合作夥伴中心的深入解析報告中取得。
必要條件
要使用此方法，您需要先執行以下操作：
- 如果您尚未執行此操作，請完成 Microsoft Store 分析 API 的所有必要條件。
- 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後，您可以取得新的權杖。
Request
要求語法
| 方法 | 要求 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights |
要求標頭
| 標題 | 類型 | 描述 |
|---|---|---|
| 授權 | 字串 | 必要。 持有人<權杖>形式的 Azure AD 存取權杖。 |
要求參數
| 參數 | 類型 | 描述 | 必要 |
|---|---|---|---|
| applicationId | 字串 | 您想要擷取深入解析資料之應用程式的 Store ID。 如果您未指定此參數，回應本文將會包含向您的帳戶註冊之所有應用程式的深入解析資料。 | 否 |
| startDate | date | 要擷取深入解析資料之日期範圍的開始日期。 預設值為目前日期的前 30 天。 | 否 |
| endDate | date | 要擷取深入解析資料之日期範圍的結束日期。 預設值是目前的日期。 | 否 |
| 篩選器 | 字串 | 篩選回應中的資料列的一或多個陳述式。 每個陳述式都包含回應本文的功能變數名稱，以及與 eq 或 ne 運算子相關聯的值，而且可以使用 and 或 or 結合陳述式。 字串值必須以 filter 參數中的單引號括住。 例如，filter=dataType eq 'acquisition'。 您可以指定下列篩選功能變數：
|
是 |
要求範例
下列範例示範取得深入解析資料的要求。 以您應用程式的 Store ID 取代 applicationId 值。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=6/1/2018&endDate=6/15/2018&filter=dataType eq 'acquisition' or dataType eq 'health' HTTP/1.1
Authorization: Bearer <your access token>
回應
回應本文
| 值 | 類型 | 描述 |
|---|---|---|
| 值 | 陣列 | 物件的陣列，其中包含應用程式的深入解析資料。 如需關於每個物件中的資料的詳細資訊，請參閱下方的深入解析值一節。 |
| TotalCount | int | 查詢的資料結果中的總列數。 |
深入解析值
Value 陣列中的元素包含下列值。
| 值 | 類型 | 描述 |
|---|---|---|
| applicationId | 字串 | 您正在擷取深入解析資料之應用程式的 Store ID。 |
| insightDate | 字串 | 我們在特定計量中發現變更的日期。 此日期代表我們在計量中偵測到與前一週相比，有顯著增加或減少情形的當週結束日。 |
| dataType | 字串 | 下列其中一個字串，指定此深入解析所描述的一般分析區域：
|
| insightDetail | 陣列 | 一或多個 InsightDetail 值，代表目前深入解析的詳細資料。 |
InsightDetail 值
| 值 | 類型 | 描述 |
|---|---|---|
| FactName | 字串 | 下列其中一個值，根據 dataType 值描述的計量指出目前深入解析或目前維度。
|
| SubDimensions | 陣列 | 描述深入解析單一計量的一或多個物件。 |
| PercentChange | 字串 | 計量在整個客戶群中變更的百分比。 |
| DimensionName | 字串 | 目前維度中所述的計量名稱。 範例包括 EventType、Market、DeviceType、PackageVersion、AcquisitionType、AgeGroup 和 Gender。 |
| DimensionValue | 字串 | 目前維度中所述的計量值。 例如，如果 DimensionName 是 EventType，DimensionValue 可能是 crash 或 hang。 |
| FactValue | 字串 | 偵測到深入解析之日期的計量絕對值。 |
| 方向 | 字串 | 變更的方向 (Positive 或 Negative)。 |
| Date | 字串 | 我們發現與目前深入解析或目前維度相關變更的日期。 |
注意
擷取的深入解析變更僅適用最後 30 天的獲取、健康情況和/或使用量資料。
要求和回應範例
下列程式碼片段示範一些要求的範例要求和 JSON 回應本文。
範例要求
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=7/12/2022&endDate=7/29/2022&filter=dataType eq 'acquisition' or dataType eq 'health'
HTTP/1.1
Authorization: Bearer <your access token>
範例回應
{
"Value": [
{
"id": "8cdb672c7893bd33a3dec48ededdc676602a1361f3209ab4f3e0982672fc198f",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-27T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-27 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-27 00:00:00",
"Direction": "Positive",
"PercentChange": 16.091954022988507,
"FactName": "AcquisitionQuantity",
"FactQuantity": 28.0
}
]
}
]
},
{
"id": "6b8849ecb043c6e5ecdd1c20040c0a371e9ab176eff77f7312b0489e19379225",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-26T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-26 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-26 00:00:00",
"Direction": "Positive",
"PercentChange": 28.048780487804876,
"FactName": "AcquisitionQuantity",
"FactQuantity": 30.0
}
]
}
]
},
{
"id": "93115e855fec507385bab17251f49c33bcbc1b62c603e5c7863e327ba94bf160",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-20T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-20 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "GB",
"Date": "2022-07-20 00:00:00",
"Direction": "Negative",
"PercentChange": 3.3035714285714284,
"FactName": "AcquisitionQuantity",
"FactQuantity": 158.0
}
]
}
]
},
{
"id": "4814abe710042a2798b453d8821909c246c389dde814e6678da7189211410604",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-24T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-24 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "DO",
"Date": "2022-07-24 00:00:00",
"Direction": "Negative",
"PercentChange": 13.533834586466165,
"FactName": "AcquisitionQuantity",
"FactQuantity": 8.0
}
]
}
]
},
{
"id": "7941070bb17904f3ef4e19de9659110cb52e18ecfb637ad724e2da749445a860",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-21T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "AT",
"Date": "2022-07-21 00:00:00",
"Direction": "Positive",
"PercentChange": 0.0,
"FactName": "AcquisitionQuantity",
"FactQuantity": 17.0
}
]
},
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "SE",
"Date": "2022-07-21 00:00:00",
"Direction": "Negative",
"PercentChange": 21.686746987951807,
"FactName": "AcquisitionQuantity",
"FactQuantity": 5.0
}
]
}
]
},
{
"id": "55905f5458617b65669eb115cc28ebd7296841bd2ff3f8e2546ade1d5e93f68d",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-13T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-13 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "LK",
"Date": "2022-07-13 00:00:00",
"Direction": "Negative",
"PercentChange": 11.111111111111111,
"FactName": "AcquisitionQuantity",
"FactQuantity": 9.0
}
]
}
]
},
{
"id": "9ce9317bf4d0f903de51a49d00a07cf4b4a8ac4457fd1e2886493bd38ceac0b7",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-19T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "Acquisition",
"DimensionValue": "Free",
"Date": "2022-07-19 00:00:00",
"Direction": "Negative",
"PercentChange": 12.188725230475788,
"FactName": "AcquisitionQuantity",
"FactQuantity": 2470,
"SubDimensions": []
}
]
}
],
"TotalCount": 7
}