获取游戏和应用的购置数据Get acquisitions data for your games and apps

• 03/06/2019
• • h
  • o
  • t

在 Microsoft Store analytics API 中使用此方法，以 JSON 格式获取针对 UWP 应用的聚合获取数据，并使用 xbox 开发人员门户 (XDP) ，并在 XDP Analytics 仪表板中可用。Use this method in the Microsoft Store analytics API to get aggregate acquisition data in JSON format for UWP apps and Xbox One games that were ingested through the Xbox Developer Portal (XDP) and available in the XDP Analytics dashboard.

必备条件Prerequisites

若要使用此方法，首先需要执行以下操作：To use this method, you need to first do the following:

• 完成 Microsoft Store 分析 API 的所有先决条件（如果尚未这样做）。If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
• 获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。Obtain an Azure AD access token to use in the request header for this method. 获取访问令牌后，在它到期前，你有 60 分钟的使用时间。After you obtain an access token, you have 60 minutes to use it before it expires. 该令牌到期后，可以获取新的令牌。After the token expires, you can obtain a new one.

请求Request

请求语法Request syntax

请求头Request header

请求参数Request parameters

请求示例Request example

以下示例演示用于获取 Xbox One 游戏购置数据的多个请求。The following example demonstrates several requests for getting Xbox One game acquisition data. 用游戏的产品 ID 替换 applicationId 值。Replace the applicationId value with the product ID for your game.

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> 

响应Response

响应正文Response body

购置值Acquisition values

Value 数组中的元素包含以下值。Elements in the Value array contain the following values.

响应示例Response example

以下示例举例说明此请求的 JSON 响应正文。The following example demonstrates an example JSON response body for this request.

{ 
    "Value": [ 
        { 
            "date": "2019-01-15T01:00:00.0000000Z", 
            "applicationId": "9WZDNCRFHXHT", 
            "applicationName": null, 
            "acquisitionType": "Paid", 
            "age": null, 
            "deviceType": "Phone", 
            "gender": null, 
            "market": "US", 
            "osVersion": "Windows 10", 
            "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 
}