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

AppLovin Asset Reporting API

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

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

概要​

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

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

AppLovin Asset Reporting APIは、素材階層の集計された配信データを取得するために使用します。素材、広告キャンペーン、広告グループ、露出、クリック、コストなどの情報が含まれます。

現在の統合では、AppLovinの日付型のAsset Reporting APIを使用しています：

GET https://r.applovin.com/assetAnalyticsReport

AppLovinによると、前日のデータはUTC 06:00以降に確定します。インターフェースでは直近45日間のデータのみリクエストできます。

統合の流れ​

  1. AppLovin管理画面にログインし、Report Keyを取得します。
  2. AE管理画面にログインし、サードパーティ統合モジュールでAppLovin Asset Reporting APIプランを新規作成して設定を完了します。
  3. 一回取得を実行するか定期タスクの実行を待ち、イベントテーブルがデータを正常に受信したことを確認します。
  4. 素材、広告キャンペーン、広告グループ、コスト、露出、クリックなどのフィールドに基づいて分析レポートを作成します。

1. Report Keyの取得​

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

2. プランの設定​

2.1 認証情報の設定​

「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップにAppLovin Report Keyを入力します。

2.2 定期取得​

「定期取得」モジュールでデータ取得の方法を設定できます。毎日UTC+8 16:00に過去1日分のデータを取得することをお勧めします。この時点で、AppLovinの前日のデータはUTC 06:00の確定時刻を過ぎています。

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

Asset Reporting APIのデータはイベントテーブルでの分析に使用します。プランを作成する際は「イベントデータの格納設定」をオンにしてください。取得したデータは設定したイベント名で書き込まれます。

2.4 統合構成​

統合構成はJSONオブジェクトで、格納イベント名、リクエスト列、数値フィールドの型、インターフェースのフィルターパラメータを設定できます。

モジュール名前タイプ意味
sink_eventevent_name文字列格納後のイベント名。カスタマイズ可能
sourcegroup_by文字列リストリクエストする素材および広告階層のディメンション
sourcemetrics文字列リストリクエストする数値指標
transferdouble_columns文字列リスト数値型で書き込む指標フィールド
トップレベルパラメータlimit文字列日付ごとのリクエストで返される最大行数
トップレベルパラメータoffset文字列日付ごとのリクエストでデータの読み取りを開始するオフセット
トップレベルパラメータnot_zero整数1に設定すると、すべての数値指標が0の結果を除外します
トップレベルパラメータallPurposeJSON文字列ディメンションフィルター、除外フィルター、数値しきい値フィルター

デフォルトテンプレート​

{
  "sink_event": {
    "event_name": "applovin_asset_report"
  },
  "sink_user": [],
  "source": {
    "group_by": [
      "asset_id",
      "asset_name",
      "asset_url",
      "campaign",
      "campaign_id",
      "campaign_package_name",
      "creative_set",
      "creative_set_id"
    ],
    "metrics": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  },
  "transfer": {
    "double_columns": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  }
}

テンプレートの説明：

  • source.group_byとsource.metricsは、AppLovinリクエストのcolumnsパラメータにまとめられます。
  • clicks、cost、ctr、impressionsは、数値型で書き込まれるように、transfer.double_columnsにも設定する必要があります。
  • テンプレートのイベント名はapplovin_asset_reportで、必要に応じて変更できます。
  • システムは固定でformat=jsonをリクエストし、sort_impressions=DESCを固定で使用して露出数の降順で並べ替えます。

フィルターとページングのパラメータを含む完全な例​

次の例は、指定した2つの素材名でフィルターし、cost > 10かつimpressions > 2000のデータのみを残し、すべての数値指標が0の結果を除外して、日付ごとに1行目から最大100行を読み取ることを表しています。

{
  "limit": "100",
  "offset": "0",
  "not_zero": 1,
  "allPurpose": "{\"asset_name\":\"素材A.mp4,素材B.html\",\"greater_than_cost\":10,\"greater_than_impressions\":2000}",
  "sink_event": {
    "event_name": "applovin_asset_report"
  },
  "sink_user": [],
  "source": {
    "group_by": [
      "asset_id",
      "asset_name",
      "asset_url",
      "campaign",
      "campaign_id",
      "campaign_package_name",
      "creative_set",
      "creative_set_id"
    ],
    "metrics": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  },
  "transfer": {
    "double_columns": [
      "clicks",
      "cost",
      "ctr",
      "impressions"
    ]
  }
}

2.5 選択可能なディメンションと指標​

選択可能なディメンション​

必要なディメンションをsource.group_byに書き込んでください。

フィールド名デフォルトかどうか意味
asset_idはい素材ID
asset_nameはい素材名
asset_urlはい処理前の元の素材のURL
campaignはいCampaign名
campaign_idはいCampaignの一意の識別子。Basic Reporting APIのcampaign_id_externalに対応します
campaign_package_nameはいCampaignでプロモーションするアプリのパッケージ名
creative_setはいCreative Set名。つまり広告グループ名
creative_set_idはいCreative Set ID。名前が変わってもIDは変わりません

選択可能な指標​

必要な指標をsource.metricsに書き込み、数値フィールドはtransfer.double_columnsにも書き込んでください。

フィールド名デフォルトかどうか意味
clicksはいクリック数
costはい広告主の支出
ctrはいクリック数を露出数で割った値
impressionsはい露出数

3. 標準化フィールド​

次のフィールドは、te_ads_object内の対応するプラットフォーム標準フィールドに書き込まれます：

元フィールド標準化フィールドタイプ意味
campaignte_ads_object.campaign_namestring広告キャンペーン名
campaign_idte_ads_object.campaign_idstring広告キャンペーンID
campaign_package_namete_ads_object.app_namestringプロモーションアプリのパッケージ名
creative_sette_ads_object.ad_group_namestring広告グループ名
creative_set_idte_ads_object.ad_group_idstring広告グループID
costte_ads_object.costdouble広告コスト
clickste_ads_object.clicksdoubleクリック数
impressionste_ads_object.impressionsdouble露出数
このページは役に立ちましたか？
このページの内容