Получение дополнительных модулей

Используйте этот метод в API аналитики Microsoft Store, чтобы получить совокупные данные о приобретении надстроек для приложения в формате JSON в заданном диапазоне дат и с использованием других необязательных фильтров. Эти сведения также доступны в отчете о приобретениях надстроек в Партнерском центре.

Предпосылки

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

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

Просьба

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

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

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

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

Фильтрация полей

Параметр фильтра запроса содержит одну или несколько инструкций, которые фильтруют строки в ответе. Каждое утверждение содержит поле и значение, которые связаны с операторами eq или ne, и утверждения могут быть объединены с помощью и или или. Вот некоторые примеры параметров фильтра ::

• filter=market eq 'US' и gender eq 'm'
• filter=(market ne 'US') и (gender ne 'Unknown') и (gender ne 'm') и (market ne 'NO') и (ageGroup ne 'старше 55' и ageGroup ne 'моложе 13')

Список поддерживаемых полей см. в следующей таблице. Строковые значения должны быть окружены одними кавычками в параметре фильтра .

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

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?inAppProductId=9NBLGGGZ5QDR&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/inappacquisitions?applicationId=9NBLGGGZ5QDR&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/inappacquisitions?inAppProductId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=7/3/2015&top=100&skip=0&filter=market ne 'US' and gender ne 'Unknown' and gender ne 'm' and market ne 'NO' and ageGroup ne '>55' HTTP/1.1
Authorization: Bearer <your access token>

Ответ

Основная часть ответа

Значения приобретения дополнений

Элементы в массиве значений содержат следующие значения.

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

В следующем фрагменте кода показан пример текста запроса и текста ответа JSON для этого запроса.

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

Пример ответа

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NBLGGAAGZDQ",
            "date": "2022-07-29",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 18.12,
            "purchasePriceLocalAmount": 18.12,
            "purchaseTaxUSDAmount": 1.13,
            "purchaseTaxLocalAmount": 1.13
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Episode 4",
            "addonProductId": "9NAAAAAAAAAQ",
            "date": "2017-01-07",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 4.147206,
            "purchasePriceLocalAmount": 3.99,
            "purchaseTaxUSDAmount": 0.686004,
            "purchaseTaxLocalAmount": 0.66
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NALGGGZ5QDQ",
            "date": "2018-04-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.99,
            "purchasePriceLocalAmount": 1.99,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Strategy Guide Episode 4",
            "addonProductId": "9NBLGGGZ5QDQ",
            "date": "2021-11-25",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.31902922876179,
            "purchasePriceLocalAmount": 150.0,
            "purchaseTaxUSDAmount": 0.114315866492689,
            "purchaseTaxLocalAmount": 13.0
        },
    ],
    "TotalCount": 4,
    "DataFreshnessTimestamp": "2022-07-29T05:54:00"
}

Связанные темы

• Отчет о приобретениях дополнений
• Доступ к аналитическим данным с помощью служб Microsoft Store
• Получение преобразований надстроек по каналу
• Покупка приложений
• Получить данные воронки привлечения приложений
• Получение конверсий приложения по каждому каналу