メインコンテンツまでスキップ

AppLovin Basic Reporting API

最終更新 2026/10/03
ヒント

サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください

概要​

インターフェースの概要​

インターフェース名タイプ粒度アトリビューションコスト収益表示クリックコンバージョン
Basic Reporting APIAPI集計データ✅✅✅✅✅

ユーザー粒度の収益データのほかに、AppLovinは集約指標のAPI、つまりBasic Reporting APIも提供しています。

統合の流れ​

  1. AppLovin管理画面にログインし、Report Keyを取得します
  2. AE管理画面にログインし、サードパーティ統合モジュールでAppLovin Basic Reporting APIプランを追加して、関連する設定を完了します
  3. AEシステムがデータを正常に受信しているかを確認し、レポートを作成します

1. Report Keyの取得​

AppLovin Basic Reporting APIのデータを統合するには、まずReport Keyを取得する必要があります。AppLovin管理画面にログインし、「Account」-「Key」でReport Keyを取得してください。このKeyは大切に保管してください

2. プランの設定​

Report Keyを取得したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を行います。下図はAppLovin Basic Reporting APIの設定画面です。本章の内容に従ってプランを作成してください：

2.1 認証情報の設定​

「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに認証作業で取得した情報を入力します

API Keyは、先ほど取得したReport Keyです

2.2 定期取得​

「定期取得」モジュールで、AEシステムがAppLovin Basic Reporting APIのデータを定期的に取得する方法を設定できます。毎日の特定の時刻、または1時間ごとに、一定期間のデータを取得するよう選択できます。

2.3 イベントデータの格納設定​

「イベントデータの格納設定」スイッチをオンにすると、取得したデータはすべてイベントテーブルに書き込まれます。イベントデータの格納を有効にすることをお勧めします。

2.4 統合構成​

統合構成モジュールで、データ取得の詳細な設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。

統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：

モジュール名前意味
sink_eventevent_name格納後のイベント名。カスタマイズ可能
source

report_types

データを取得する階層。リスト型です。要素は1つだけ入力すること、つまり一度に1つの階層のデータのみを取得することをお勧めします

選択可能な値: advertiser、publisher

metricsデータ内の指標。リスト型です。階層によって対応するmetricsが異なるため、入力時に注意が必要です
group_byデータ内のグループ化ディメンション。リスト型です。階層によって対応するgroup_byが異なるため、入力時に注意が必要です

Basic Reporting APIは、広告主レポート（advertiser）とパブリッシャーレポート（publisher）という、まったく異なる2種類のレポートを提供しています。以下の各節では、この2種類のレポートの設定方法をそれぞれ紹介します：

2.4.1 広告主レポート（advertiser）​

広告主レポートのテンプレートは次のとおりです：

{
    "sink_event":
    {
        "event_name": "applovin_advertiser"
    },
    "source":
    {
        "group_by":
        [
            "day",
            "campaign",
            "campaign_id_external",
            "creative_set",
            "creative_set_id",
            "ad_id",
            "ad",
            "ad_type",
            "campaign_ad_type",
            "campaign_package_name",
            "campaign_store_id",
            "campaign_type",
            "country",
            "device_type",
            "external_placement_id",
            "platform",
            "size",
            "traffic_source"
        ],
        "report_types":
        [
            "advertiser"
        ],
        "metrics":
        [
            "impressions",
            "clicks",
            "ctr",
            "conversions",
            "conversion_rate",
            "average_cpa",
            "average_cpc",
            "cost",
            "sales"
        ]
    }
}
  • テンプレートで使用される時間粒度は日単位です（広告主レポートは時間単位の集計に対応していません）。システムはデータ内のdayフィールド、つまりデータの日付をデータの時刻として使用します
  • テンプレートで使用されるイベント名は -- applovin_advertiser
  • その他のフィールドはすべて格納されます
  • 選択可能なディメンション

以下は広告主レポートで選択可能なディメンションです。実際の必要に応じて調整できます。必要なフィールドのフィールド名をsource.group_byに書き込んでください

フィールド名デフォルトかどうか意味
dayはいレポートの日付
campaignはいCampaign名
campaign_id_externalはいCampaignの一意の識別子
creative_setはい広告グループ名
creative_set_idはい広告グループID
ad_idはい広告ID
adはい広告名
ad_typeはい広告タイプ。値の例：GRAPHIC, VIDEO, REWARD, またはPLAY
applicationトラフィック元のApp名
campaign_ad_typeはいUser Acquisition Campaignの場合、この値はuaです。Retargeting Campaignの場合、この値はrtです
campaign_package_nameはいプロモーションするAppのパッケージ名。Androidではpackage name、iOSではBundle IDです
campaign_store_idはいプロモーションするAppのアプリストアID。Androidではpackage name、iOSではiTunes IDの数字部分です
campaign_typeはいCampaignの最適化目標（PP, CPE, IAP ROAS, ad ROAS, or ROAS）
custom_page_id広告グループに関連付けられたiOSのカスタムプロダクトページ、またはAndroidのストア掲載情報ページ
countryはい英字2文字のCountry Code
device_typeはいデバイスタイプ。値の例：phone, tabletまたはother
external_placement_idはいエンコードされたアプリID
optimization_day_targetCampaignの目標最適化日（例：day 0またはday 7）
platformはいデバイスプラットフォーム。値の例：android, ios, fireos, tvos
sizeはい広告サイズ。値の例：INTER, BANNER, MREC, LEADER, またはNATIVE
target_eventCampaignの課金イベント（CPE Campaignのみ有効）
traffic_sourceはいトラフィックソース。値はAppLovinまたはその他のexchangeチャンネル名です
  • 選択可能な指標

以下は広告主レポートで選択可能な指標です。実際の必要に応じて調整できます。必要なフィールドのフィールド名をsource.metricsに書き込んでください

フィールド名デフォルトかどうか意味
average_cpaはい平均CPA（インストール）
average_cpcはい平均CPC
clicksはいクリック数
conversionsはいコンバージョン数（つまりインストール数）
conversion_rateはいコンバージョン率（インストール数 / クリック数）
costはい広告コスト
ctrはいクリック率
campaign_bid_goalCampaignの入札目標
campaign_roas_goalCampaignのROAS目標
first_purchase初回アプリ内課金のユーザー数（Revenueコールバックの設定が必要）
impressionsはい露出数
salesはいアプリ内課金の回数（Revenueコールバックの設定が必要）

2.4.2 パブリッシャーレポート（publisher）​

パブリッシャーレポートのテンプレートは次のとおりです：

{
    "sink_event":
    {
        "event_name": "applovin_publisher"
    },
    "source":
    {
        "group_by":
        [
            "day",
            "hour",
            "country",
            "ad_type",
            "size",
            "device_type",
            "platform",
            "application",
            "package_name",
            "store_id",
            "placement",
            "application_is_hidden",
            "zone",
            "zone_id",
            "bidding_integration"
        ],
        "report_types":
        [
            "publisher"
        ],
        "metrics":
        [
            "impressions",
            "clicks",
            "ctr",
            "revenue",
            "ecpm"
        ]
    }
}
  • テンプレートで使用される時間粒度は時間単位です。つまり、データ内のday + hourフィールドをデータの時刻として使用します
  • テンプレートで使用されるイベント名は -- applovin_publisher
  • その他のフィールドはすべて格納されます
  • 選択可能なディメンション

以下はパブリッシャーレポートで選択可能なディメンションです。実際の必要に応じて調整できます。必要なフィールドのフィールド名をsource.group_byに書き込んでください

フィールド名デフォルトかどうか意味
dayはいレポートの日付
hourはいレポートの時間の値（直近30日間のデータの取得のみ対応）。このフィールドを使用しない場合、データの時刻はdayのみとなります
countryはい英字2文字のCountry Code
ad_typeはい広告タイプ。値の例：GRAPHIC, PLAY, VIDEO, REWARD, またはMRAID
sizeはい広告サイズ。値の例：INTER, BANNER, MREC, LEADER, またはNATIVE
device_typeはいデバイスタイプ。値の例：phone, tabletまたはother
platformはいデバイスプラットフォーム。値の例：android, ios, fireos, tvos
applicationはいApp名
package_nameはいAppのパッケージ名。Androidではpackage name、iOSではBundle IDです
store_idはいAppのアプリストアID。Androidではpackage name、iOSではiTunes IDの数字部分で、取得できない場合はBundle IDとなります
placementはいPlacement名
application_is_hiddenはいそのAppがAppLovinのダッシュボードで非表示になっているかどうか
zoneはいZone名（アカウントでZonesが有効になっている場合のみ）
zone_idはいZone ID（アカウントでZonesが有効になっている場合のみ）
bidding_integrationはい統合の入札方式（値の例：MAXまたはAdmob Open Bidding）
  • 選択可能な指標

以下はパブリッシャーレポートが返すフィールドです。実際の必要に応じて、返すフィールドを選択できます

フィールド名デフォルトかどうか意味
impressionsはい露出数
clicksはいクリック数
ctrはいクリック率
revenueはいマネタイズの総収益
ecpmはいECPM

2.5 標準化フィールド​

以下はAppLovin Basic Reporting APIの標準化フィールドです：

  • 広告主レポート
元フィールド標準化フィールド意味
traffic_sourcete_ads_object.media_sourceマネタイズチャンネル
campaignte_ads_object.campaign_name広告キャンペーン名
campaign_id_externalte_ads_object.campaign_id広告キャンペーンID
creative_sette_ads_object.ad_group_name広告グループ名
creative_set_idte_ads_object.ad_group_id広告グループID
adte_ads_object.ad_name広告名
ad_idte_ads_object.ad_id広告ID
campaign_package_namete_ads_object.app_nameアプリ名
campaign_store_idte_ads_object.app_idアプリID
countryte_ads_object.country国・地域コード
platformte_ads_object.platformプラットフォーム（Android、iOSなど）
【USD】固定値te_ads_object.currency配信の通貨
impressionste_ads_object.impressions露出数
clickste_ads_object.clicksクリック数
conversionste_ads_object.installsコンバージョン数（インストール）
costte_ads_object.costユーザー獲得コスト
  • パブリッシャーレポート
元フィールド標準化フィールド意味
countryte_ads_object.country国・地域コード
platformte_ads_object.platformプラットフォーム（Android、iOSなど）
applicationte_ads_object.app_nameアプリ名
package_namete_ads_object.app_idアプリID
placementte_ads_object.placement広告の配置
【USD】固定値te_ads_object.currencyマネタイズ収益の通貨
impressionste_ads_object.impressions露出数
clickste_ads_object.clicksクリック数
revenuete_ads_object.revenueマネタイズ収益
このページは役に立ちましたか？
このページの内容