広告キャンペーンのパフォーマンス データを取得する

Microsoft Store 分析 API の次のメソッドを使用して、特定の期間中のアプリケーションのプロモーション広告キャンペーンのパフォーマンス データとその他のオプションフィルターの集計概要を取得します。 このメソッドは、JSON 形式でデータを返します。

このメソッドは、パートナー センターの 広告キャンペーン レポート で提供されるデータと同じデータを返します。 広告キャンペーンの詳細については、「 アプリの広告キャンペーンを作成する」を参照してください。

広告キャンペーンの詳細を作成、更新、または取得するには、Microsoft Store プロモーション API で広告キャンペーンの管理方法を使用できます。

[前提条件]

このメソッドを使用するには、まず次の操作を行う必要があります。

• まだ行っていない場合は、Microsoft Store 分析 API の 前提条件をすべて満たしてください。
• このメソッドの要求ヘッダーで使用する Azure AD アクセス トークン を取得します。 アクセス トークンを取得すると、有効期限が切れるまで 60 分かかります。 トークンの有効期限が切れた後、新しいトークンを取得できます。

リクエスト

リクエスト構文

リクエストヘッダー

要求パラメーター

特定のアプリの広告キャンペーンのパフォーマンス データを取得するには、 applicationId パラメーターを使用します。 開発者アカウントに関連付けられているすべてのアプリの広告パフォーマンス データを取得するには、applicationId パラメーターを省略します。

要求の例

次の例では、広告キャンペーンのパフォーマンス データを取得するためのいくつかの要求を示します。

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/promotion?aggregationLevel=week&groupby=applicationId,campaignId,date  HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/promotion?applicationId=9NBLGGH0XK8Z&startDate=2015/1/20&endDate=2016/8/31&skip=0&filter=campaignId eq '31007388' HTTP/1.1
Authorization: Bearer <your access token>

[応答]

応答内容

キャンペーンパフォーマンスオブジェクト

Value 配列内の要素には、次の値が含まれています。

応答の例

次の例は、この要求の JSON 応答本文の例を示しています。

{
  "Value": [
    {
      "date": "2015-04-12",
      "applicationId": "9WZDNCRFJ31Q",
      "campaignId": "4568",
      "lineId": "0001",
      "currencyCode": "USD",
      "spend": 700.6,
      "impressions": 200,
      "installs": 30,
      "clicks": 8,
      "iapInstalls": 0,
      "activeUsers": 0
    },
    {
      "date": "2015-05-12",
      "applicationId": "9WZDNCRFJ31Q",
      "campaignId": "1234",
      "lineId": "0002",
      "currencyCode": "USD",
      "spend": 325.3,
      "impressions": 20,
      "installs": 2,
      "clicks": 5,
      "iapInstalls": 0,
      "activeUsers": 0
    }
  ],
  "@nextLink": "promotion?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=2015/1/20&endDate=2016/8/31&top=2&skip=2",
  "TotalCount": 1917
}

関連トピック

• アプリの広告キャンペーンを作成する
• Microsoft Store サービスを使用して広告キャンペーンを実行する
• Microsoft Store サービス を使用して分析データにアクセスする