获取附加功能

在 Microsoft 商店分析 API 中使用此方法，获取应用附加组件在给定日期范围及其他可选筛选条件下的 JSON 格式汇总获取数据。 在合作伙伴中心的 加载项购置报告 中也提供了此信息。

先决条件

若要使用此方法，首先需要执行以下操作：

• 完成 Microsoft Store 分析 API 的所有先决条件（如果尚未这样做）。
• 获取 Azure AD 访问令牌，以供在此方法的请求标头中使用。 获取访问令牌后，在它到期前，你有 60 分钟的使用时间。 令牌过期后，可以获取一个新令牌。

请求

请求语法

请求标头

请求参数

applicationId 或 inAppProductId 参数是必需的。 若要检索注册到应用的所有加载项的购置数据，请指定 applicationId 参数。 若要检索单个加载项的获取数据，请指定 inAppProductId 参数。 如果同时指定这两个参数，则忽略 applicationId 参数。

筛选字段

请求的 筛选器 参数包含一个或多个语句，用于筛选响应中的行。 每个语句都包含一个字段和值，这些字段和值与 eq 或 ne 运算符相关联，可以使用 和 或 或组合语句。 下面是一些示例 筛选器 参数：

• filter=market eq 'US' 和性别 eq 'm'
• filter=（market ne 'US'） and （gender ne 'Unknown'） and （gender ne 'm'） and （market ne 'NO'） and （ageGroup ne 'greater than 55' or ageGroup ne 'less than 13'）

有关支持字段的列表，请参阅下表。 字符串值必须用 筛选器 参数中的单引号括起来。

请求示例

以下示例演示了几种获取加载项购置数据的请求。 将 inAppProductId 和 applicationId 值替换为加载项或应用的相应应用商店 ID。

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>

响应

响应体

附加购置值

Value 数组中的元素包含以下值。

请求和响应示例

以下代码片段演示了这些请求的示例请求和 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 应用商店服务 获取分析数据
• 获取按频道分列的附加组件转换
• 获取应用安装量
• 获取应用程序获取漏斗数据
• 按渠道获取应用转化