レポートAPI

このReporting APIを使用して、集計されたキャンペーンデータをJSONまたはCSVフォーマットで取得します。

リクエスト形式

以下のベースURLにHTTPGETリクエストを送信して、レポートをリクエストします。

• https://r.applovin.com/report

必要なパラメーター

パラメーター	目的
api_key	レポートキー<br />AppLovinダッシュボードのアカウントページの<UILabel>Keys</UILabel>タブでこのレポートキーを確認します。
start<sup>1</sup>	レポートの開始日<br /><var>YYYY-MM-DD</var> フォーマットまたはUnixタイムスタンプを指定できます。例えば、2012-10-05または1336608000です。
end<sup>1</sup>	レポートの終了日<br /><var>YYYY-MM-DD</var> フォーマットまたはUnixタイムスタンプを指定できます。例えば、2012-10-05、1336608000、またはnowです。
format	レポートのフォーマット<br />jsonまたはcsvを指定できます。リクエストフォーマットの詳細は以下を参照してください。
columns	コンマで区切られたリストのレポートの列<br />以下の許可された列を参照してください。例：day,campaign。
report_type	advertiser（必須）

¹このAPIで設定できるリクエスト期間は90日間です。日付パラメーターが90日以内に設定されていることを確認してください。

オプションのパラメーター

パラメーター	目的
day_column	指標はデフォルトでリアルタイムです。コホートで指標を取得したい場合は、これをdayに設定してください（指標は配信時間に遡ってアトリビュートされます）。
limit	返される行数の制限。例：500
offset	行の取得を開始するオフセット位置。例：100
having	数値に対する複雑なフィルターを許可します。<br/>このパラメーターでは、数値列のURLエンコードされた値、比較演算子、および論理演算子を指定できます。例：impressions%20%3E%200%20AND%20cost%20%3E%200（「impressions > 0 AND cost > 0」）。<br />注：これにより応答が遅くなり、タイムアウトが発生する可能性が高まります。
not_zero	すべての数値指標の値が0である結果をフィルタリングするには、これを1に設定します。

推奨列

列名	内容
campaign	キャンペーン名
campaign_id_external	キャンペーンを一意に識別する参照値<br />キャンペーン名を変更してもこの値は変わりません。これは、{CAMPAIGN_ID}クリックマクロと同じ値です。
cost	広告主支出
country	2文字の国コード
creative_set	クリエイティブセット名
creative_set_id	クリエイティブセットID。クリエイティブセット名を変更してもこの値は変わりません。
day	レポートデータの日付
hour	レポートデータの時間（過去30日間のみ利用可能）

オプション列

列名	内容
ad_creative_type	GRAPHIC、GRAPHIC_PLAY、PLAYABLE、VIDEO、VIDEO_GRAPHIC、またはVIDEO_PLAYABLE
ad_type	APPOPEN、GRAPHIC、PLAY、REWARD、またはVIDEO
average_cpc	平均クリック単価
campaign_bid_goal	CPPおよびCPEキャンペーンの入札目標はドル値 ($) で表されます。この列をリクエストする際には、campaign列も同時にリクエストする必要があります。
chka_0d	インプレッション時刻から24時間以内に発生し、アトリビュートされたチェックアウト
chka_1d	インプレッション時刻から48時間以内に発生し、アトリビュートされたチェックアウト
chka_2d	インプレッション時刻から72時間以内に発生し、アトリビュートされたチェックアウト
chka_3d	インプレッション時刻から96時間以内に発生し、アトリビュートされたチェックアウト
chka_7d	インプレッション時刻から192時間以内に発生し、アトリビュートされたチェックアウト
chka_usd_0d	インプレッション時刻から24時間以内に発生し、アトリビュートされたチェックアウト収益の合計
chka_usd_1d	インプレッション時刻から48時間以内に発生し、アトリビュートされたチェックアウト収益の合計
chka_usd_2d	インプレッション時刻から72時間以内に発生し、アトリビュートされたチェックアウト収益の合計
chka_usd_3d	インプレッション時刻から96時間以内に発生し、アトリビュートされたチェックアウト収益の合計
chka_usd_7d	インプレッション時刻から192時間以内に発生し、アトリビュートされたチェックアウト収益の合計
clicks	クリック数
cost_per_chka_0d	インプレッション時刻から24時間以内のCPP
cost_per_chka_1d	インプレッション時刻から48時間以内のCPP
cost_per_chka_2d	インプレッション時刻から72時間以内のCPP
cost_per_chka_3d	インプレッション時刻から96時間以内のCPP
cost_per_chka_7d	インプレッション時刻から192時間以内のCPP
ctr	クリック数÷インプレッション数
custom_page_id	特定のランディングページ
impressions	インプレッション数
placement_type	APP_OPEN、ARRAY、BANNER、CTV、INTER、LEADER、MREC、NATIVE、またはREWARDED_INTER
platform	android、ios、fireos、またはtvos
roas_0d	インプレッション時刻から24時間以内に生成されたチェックアウトROAS
roas_1d	インプレッション時刻から48時間以内に生成されたチェックアウトROAS
roas_2d	インプレッション時刻から72時間以内に生成されたチェックアウトROAS
roas_3d	インプレッション時刻から92時間以内に生成されたチェックアウトROAS
roas_7d	インプレッション時刻から192時間以内に生成されたチェックアウトROAS
sales	アトリビューションされた販売イベントの数
size	広告サイズ（BANNER、INTER、LEADER、MREC、NATIVE、またはPRELOAD）

列をフィルター

レポートを任意の列でフィルターできます。 この操作を行うと、いずれかのフィルターに直接一致するものを検索します。

列でフィルターするには、次のURLパラメーターを追加します： <code>filter_columnname=<var>onefilter,anotherfilter,thirdfilter</var></code>

例えば、Androidプラットフォームのデータのみを表示したい場合は、次のURLパラメーターを設定してください：filter_platform=Android

すべての列の一覧については、上記の表を参照してください。

Some columns support negative filters via <code>filter_not_columnname=<var>onefilter,anotherfilter</var></code>. The custom_page_id column also supports filter_null_custom_page_id, filter_blank_custom_page_id, filter_not_null_custom_page_id, and filter_not_blank_custom_page_id options. These options do not require a value, i.e. …&filter_not_null_custom_page_id=&filter_not_blank_custom_page_id=&…

列のソート

レポートを並べ替える方法は、レポートをフィルターする方法と似ています。

例えば、レポートをcampaignで並べ替えるには、次のURLパラメーターを追加します: sort_campaign=ASC

指定できる値は、昇順の場合は ASC、降順の場合はDESCです。すべてのソートは辞書式順序で実行されます。

レポートのフォーマット

レポートはJSONまたはCSVの2つのフォーマットでリクエストできます。

タイムゾーン

レポートAPIのすべてのデータはUTC（協定世界時）です。

リクエストの例

https://r.applovin.com/report?api_key=«your-report-key»&start=2024-04-20&end=now&columns=day,campaign,impressions,clicks,ctr,cost,sales&format=json&report_type=advertiser