取得廣告績效資料

在 Microsoft Store 分析 API 中使用此方法，在特定日期範圍期間和其他選擇性篩選條件取得應用程式的彙總和績效資料。 這個方法會以 JSON 格式傳回資料。

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

必要條件

要使用此方法，您需要先執行以下操作：

• 如果您尚未執行此操作，請完成 Microsoft Store 分析 API 的所有必要條件。
• 取得 Azure AD 存取權杖以便用於此方法的要求標頭中。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 權杖到期之後，您可以取得新的權杖。

如需詳細資訊，請參閱使用 Microsoft Store 服務存取分析資料。

Request

要求語法

要求標頭

要求參數

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

篩選功能變數

要求本文的 filter 參數包含一或多個陳述式，可篩選回應中的資料列。 每個陳述式都包含與 eq 或 ne 運算子相關聯的功能變數和值，而且可以使用 and 或 or 來結合陳述式。 下面是一個範例 filter 參數：

• filter=market eq 'US' and deviceType eq 'phone'

如需支援的功能變數清單，請參閱下表。 字串值必須以 filter 參數中的單引號括住。

要求範例

下列範例示範數個取得廣告績效資料的要求。 以您應用程式的 Store ID 取代 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 服務存取分析資料