取得廣告績效數據

在Microsoft市集分析 API 中使用這個方法，在指定的日期範圍和其他選擇性篩選期間，取得應用程式的匯總廣告績效數據。 這個方法會以 JSON 格式傳回數據。

此方法會傳回 合作夥伴中心 廣告績效報告所提供的相同數據。

先決條件

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

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

如需更多資訊，請參閱 使用 Microsoft Store 服務存取分析數據。

請求

請求語法

請求標頭

要求參數

若要擷取特定應用程式的廣告績效數據，請使用 applicationId 參數。 若要擷取與您開發人員帳戶相關聯的所有應用程式的廣告績效數據，請省略 applicationId 參數。

篩選欄位

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

• filter=market eq '美國' and deviceType eq 'phone'

如需支援欄位的清單，請參閱下表。 字串值必須以 篩選 參數中的單引弧括住。

範例請求

下列範例展示了幾種取得廣告效能數據的請求。 以您應用程式的市集標識碼取代 applicationId 值。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/adsperformance?applicationId=9NBLGGH4R315&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/adsperformance?applicationId=9NBLGGH4R315&startDate=8/1/2015&endDate=8/31/2015&skip=0&$filter=market eq 'US' and deviceType eq 'phone’ eq 'US'; and gender eq 'm'  HTTP/1.1
Authorization: Bearer <your access token>

回應

回應主體

廣告績效值

Value 陣列中的元素包含下列值。

回應範例

下列範例顯示這個請求的 JSON 回應示例內容。

{
  "Value": [
    {
      "date": "2015-03-09",
      "applicationId": "9NBLGGH4R315",
      "applicationName": "Contoso Demo",
      "market": "US",
      "deviceType": "phone",
      "adUnitId":"10765920",
      "adUnitName":"TestAdUnit",
      "revenueInAccountCurrency": 10.0,
      "impressions": 1000,
      "requests": 10000,
      "clicks": 1,
      "accountCurrencyCode":"USD"
    },
    {
      "date": "2015-03-09",
      "applicationId": "9NBLGGH4R315",
      "applicationName": "Contoso Demo",
      "market": "US",
      "deviceType": "phone",
      "adUnitId":"10795110",
      "adUnitName":"TestAdUnit2",
      "revenueInAccountCurrency": 20.0,
      "impressions": 2000,
      "requests": 20000,
      "clicks": 3,
      "accountCurrencyCode":"USD"
    },
  ],
  "@nextLink": "adsperformance?applicationId=9NBLGGH4R315&aggregationLevel=week&startDate=2015/03/01&endDate=2016/02/01&top=2&skip=2",
  "TotalCount": 191753
}

相關主題

• 廣告效能報告
• 使用 Microsoft Store 服務存取分析數據