在 Microsoft Store 分析 API 中使用此方法，針對透過 Xbox 開發人員入口網站 (XDP) 提交的 UWP 應用程式和 Xbox One 遊戲取得 JSON 格式的匯總的取得資料，該資料可在 XDP Analytics 儀表板中查看。
注意
此 API 不會在 2016 年 10 月 1 日前提供每日匯總資料。
必要條件
要使用此方法，您需要先執行以下操作：
- 如果您尚未執行此操作，請完成 Microsoft Store 分析 API 的所有必要條件。
- 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後，您可以取得新的權杖。
請求
請求語法
| 方法 | 要求 URI |
|---|---|
| 獲取 | https://manage.devcenter.microsoft.com/v1.0/my/analytics/acquisitions |
請求標頭
| 標題 | 類型 | 描述 |
|---|---|---|
| 授權 | 字串 | 必要。 Azure AD 存取令牌的格式為Bearer<token>。 |
要求參數
| 參數 | 類型 | 描述 | 必要 |
|---|---|---|---|
| 應用程式ID | 字串 | 您要擷取下載資料之 Xbox One 遊戲的產品識別碼。 若要取得遊戲的產品識別碼 ，請瀏覽至 XDP Analytics 計畫中的遊戲，並從 URL 擷取產品識別碼。 或者，如果您從合作夥伴中心分析報告中下載您的取得資料，產品識別碼會包含在 .tsv 檔案中。 | 是的 |
| 開始日期 | 日期 | 要擷取獲取資料的日期範圍的開始日期。 預設值是目前的日期。 | 否 |
| 結束日期 | 日期 | 要擷取資料日期範圍的結束日期。 預設值是目前的日期。 | 否 |
| 篩選器 | 字串 | 篩選回應中的資料列的一或多個語句。 每個陳述式都包含回應正文的欄位名稱，以及與 eq 或 ne 運算子相關聯的值，而且可以使用 and 或 or 結合陳述式。 字串值必須以篩選參數中的單引號括住。 例如，filter=market eq 'US' and gender eq 'm'。 您可以從回應主體指定下列欄位：
|
否 |
| 聚合層級 | 字串 | 指定要擷取彙總資料的時間範圍。 可以是下列其中一個字串：day、week 或 month。 如果未指定，則預設值為 day。 | 否 |
| 排序依据 | 字串 | 對每個取得的結果數據值進行排序的語句。 語法為 orderby=field [order],field [order],...。field 參數可以是下列其中一個字串：
|
否 |
| 按群組分類 | 字串 | 僅將資料彙總套用至指定欄位的陳述式。 您可以指定下列欄位：
|
否 |
要求範例
下列範例示範數個取得 Xbox One 遊戲獲取資料的要求。 以遊戲的產品識別碼取代 applicationId 值。
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/acquisitions?applicationId=9WZDNCRFHXHT&startDate=1/1/2017&endDate=2/1/2019&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/acquisitions?applicationId=9WZDNCRFHXHT&startDate=1/1/2017&endDate=2/1/2019&skip=0&filter=market eq 'US' and gender eq 'm' HTTP/1.1
Authorization: Bearer <your access token>
回應
回應內容
| 值 | 類型 | 描述 |
|---|---|---|
| 值 | 陣列 | 包含遊戲整體取得數據的物件陣列。 如需關於每個物件中的資料的詳細資訊，請參閱下方的「下載值」一節。 |
| 總計數 | 整數 | 查詢的資料結果中的總列數。 |
取得值
Value 陣列中的元素包含下列值。
| 值 | 類型 | 描述 |
|---|---|---|
| 日期 | 字串 | 下載資料之日期範圍中的第一個日期。 如果要求指定了單天，這個值就是該日期。 如果要求指定了一週、月或其他日期範圍，這個值就是該日期範圍中的第一個日期。 |
| 應用程式ID | 字串 | 您要擷取下載資料之 Xbox One 遊戲的產品識別碼。 |
| 應用程式名稱 | 字串 | 遊戲的顯示名稱 |
| 取得類型 | 字串 | 下列其中一個字串，指出獲取的類型：
|
| 年齡 | 字串 | 以下其中一個字串，表示進行下載的使用者的年齡群組：
|
| 裝置類型 | 字串 | 以下其中一個字串，指定完成購買的裝置類型：
|
| 性別 | 字串 | 下列其中一個字串，指定進行下載的使用者性別：
|
| 市場 | 字串 | 發生獲取之市場的 ISO 3166 國家/地區代碼。 |
| 作業系統版本 | 字串 | 發生獲取時的作業系統版本。 針對此方法，此值一律為 Windows 10 或 Windows 11。 |
| 支付工具類型 | 字串 | 下列其中一個字串，指出用於下載的付款指示：
|
| sandboxId | 字串 | 為遊戲建立的沙箱識別碼。 這可以是 RETAIL 值或私人沙盒識別碼。 |
| storeClient | 字串 | 以下其中一個字串，表示取得 Store 的版本所在位置：
|
| xboxTitleId | 字串 | 適用於 Xbox Live 遊戲的 Xbox 開發人員入口網站 (XDP) 指派的 Xbox Live 標題識別碼 (以十六進位值表示)。 |
| 獲取數量 | 數字 | 指定匯總層級期間發生的收購數量。 |
| 購買價格(美元)amount | 數字 | 客戶為購買所支付的金額，使用每月匯率轉換為美元。 |
| 購買稅金美元金額 | 數字 | 適用於取得的稅額，轉換成美元。 |
| 本地貨幣代碼 | 字串 | 以合作夥伴中心帳戶國家/地區為基礎的當地貨幣代碼。 |
| Xbox 產品識別碼 (xboxProductId) | 字串 | 如果適用的話，來自 XDP 的產品 Xbox 產品識別碼。 |
| 可用性ID | 字串 | 如果適用的話，來自 XDP 的產品可用識別碼。 |
| skuId 的 | 字串 | 如果適用，則為 XDP 產品 SKU 識別碼。 |
| skuDisplayName | 字串 | 如果適用，XDP 的產品 SKU 顯示名稱。 |
| xboxParentProductId | 字串 | 如果適用的話，來自 XDP 的產品 Xbox 上層產品識別碼。 |
| 父產品名稱 | 字串 | 如果適用，來自 XDP 的母產品名稱。 |
| 產品類型名稱 | 字串 | 如果適用的話，來自 XDP 產品的產品類型名稱。 |
| 購買稅類型 | 字串 | 如果適用，XDP 產品的購買稅類型。 |
| 購買價格當地金額 | 數字 | 如果適用，來自 XDP 產品的購買價格當地金額。 |
| 購買稅本地金額 | 數字 | 如果適用，來自 XDP 產品的購物稅當地金額。 |
回應範例
下列示範展示此要求的 JSON 回應本文。
{
"Value": [
{
"date": "2019-01-15T01:00:00.0000000Z",
"applicationId": "9WZDNCRFHXHT",
"applicationName": null,
"acquisitionType": "Paid",
"age": null,
"deviceType": "Phone",
"gender": null,
"market": "US",
"osVersion": "Windows 11",
"paymentInstrumentType": null,
"sandboxId": "RETAIL",
"storeClient": "Microsoft Store (client)",
"xboxTitleId": null,
"localCurrencyCode": "USD",
"xboxProductId": null,
"availabilityId": "B42LRTSZ2MCJ",
"skuId": "0010",
"skuDisplayName": null,
"xboxParentProductId": null,
"parentProductName": null,
"productTypeName": "Game",
"purchaseTaxType": "TaxesNotIncluded",
"acquisitionQuantity": 1,
"purchasePriceUSDAmount": 3.08,
"purchasePriceLocalAmount": 3.08,
"purchaseTaxUSDAmount": 0.09,
"purchaseTaxLocalAmount": 0.09
}
],
"@nextLink": null,
"TotalCount": 12221
}