search
このReporting APIを使用して、JSONまたはCSV形式で集計されたWebキャンペーンデータを取得します。
このエンドポイントでは、アトリビューションモードを指定できます。
以下のベースURLにHTTP GETリクエストを送信して、レポートリクエストを行います。
https://r.applovin.com/webReport| パラメータ | 目的 |
|---|---|
api_key | レポートキー レポートキーは、AppLovin dashboardの右上にあるアカウントをクリックし、Keysを選択することで確認できます。 |
start1 | レポートの開始日«YYYY-MM-DD»形式の日付またはUnixタイムスタンプを受け入れます。例：2012-10-05または1336608000。 |
end1 | レポートの終了日«YYYY-MM-DD»形式の日付またはUnixタイムスタンプを受け入れます。例：2012-10-05、1336608000、またはnow。 |
format | レポートの形式jsonまたはcsvを受け入れます。 |
columns | レポートのカンマ区切りの列リスト 許可されている列については以下を参照してください。例： day,campaign。 |
report_type | advertiser（必須） |
attribution_mode | レポートのアトリビューションモードclick（click-throughアトリビューションのみ）またはclick_and_view（click-throughおよびview-throughアトリビューション）を受け入れます。 |
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 | キャンペーンへの一意の参照 これはキャンペーン名が変更されても変更されません。 {CAMPAIGN_ID}クリックマクロと同じ値です。 |
cost | 広告主の支出 |
country | 2文字の国コード |
creative_set | クリエイティブセット名 |
creative_set_id | クリエイティブセットID。クリエイティブセット名が変更されても、これは変更されません。 |
day | レポートデータの統計日 |
hour | レポートデータの時間（過去30日間のみ利用可能） |
| 列名 | 含まれる内容 |
|---|---|
ad_id | 広告ID |
audience_strategy | キャンペーンのオーディエンス最適化戦略（universal、prospecting、またはdiscovery） |
average_cpc | 平均CPC |
campaign_bid_goal | CPPおよびCPEキャンペーンにおける、ドル値（$）で表されるキャンペーンのbid目標。この列をリクエストする場合は、campaign列もリクエストする必要があります。 |
campaign_type | キャンペーンの最適化タイプ（CPP、CPE、またはROAS） |
chka_usd_«x»1 | 特定の期間におけるアトリビュートされた合計チェックアウト売上（«x»は0d、1d、3d、7d、14d、28dのいずれか） |
clicks | クリック数 |
cpp_«x»1 | 特定の期間における購入単価（«x»は0d、1d、3d、7d、14d、28dのいずれか） |
ctr | クリック数 ÷ impression数 |
impressions | impression数 |
optimization_day_target | キャンペーンのターゲットとして選択した最適化日数（例：0日目または7日目） |
placement_type | INTER、REWARDED_INTER、またはCTV |
platform | android、ios、fireos、tvos、またはctv |
roas_«x»1 | 特定の期間における合計ROAS（«x»は0d、1d、3d、7d、14d、28dのいずれか） |
sales | アトリビュートされた販売イベントの数 |
sales_«x»1 | 特定の期間における販売数（«x»は0d、1d、3d、7d、14d、28dのいずれか） |
1期間は、impression時間からのローリングウィンドウとして指定されます。0dはimpression時間から24時間以内のイベント、1dは48時間、3dは96時間などを意味します。
| 列名 | 含まれる内容 |
|---|---|
nc_d0_checkouts | impressionから24時間以内に新規顧客によって行われたチェックアウトの数。 |
nc_d0_checkout_rev | impressionから24時間以内に測定された新規顧客からの合計売上。 |
nc_d0_cpp | 支出を新規顧客のD0チェックアウト数で割った値。 |
nc_d0_roas | 新規顧客のD0チェックアウト売上を支出で割った値。 |
nc_percent_d0_checkouts | 新規顧客によって生成されたD0チェックアウトの割合。 |
nc_percent_d0_checkout_rev | 新規顧客によって生成されたD0チェックアウト売上の割合。 |
nc_d7_checkouts | impressionから192時間以内に新規顧客によって行われたチェックアウトの数。 |
nc_d7_checkout_rev | impressionから192時間以内に測定された新規顧客からの合計売上。 |
nc_d7_cpp | 支出を新規顧客のD7チェックアウト数で割った値。 |
nc_d7_roas | 新規顧客のD7チェックアウト売上を支出で割った値。 |
nc_percent_d7_checkouts | 新規顧客によって生成されたD7チェックアウトの割合。 |
nc_percent_d7_checkout_rev | 新規顧客によって生成されたD7チェックアウト売上の割合。 |
new_visitor_rate | Webサイトへのアクセスのうち、新規ビジターからのアクセスの割合。 |
| 列名 | 含まれる内容 |
|---|---|
generate_lead_«x» | 指定された期間内に少なくとも1つのリードを生成したimpression数（«x»は0d、1d、3d、7d、14d、28dのいずれか）。 |
cost_per_lead_«x» | 特定の期間における支出をリード数で割った値（«x»は0d、1d、3d、7d、14d、28dのいずれか）。 |
lead_roas_«x» | 特定の期間における、生成されたリード価値を広告支出で割った値（«x»は0d、1d、3d、7d、14d、28dのいずれか）。 |
任意の列でレポートをフィルタリングできます。 フィルタリングを行うと、いずれかのフィルターに直接一致するものが検索されます。
列でフィルタリングするには、次のURLパラメータを追加します：filter_columnname=«onefilter,anotherfilter,thirdfilter»
たとえば、Androidプラットフォームのデータのみを表示したい場合は、次のURLパラメータを設定します：filter_platform=Android
すべての列のリストについては、上記の表を参照してください。
一部の列では、filter_not_columnname=«onefilter,anotherfilter»による除外フィルターをサポートしています。
レポートのソートは、レポートのフィルタリングと同様の方法で行います。
たとえば、レポートをcampaignでソートするには、次のURLパラメータを追加します：sort_campaign=ASC
受け入れられる値は、昇順の場合はASC、降順の場合はDESCです。
すべてのソートは辞書式順序でソートされます。
レポートはJSONまたはCSVの2つの形式でリクエストできます。
Reporting APIのすべてのデータはUTC（協定世界時）です。
https://r.applovin.com/webReport?api_key=«your-report-key»&start=2024-04-20&end=now&columns=day,campaign,impressions,clicks,ctr,cost,sales&format=json&report_type=advertiser&attribution_mode=click
Cookieの設定