レポートエンドポイント

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

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

事前準備

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

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

エンドポイント

https://dash.adjust.com/control-center/reports-service/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）クエリが応答を返すのに時間がかかりすぎた場合に返される

成功レスポンス

{
   "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":[
      
   ]
}

パラメーター

例

curl \
--header 'Authorization: Bearer <adjust_api_token>' \
--location --request GET 'https://dash.adjust.com/control-center/reports-service/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' \
{
    "rows": [
        {
            "attr_dependency": {
                "campaign_id_network": "unknown",
                "partner_id": "-300",
                "partner": "Organic"
            },
            "app": "Test app",
            "partner_name": "Organic",
            "campaign": "unknown",
            "campaign_id_network": "unknown",
            "campaign_network": "unknown",
            "installs": "10",
            "network_installs": "0",
            "network_cost": "0.0",
"network_ecpi": "0.0"
}
    ],
    "totals": {
        "installs": 10.0,
        "network_installs": 0.0,
        "network_cost": 0.0,
        "network_ecpi": 0.0
    },
    "warnings": [],
    "pagination": null
}