Получите данные о приобретении дополнений для ваших игр и приложений.

Используйте этот метод в API аналитики Microsoft Store, чтобы получить статистические данные о приобретении надстроек в формате JSON для приложений UWP и игр Xbox One, которые были загружены через Портал разработчика Xbox (XDP) и доступны на панели мониторинга Центра аналитики партнера XDP.

Предварительные условия

Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:

• Если это еще не сделано, выполните все предварительные требования для API аналитики Microsoft Store.
• Получите маркер доступа Azure AD для использования в заголовке запроса для этого метода. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия токена вы можете получить новый.

Запрос

Синтаксис запроса

Заголовок запроса

Параметры запроса

Требуется параметр applicationId или addonProductId. Чтобы получить данные о приобретении для всех надстроек, зарегистрированных для этого приложения, укажите параметр applicationId. Чтобы получить данные о приобретении для конкретной надстройки, укажите параметр addonProductId. Если указать оба параметра, параметр applicationId игнорируется.

Пример запроса

В следующих примерах демонстрируются несколько запросов на получение данных о приобретении дополнений. Замените значения addonProductId и applicationId на соответствующий идентификатор Магазина для надстройки или приложения.

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 
}