Reporting 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 />以下の許可された列を参照してください。例：ad_id,day,campaign。
report_type	APIにpublisherまたはadvertiserのデータで応答するように指示<br />このパラメーターを省略すると、APIはデフォルトでreport_type=publisherを返します。

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

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

パラメーター	目的
day_column	指標はデフォルトでリアルタイムです。コホートで指標を取得したい場合は、これをdayに設定します。
limit	返したい行数の上限。例：500（結果をページ分割するにはlimitとoffsetを使用します）
offset	行の取得を開始するオフセット。例：100（結果をページ分割するにはlimitとoffsetを使用します）
having	数値に基づいて結果をフィルターできます。<br />このパラメーターでは、数値列のURLエンコードされた値、比較演算子、および論理演算子を指定できます。例： impressions%20%3E%200%20AND%20revenue%20%3E%200（「impressions > 0 AND revenue > 0」）。<br />注：これにより応答が遅くなり、タイムアウトが発生する可能性が高まります。
not_zero	すべての数値指標の値が0である結果を除外するには、これを1に設定します。

許可されたパブリッシャー列

列名	内容
ad_type	APPOPEN、GRAPHIC、MRAID、PLAY、REWARD、またはVIDEO
application	アプリ名
application_is_hidden	アプリはダッシュボードで非表示になっていますか？
bidding_integration	AppLovinが入札を行っているメディエーションプロバイダー（MAXはMAXメディエーション、GoogleはAdMob Mediation Open BiddingまたはGoogle アド マネージャー/GAM、Noneはノンビディング／ゾーン統合）
clicks	クリック数
country	2文字の国コード
ctr	クリック数÷インプレッション数
day	レポートデータの日付
device_type	phone、tablet、またはother
ecpm	インプレッション1000回あたりの収益
hour	レポートデータの時間（過去30日間のみ利用可能）
impressions	インプレッション数
package_name	アプリのパッケージ名またはバンドルID
placement_type	APP_OPEN、BANNER、INTER、LEADER、MREC、NATIVE、または REWARDED_INTER
platform	android、fireos、ios
revenue	獲得した金額
size	広告サイズ（BANNER、INTER、LEADER、MREC、またはNATIVE）
store_id	iOSのiTunes IDの数字部分、またはAndroidの package_name。<br />Tunes IDがAppLovinに認知されていない場合、代わりにバンドルIDが返されます。
zone	Zone名（アカウントで利用可能な場合）
zone_id	アカウントで利用可能な場合はZone ID。<br />ゾーンの使用をご希望の場合は、アカウントマネージャーにお問い合わせください。

許可された広告主列

列名	内容
ad	広告名
ad_creative_type	GRAPHIC, PLAYABLE, VIDEO, VIDEO_PLAYABLE
ad_id	広告ID。広告名が変更されても、これは変わりません
ad_rev_<var>x</var>	特定の期間中のIAP収益（<var>x</var>は 0d、1d、2d、3d、7d、14d、28d、30d、90d、または1yのいずれか）
ad_roas_<var>x</var>	特定の期間の広告費用対効果（<var>x</var>は0d、1d、2d、3d、7d、14d、28d、30d、90d、または1yのいずれか）
ad_type	APPOPEN、GRAPHIC、PLAY、REWARD、またはVIDEO
app_id_external	ハッシュ化されたアプリケーションID（一般に「サイトID」と呼ばれる）
application	ソースアプリケーション名
average_cpa	コンバージョンあたりの平均コスト
average_cpc	平均クリック単価
bidding_and_billing_method	AppLovin固有の入札戦略。AUTO_BIDDING_WITH_CPM_BILLING、CAPPED_GOAL_BIDDING_WITH_CPM_BILLING、FIXED_GOAL_BIDDING_WITH_CPI_BILLING、またはFIXED_GOAL_BIDDING_WITH_CPM_BILLINGのいずれかAppLovin以外のネットワークの場合は空白
campaign	キャンペーン名
campaign_ad_type	ua（ユーザー獲得）、またはrt（リターゲティング）
campaign_bid_goal	CPPおよびCPEキャンペーンの入札目標はドル値 ($) で表されます。この列をリクエストする際には、campaign列も同時にリクエストする必要があります。
campaign_id_external	キャンペーンに対する一意の参照。キャンペーンの名前を変更しても、これは変わりません。これは、{CAMPAIGN_ID}クリックマクロと同じ値です。
campaign_package_name	プロモーション中のアプリのパッケージ名またはバンドルID
campaign_roas_goal	IAP ROAS、広告ROAS、およびROASキャンペーンの広告費用対効果 (ROAS) 目標は、パーセンテージ値 (%) で表されます。この列をリクエストする際は、campaign列も同時にリクエストする必要があります。
campaign_store_id	iOSでプロモーションされているアプリのiTunes IDの数値部分、それ以外の場合はcamaign_package_name
campaign_type	キャンペーンの最適化タイプ（CPP、CPE、ad ROAS、IAP ROAS、またはROAS）
clicks	クリック数
conversions	コンバージョン数（インストール）
conversion_rate	コンバージョン数÷インプレッション数
cost	広告主支出
cost_per_target_event_<var>x</var>	特定の期間中のターゲットイベントのイベント単価（<var>x</var>は0d、1d、2d、3d、7d、14d、30d、90d、または1yのいずれか）
country	2文字の国コード
cpp_<var>x</var>	特定の期間中の購入あたりのコスト（<var>x</var>は0d、1d、2d、3d、7d、14d、30d、90d、または1yのいずれか）
creative_set	クリエイティブセット名
creative_set_id	クリエイティブセットID。クリエイティブセット名が変更されても、これは変更されません。
ctr	クリック数÷インプレッション数
custom_page_id	クリエイティブセットに関連付けられたiOSカスタム製品ページまたはAndroidストアリスティング
day	レポートデータの日付
device_type	phone、tablet、またはother
external_placement_id	暗号化されたアプリケーションID（APIソース入札で使用）
first_purchase	初回購入を行ったユーザーのカウント数（収益ポストバックの設定が必要）
hour	レポートデータの時間（過去30日間のみ利用可能）
iap_rev_<var>x</var>	特定の期間中のIAP収益（<var>x</var>は 0d、1d、2d、3d、7d、14d、28d、30d、90d、または1yのいずれか）
iap_roas_<var>x</var>	特定の期間中のIAPの広告費用対効果 (<var>x</var>は0d、1d、2d、3d、7d、14d、28d、30d、90d、または1yのいずれか)
impressions	インプレッション数
optimization_day_target	キャンペーンでターゲットに設定した最適化日（例：Day0またはDay7）
placement_type	APP_OPEN、ARRAY、BANNER、CTV、INTER、LEADER、MREC、NATIVE、またはREWARDED_INTER
platform	android、fireos、ios、またはtvos
ret_<var>x</var>	特定の期間中のリテンション（<var>x</var>は 1d、3d、7d、14dまたは28dのいずれか）
roas_<var>x</var>	特定の期間中の合計ROAS（<var>x</var>は0d、1d、2d、3d、7d、14d、28d、30d、90d、または1yのいずれか）
sales	アトリビュートされた売上イベントのカウント数（収益ポストバックの設定が必要）
sales_<var>x</var>	特定の期間中の売上 (<var>x</var>は0d、1d、2d、3d、7d、14d、30d、90d、または1yのいずれか)
size	広告サイズ（BANNER、INTER、LEADER、MREC、NATIVE、またはPRELOAD）
target_event	キャンペーンがターゲティングしているカスタムイベント（CPEキャンペーンにのみ適用）
target_event_count	一意のターゲットイベント数
target_event_count_<var>x</var>	特定の期間中の一意のターゲットイベント数（<var>x</var> は 0d、1d、2d、3d、7d、14d、30d、90d、または 1yのいずれか）
total_rev_<var>x</var>	特定の期間中の合計収益（<var>x</var>は0d、1d、2d、3d、7d、14d、28d、30d、90d、または1yのいずれか）
traffic_source	AppLovin、またはエクスチェンジ名
unique_purchasers_<var>x</var>	特定の期間中の一意の購入者数（<var>x</var>は0d、1d、2d、3d、7d、14d、30d、90d、または1yのいずれか）

列をフィルター

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

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

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

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

一部の列では、<code>filter_not_<var>columnname</var>=<var>onefilter,anotherfilter</var></code>による否定フィルターがサポートされています。さらに、custom_page_id列はfilter_null_custom_page_id、filter_blank_custom_page_id、filter_not_null_custom_page_id、およびfilter_not_blank_custom_page_idのオプションをサポートします。これらのオプションには値の指定は不要です（例：…&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=2015-04-20&end=now&columns=day,campaign,impressions,clicks,ctr,conversions,conversion_rate,app_id_external,cost,sales&format=json&report_type=advertiser

パブリッシャーリクエストの例：

https://r.applovin.com/report?api_key=«your-report-key»&start=2016-07-01&end=2016-07-07&columns=day%2Cplatform%2Ccountry%2Capplication%2Cpackage_name%2Csize%2Cad_type%2Cimpressions%2Cclicks%2Crevenue,device_type&having=impressions%20%3E%200%20AND%20revenue%20%3E%200&format=csv