取得附加元件

在 Microsoft 市集分析 API 中使用此方法，以取得指定日期範圍內應用程式附加元件的匯總取得數據，格式為 JSON，並可以使用其他可選的篩選條件。 這項資訊也可在合作夥伴中心的 附加元件下載報告中 取得。

先決條件

若要使用此方法，您必須先執行下列動作：

• 如果您尚未這麼做，請完成 Microsoft 市集分析 API 的所有 必要條件 。
• 取得 Azure AD 存取令牌 ，以用於此方法的要求標頭中。 取得存取令牌之後，您必須在 60 分鐘内使用它，否則將會失效。 令牌到期之後，您可以取得新的令牌。

請求

請求語法

請求標頭

要求參數

需要 applicationId 或 inAppProductId 參數。 若要擷取向應用程式註冊之所有附加元件的數據，請指定 applicationId 參數。 若要擷取單一附加元件的擷取數據，請指定 inAppProductId 參數。 如果您同時指定這兩個參數，則會忽略 applicationId 參數。

篩選欄位

要求的 filter 參數包含一或多個語句，可篩選響應中的數據列。 每個語句都包含與 eq 或 ne 運算符相關聯的欄位和值，而且語句可以使用 和或結合。 以下是一些 範例篩選 參數：

• filter=市場 eq 'US' 並且 性別 eq '男'
• filter=（market ne 'US'） and （gender ne 'Unknown'） and （gender ne 'm'） and （market ne 'NO'） and （ageGroup ne '大於 55' or ageGroup ne '小於 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 Store 服務存取分析數據
• 依通道取得附加轉換
• 取得應用程式下載數
• 獲取應用程式轉化漏斗數據
• 依渠道取得應用程式轉換