Reporting API
このReporting APIを使用すると、JSONまたはCSV形式で集計されたキャンペーンデータを取得できます。
リクエスト形式
レポートのリクエストは、以下のベースURLに対してHTTP GETリクエストを送信することで行います。
https://r.applovin.com/report
必須パラメータ
| パラメータ | 目的 |
|---|---|
api_key | レポートキー（Report Key） レポートキーは、AppLovin dashboardの右上にあるアカウントをクリックし、Keysを選択することで確認できます。 |
start1 | レポートの開始日«YYYY-MM-DD»形式の日付またはUnixタイムスタンプを受け入れます。例：2012-10-05 または 1336608000。 |
end1 | レポートの終了日«YYYY-MM-DD»形式の日付、Unixタイムスタンプ、またはnowを受け入れます。例：2012-10-05、1336608000、またはnow。 |
format | レポートのフォーマットjson または csv を受け入れます。リクエスト形式の詳細については以下を参照してください。 |
columns | レポートに含めるカラムのカンマ区切りリスト 指定可能なカラムは以下を参照してください。例： day,campaign。 |
report_type | advertiser（必須） |
1 このAPIのリクエスト可能期間は90日間です。日付パラメータが過去90日以内であることを確認してください。
任意パラメータ
| パラメータ | 目的 |
|---|---|
day_column | メトリクスはデフォルトでリアルタイムです。コホート配下のメトリクス（配信時間に帰属するメトリクス）を取得したい場合は、これをdayに設定してください。 |
limit | 返される行数の上限。例：500 |
offset | 行の取得を開始するオフセット。例：100 |
having | 数値に対する複雑なフィルタリングを可能にします。 このパラメータは、数値カラム、比較演算子、論理演算子のURLエンコードされた値を受け入れます。例： impressions%20%3E%200%20AND%20cost%20%3E%200（「impressions > 0 AND cost > 0」）。注意: これによりレスポンスが遅くなり、タイムアウトの可能性が高まります。 |
not_zero | すべての数値メトリクスの値が0である結果をフィルタリングして除外するには、これを1に設定します。 |
推奨カラム
| カラム名 | 含まれる内容 |
|---|---|
campaign | キャンペーン名 |
campaign_id_external | キャンペーンの一意の参照ID キャンペーン名が変更されても、この値は変更されません。 {CAMPAIGN_ID}クリックマクロと同じ値です。 |
cost | 広告主の支出額（spend） |
country | 2文字の国コード |
creative_set | クリエイティブセット名 |
creative_set_id | クリエイティブセットID。クリエイティブセット名が変更されても、この値は変更されません。 |
day | レポートデータのデータ日付 |
hour | レポートデータの時間（過去30日間のみ利用可能） |
任意カラム
| カラム名 | 含まれる内容 |
|---|---|
average_cpc | 平均クリック単価（Average cost per click） |
campaign_bid_goal | CPPおよびCPEキャンペーンにおける、ドル値（$）で表されたキャンペーン入札目標。このカラムをリクエストする場合は、campaignカラムも同時にリクエストする必要があります。 |
campaign_type | キャンペーンの最適化タイプ（CPP、CPE、またはROAS） |
audience_strategy | キャンペーンのオーディエンス最適化戦略（universal、prospecting、またはdiscovery） |
sales_«x»1 | 特定の期間内における売上（«x»は0d、1d、2d、3d、7d、14d、28dのいずれか） |
chka_usd_«x»1 | 特定の期間内に発生した、帰属する総チェックアウト売上（«x»は0d、1d、2d、3d、7d、14d、28dのいずれか） |
clicks | クリック数 |
cpp_«x»1 | 特定の期間内における購入単価（Cost per purchase）（«x»は0d、1d、2d、3d、7d、14d、28dのいずれか） |
ctr | クリック数 ÷ インプレッション数 |
custom_page_id | 特定のランディングページ |
impressions | インプレッション数 |
optimization_day_target | キャンペーンでターゲットとして選択した最適化日数（例：0日目または7日目） |
placement_type | INTER または REWARDED_INTER |
platform | android、ios、fireos、または tvos |
roas_«x»1 | 特定の期間内における総ROAS（«x»は0d、1d、2d、3d、7d、14d、28dのいずれか） |
sales | 帰属する売上イベントの件数 |
1期間は、インプレッション時間からのローリングウィンドウとして指定されます。0dはインプレッション時間から24時間以内のイベント、1dは48時間、2dは72時間などを意味します。
新規顧客データカラム
| カラム名 | 含まれる内容 |
|---|---|
nc_d0_checkouts | インプレッションから24時間以内に新規顧客によって行われたチェックアウトの数。 |
nc_d0_checkout_rev | インプレッションから24時間以内に測定された新規顧客からの総売上。 |
nc_d0_cpp | 支出額（spend）を新規顧客のD0チェックアウト数で割った値。 |
nc_d0_roas | 新規顧客のD0チェックアウト売上を支出額（spend）で割った値。 |
nc_percent_d0_checkouts | 新規顧客によって生成されたD0チェックアウトの割合。 |
nc_percent_d0_checkout_rev | 新規顧客によって生成されたD0チェックアウト売上の割合。 |
nc_d7_checkouts | インプレッションから192時間（7日間）以内に新規顧客によって行われたチェックアウトの数。 |
nc_d7_checkout_rev | インプレッションから192時間（7日間）以内に測定された新規顧客からの総売上。 |
nc_d7_cpp | 支出額（spend）を新規顧客のD7チェックアウト数で割った値。 |
nc_d7_roas | 新規顧客のD7チェックアウト売上を支出額（spend）で割った値。 |
nc_percent_d7_checkouts | 新規顧客によって生成されたD7チェックアウトの割合。 |
nc_percent_d7_checkout_rev | 新規顧客によって生成されたD7チェックアウト売上の割合。 |
new_visitor_rate | ウェブサイトへのアクセスのうち、新規ビジターによるアクセスの割合。 |
CPEカラム
| カラム名 | 含まれる内容 |
|---|---|
cost_per_target_event_0d | 支出額（spend）を、インプレッションから24時間以内に発生したターゲットイベントの数で割った値。 |
target_event | キャンペーンが最適化の対象とするイベントの名前。 |
target_event_count_0d | インプレッションから24時間以内に顧客によってトリガーされたターゲットイベントの数。 |
カラムのフィルタリング
任意のカラムでレポートをフィルタリングできます。 フィルタリングを行うと、指定したフィルターのいずれかに完全一致するデータが検索されます。
カラムでフィルタリングするには、次のURLパラメータを追加します：filter_columnname=«onefilter,anotherfilter,thirdfilter»
例えば、Androidプラットフォームのデータのみを表示したい場合は、次のURLパラメータを設定します：filter_platform=Android
すべてのカラムの一覧については、上記の表を参照してください。
一部のカラムでは、filter_not_columnname=«onefilter,anotherfilter» を使用した除外フィルター（否定フィルター）をサポートしています。
また、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 です。
すべてのソートは辞書順（lexicographical sort）で行われます。
レポートフォーマット
レポートはJSONまたはCSVの2つのフォーマットでリクエストできます。
タイムゾーン
Reporting 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
Cookieの設定