게임 및 앱에 대한 추가 기능 취득 데이터 가져오기

Microsoft Store 분석 API에서 이 방법을 사용하여 XDP(Xbox 개발자 포털)를 통해 수집되고 XDP 분석 파트너 센터 대시보드에서 사용할 수 있는 UWP 앱 및 Xbox One 게임에 대한 JSON 형식의 집계 추가 기능 획득 데이터를 가져옵니다.

필수 조건

이 메서드를 사용하려면 먼저 다음 방법대로 해야 합니다.

• 아직 완료하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 조건을 완료합니다.
• 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져오세요. 액세스 토큰을 얻은 후 사용 가능한 시간은 만료되기 전까지 60분입니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.

요청

요청 구문

요청 헤더

요청 매개 변수

applicationId 또는 addonProductId 매개 변수가 필요합니다. 앱에 등록된 모든 추가 기능의 획득 데이터를 검색하려면 applicationId 매개변수를 지정하세요. 단일 추가 기능에 대한 구입 데이터를 검색하려면 addonProductId 매개 변수를 지정합니다. 둘 다 지정하면 applicationId 매개변수가 무시됩니다.

요청 예시

다음 예제에서는 추가 기능 획득 데이터를 가져오기 위한 여러 가지 요청을 보여줍니다. addonProductId 및 applicationId 값을 추가 기능 또는 앱에 대한 Store ID로 적절하게 바꿉니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/addonacquisitions?applicationId=9WZDNCRFJ314&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1 

Authorization: Bearer <your access token> 

 

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/addonacquisitions?applicationId=9WZDNCRFJ314&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0&filter=market eq 'GB' and gender eq 'm' HTTP/1.1 

Authorization: Bearer <your access token>

응답

응답 본문

추가 기능 획득 값

값 배열의 요소에는 다음의 값이 포함됩니다.

응답 예시

다음 예제에서는 이 요청에 대한 JSON 응답 본문의 예를 보여줍니다.

{ 
  "Value": [ 
    { 
            "inAppProductId": "9NBLGGH1864K", 
            "inAppProductName": "866879", 
            "addonProductId": "9NBLGGH1864K", 
            "addonProductName": "866879", 
            "date": "2017-11-05", 
            "applicationId": "9WZDNCRFJ314", 
            "applicationName": "Tetris Blitz", 
            "acquisitionType": "Iap", 
            "age": "35-49", 
            "deviceType": "Phone", 
            "gender": "m", 
            "market": "US", 
            "osVersion": "Windows Phone 8.1", 
            "paymentInstrumentType": "Credit Card", 
            "sandboxId": "RETAIL", 
            "storeClient": "Windows Phone Store (client)", 
            "xboxTitleId": "", 
            "localCurrencyCode": "USD", 
            "xboxProductId": "00000000-0000-0000-0000-000000000000", 
            "availabilityId": "", 
            "skuId": "", 
            "skuDisplayName": "Full", 
            "xboxParentProductId": "", 
            "parentProductName": "Tetris Blitz", 
            "productTypeName": "Add-On", 
            "purchaseTaxType": "", 
            "acquisitionQuantity": 1, 
            "purchasePriceUSDAmount": 1.08, 
            "purchasePriceLocalAmount": 0.09, 
            "purchaseTaxUSDAmount": 1.08, 
            "purchaseTaxLocalAmount": 0.09 
        } 
    ], 

    "@nextLink": null, 
    
    "TotalCount": 7601 
}