Asset Reporting API
このReporting APIを使用して、集計されたキャンペーンデータをJSONまたはCSVフォーマットで取得します。
昨日のデータは午前6:00(UTC)以降に確定します。
リクエスト形式
次のベースURLにHTTPGET
リクエストを送信して、レポートをリクエストします:https://r.applovin.com/assetReport
必要なパラメーター
パラメーター | 目的 |
---|---|
api_key | レポートキー<br />レポートキーは、Axonダッシュボードでダッシュボードの右上にあるアカウントをクリックし、<UILabel>Keys</UILabel>を選択するか、AppLovinダッシュボードのアカウントページの<UILabel>Keys</UILabel>タブで見つけることができます。 |
range | このレポートの時間範囲。有効な値:yesterday 、last_7d |
columns | コンマで区切られたリストのレポートの列<br />以下の利用可能な列を参照してください。例:day,creative_set_id,impressions 。 |
オプションのパラメーター
パラメーター | 目的 |
---|---|
format | レポートのフォーマット<br />json またはcsv を指定できます。デフォルトは json です。 |
limit | 返したい行数の上限。例:500 (結果をページ分割するにはlimit とoffset を使用します) |
offset | 行の取得を開始するオフセット。例:100 (結果をページ分割するにはlimit とoffset を使用します) |
利用可能な列
列名 | 内容 |
---|---|
asset_id | アセットID。これは、Axon Campaign Management API で返されるアセットIDと一致します |
clicks | クリック数 |
cost | 広告主支出 |
ctr | クリック数 ÷ インプレッション数 |
impressions | インプレッション数 |
列をフィルター
レポートはasset_id
でフィルタリングできます。
この操作では、指定したフィルターのいずれかに完全一致するデータが検索されます。
列でフィルターするには、次のURLパラメーターを追加します: <code>filter_<var>columnname</var>=<var>onefilter,anotherfilter,thirdfilter</var></code>
たとえば、特定のasset_id
12345
のデータのみを表示したい場合は、次のURLパラメーターを設定してください: asset_id=12345
<code>filter_not_<var>columnname</var>=<var>onefilter,anotherfilter</var></code> を使用して、否定フィルターを適用することもできます。
列の並べ替え
レポートを並べ替える方法は、レポートをフィルターする方法と似ています。
例えば、レポートをimpressions
で並べ替えるには、次のURLパラメーターを追加します: sort_impressions=ASC
指定できる値は、昇順の場合は ASC
、降順の場合はDESC
です。すべてのソートは辞書式順序で実行されます。
リクエストの例
https://r.applovin.com/assetReport?api_key=«your-report-key»&start=2025-08-01&end=2025-08-10&columns=day%2Casset_id%2Ccreative_set_id%2Cimpressions%2Cclicks%2Ccost&format=json&limit=100&sort_impressions=DESC