Reporting API

このReporting APIを使用すると、集計されたキャンペーンデータをJSONまたはCSV形式で取得できます。

Axon Reporting API

リクエスト形式

レポートのリクエストは、次のベースURLに対してHTTP GETリクエストを送信して行います:https://r.applovin.com/report

必須パラメータ

パラメータ用途
api_keyお客様のReport Key
Report Keyは、AppLovin dashboardの右上にあるアカウントをクリックし、Keysを選択することで確認できます。
start1レポートの開始日
«YYYY-MM-DD»形式の日付、またはUnixタイムスタンプを受け付けます。例:2012-10-051336608000
end1レポートの終了日
«YYYY-MM-DD»形式の日付、Unixタイムスタンプ、またはnowを受け付けます。例:2012-10-051336608000now
formatレポートのフォーマット
jsonまたはcsvを受け付けます。リクエスト形式の詳細については以下を参照してください。
columnsレポートに含めるカラムのカンマ区切りリスト
指定可能なカラムは以下を参照してください。例:day,campaign
report_typeAPIがpublisher(パブリッシャー)またはadvertiser(広告主)のどちらのデータを返すかを指定します
このパラメータを省略した場合、APIはデフォルトでreport_type=publisherになります。

1このAPIのリクエスト可能期間は45日間です。日付パラメータが過去45日以内であることを確認してください。

任意パラメータ

パラメータ用途
day_column指標はデフォルトでリアルタイムです。コホート配下の指標を取得したい場合は、これをdayに設定してください。
limit返す行数の上限。例:500(結果をページネーションするにはlimitoffsetを使用します)
offset行の取得を開始するオフセット位置。例:100(結果をページネーションするにはlimitoffsetを使用します)
having数値に基づいて結果をフィルタリングできます
このパラメータは、数値カラム、比較演算子、論理演算子のURLエンコードされた値を受け付けます。例:impressions%20%3E%200%20AND%20revenue%20%3E%200(「impressions > 0 AND revenue > 0」)。
注意: これを使用するとレスポンスが遅くなり、タイムアウトの可能性が高くなります。
not_zeroすべての数値指標の値が0である結果を除外するには、これを1に設定します。

指定可能なパブリッシャーカラム

カラム名含まれる内容
ad_typeAPPOPENGRAPHICMRAIDPLAYREWARD、またはVIDEO
applicationアプリ名
application_is_hiddenアプリがダッシュボードで非表示になっているかどうか
bidding_integrationAppLovinがビッドを行うメディエーションプロバイダー(MAXメディエーションの場合はMAX、AdMobメディエーションのOpen BiddingまたはGoogleアド マネージャー/GAMの場合はGoogle、ビッディング以外のゾーン連携の場合はNone
clicksクリック数
country2文字の国コード
ctrクリック数 ÷ インプレッション数
dayレポートデータの対象日
device_typephonetablet、またはother
ecpmインプレッション1,000回あたりの獲得収益
hourレポートデータの対象時間(過去30日間のみ利用可能)
impressionsインプレッション数
package_nameアプリのパッケージ名またはバンドルID
placement_typeAPP_OPENBANNERINTERLEADERMRECNATIVE、またはREWARDED_INTER
platformandroidfireosios
revenue獲得収益
size広告サイズ(BANNERINTERLEADERMREC、またはNATIVE
store_idiOSではiTunes IDの数値部分、Androidではpackage_name
iTunes IDがAppLovinに認識されていない場合は、代わりにバンドルIDが使用されます。
zoneゾーン名(アカウントで利用可能な場合)
zone_idゾーンID(アカウントで利用可能な場合)
ゾーンの使用を希望される場合は、担当のアカウントマネージャーにお問い合わせください。

指定可能な広告主カラム

カラム名含まれる内容
ad広告名
ad_creative_typeGRAPHICPLAYABLEVIDEOVIDEO_GRAPHIC、またはVIDEO_PLAYABLE
ad_rev_«x»特定の期間における広告収益(«x»0d1d2d3d7d14d28d30d90d、または1yのいずれか)
ad_roas_«x»特定の期間における広告費用対効果(ROAS)(«x»0d1d2d3d7d14d28d30d90d、または1yのいずれか)
ad_typeAPPOPENGRAPHICPLAYREWARD、またはVIDEO
app_id_externalハッシュ化されたアプリケーションID(一般に「サイトID」と呼ばれます)
application配信元アプリケーション名
average_cpaコンバージョンあたりの平均単価
average_cpcクリックあたりの平均単価
bidding_and_billing_method入札戦略。AUTO_BIDDING_WITH_CPM_BILLINGCAPPED_GOAL_BIDDING_WITH_CPM_BILLINGFIXED_GOAL_BIDDING_WITH_CPI_BILLING、またはFIXED_GOAL_BIDDING_WITH_CPM_BILLINGのいずれか
campaignキャンペーン名
campaign_ad_typeユーザー獲得の場合はua、リターゲティングの場合はrt
campaign_bid_goalCPPおよびCPEキャンペーンにおける、ドル値($)で表されるキャンペーン入札目標。このカラムをリクエストする場合は、campaignカラムも同時にリクエストする必要があります。
campaign_id_externalキャンペーンの一意の参照ID。キャンペーン名が変更されてもこの値は変わりません。{CAMPAIGN_ID}クリックマクロと同じ値です。
campaign_package_nameプロモーション対象アプリのパッケージ名またはバンドルID
campaign_roas_goalIAP ROAS、Ad ROAS、およびROASキャンペーンにおける、パーセンテージ値(%)で表される広告費用対効果(ROAS)目標。このカラムをリクエストする場合は、campaignカラムも同時にリクエストする必要があります。
campaign_store_idiOSではプロモーション対象アプリのiTunes IDの数値部分、それ以外の場合はcampaign_package_name
campaign_typeキャンペーンの最適化タイプ(CPPCPEad ROASIAP ROAS、またはROAS
clicksクリック数
conversionsコンバージョン数(インストール数)
conversion_rateコンバージョン数 ÷ インプレッション数
cost広告主の消費額
cost_per_target_event_«x»特定の期間におけるターゲットイベントのイベントあたり単価(«x»0d1d2d3d7d14d30d90d、または1yのいずれか)
country2文字の国コード
cpp_«x»特定の期間における購入あたり単価(«x»0d1d2d3d7d14d30d90d、または1yのいずれか)
creative_setクリエイティブセット名
creative_set_idクリエイティブセットID。クリエイティブセット名が変更されてもこの値は変わりません。
ctrクリック数 ÷ インプレッション数
custom_page_idクリエイティブセットに関連付けられたiOSカスタムプロダクトページまたはAndroidストアの掲載情報
dayレポートデータの対象日
device_typephonetablet、またはother
external_placement_id暗号化されたアプリケーションID
optimization_day_targetキャンペーンでターゲットとして選択した最適化対象日(例:0日目または7日目)
placement_typeAPP_OPENBANNERCTVINTERLEADERMRECNATIVE、またはREWARDED_INTER
platformandroidfireosios、またはtvos
ret_«x»特定の期間における継続率(«x»1d3d7d14d、または28dのいずれか)
roas_«x»特定の期間における合計ROAS(«x»0d1d2d3d7d14d28d30d90d、または1yのいずれか)
salesアトリビューションされた売上イベントの数(売上ポストバックが必要です)
sales_«x»特定の期間における売上(«x»0d1d2d3d7d14d30d90d、または1yのいずれか)
size広告サイズ(BANNERINTERLEADERMRECNATIVE、またはPRELOAD
target_eventキャンペーンがターゲットとするカスタムイベント(CPEキャンペーンにのみ適用されます)
target_event_countユニークターゲットイベント数
target_event_count_«x»特定の期間におけるユニークターゲットイベント数(«x»0d1d2d3d7d14d30d90d、または1yのいずれか)
total_rev_«x»特定の期間における合計収益(«x»0d1d2d3d7d14d28d30d90d、または1yのいずれか)
traffic_sourceAppLovin、またはエクスチェンジの名前
unique_purchasers_«x»特定の期間におけるユニーク購入者数(«x»0d1d2d3d7d14d28d30d90d、または1yのいずれか)

カラムのフィルタリング

任意のカラムでレポートをフィルタリングできます。 フィルタリングを行うと、指定したフィルターのいずれかに完全一致するデータが検索されます。

カラムでフィルタリングするには、次のURLパラメータを追加します:filter_«columnname»=«onefilter,anotherfilter,thirdfilter»

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

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

一部のカラムでは、filter_not_«columnname»=«onefilter,anotherfilter»による除外フィルターをサポートしています。 また、custom_page_idディメンションは、filter_null_custom_page_idfilter_blank_custom_page_idfilter_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です。 すべてのソートは辞書順(lexicographical sort)で行われます。

レポート形式

レポートはJSONまたはCSVの2つの形式でリクエストできます。

タイムゾーン

Reporting 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

search