ピボットレポートのエンドポイント

ピボットレポートサービス（Pivot Reports Service）は、KPIサービスの合計レポート、KPIサービスのコホート、SKAdNetwork、広告費用などの様々なソースから集計データを取得するためのAPIを提供します。

レポートエンドポイントを使用すると、多数のサービスからのデータを1つのレポートに統合できます。インストール、収益、広告費用、SKAdNetworkデータを、日別、アプリ別、広告ネットワーク別に分けてリクエストできます。

事前準備

このエンドポイントを使用するには、Adjust APIトークンが必要です。所定の手順を使用して、Adjust API認証を設定および管理します。

APIのユーザー権限は、Adjustユーザーアカウントのユーザー権限を反映しています。

エンドポイント

https://dash.adjust.com/control-center/reports-service/pivot_report

GETリクエスト

GETメソッドは、レポートサービスからフィルタリングされたデータをJSON形式で返します。

フィルター

ディメンション

指標

レスポンス

このエンドポイントは、以下のレスポンスを返します：

レスポンス説明注意
200成功 (Success)レポート情報を返す
204内容なし（No content）レスポンスオブジェクトが空の場合に返される
400不正なリクエスト（Bad request）リクエストに不正があるか、サポートされていないパラメーターが含まれている場合に返される
401無許可（Unauthorized）認証情報が正しくないか欠けている場合に返される
403禁止（Forbidden）閲覧許可がない情報にアクセスしようとした場合に返される
429リクエスト過多（Too many requests）同時リクエストが50回を超えた場合に返される
503サービス利用不可（Service unavailable）サーバーにリーチできなかった場合に返される
504ゲートウェイ タイムアウト（Gateway timeout）クエリが応答を返すのに時間がかかりすぎた場合に返される

成功レスポンス

Report Serviceは、JSON形式でデータを返します。

{
   "rows":[
      {
         "attr_dependency":{
            
         },
         "app":"App Name",
         "partner_name":"AppLovin",
         "campaign":"Campaign Name (Campaign ID)",
         "campaign_id_network":"Campaign ID",
         "campaign_network":"Campaign Name",
         "installs":"64",
         "cost":"1000"
      }
   ],
   "totals":{
      "installs":64,
      "cost":1000
   },
   "warnings":[
      
   ],
   "totals_per_dimension": { }
}

パラメーター

例

curl \
--header 'Authorization: Bearer <adjust_api_token>' \
--location --request GET 'https://dash.adjust.com/control-center/reports-service/pivot_report?cost_mode=network&app_token__in={app_token1},{app_token2}&date_period=2021-05-01:2021-05-02&dimensions=app,partner_name,campaign,campaign_id_network,campaign_network&metrics=installs,network_installs,network_cost,network_ecpi&index=app' \
{
   "rows": [
       {
           "Test App": {
               "rows": [
                   {
                       "attr_dependency": {
                           "app_network": [
                               "google_play:com.test.app"
]
                       },
                       "campaign_id_network": "123",
                       "campaign_network": "Campaign Name",
                       "campaign": "Campaign Name (123)",
                       "partner_name": "MyPartner",
                       "installs": 10,
                       "network_installs": 0,
                       "network_cost": 0,
                       "network_ecpi": 0
                   }
               ]
           }
       }
   ],
   "totals": {
       "installs": 10,
       "network_installs": 0,
       "network_cost": 0,
       "network_ecpi": 0
   },
   "totals_per_dimension": {
       "campaign_id_network": {
           "Organic": {
               "installs": 10,
               "network_installs": 0,
               "network_cost": 0,
               "network_ecpi": 0
           }
       },
       "campaign_network": {
           "Organic": {
               "installs": 10,
               "network_installs": 0,
               "network_cost": 0,
               "network_ecpi": 0
           }
       },
       "app": {
           "adjust Demo App": {
               "installs": 10,
               "network_installs": 0,
               "network_cost": 0,
               "network_ecpi": 0
           }
       },
       "campaign": {
           "Organic": {
               "installs": 10,
               "network_installs": 0,
               "network_cost": 0,
               "network_ecpi": 0
           }
       },
       "partner_name": {
           "Organic": {
               "installs": 10,
               "network_installs": 0,
               "network_cost": 0,
               "network_ecpi": 0
           }
       }
   }
}