# AppLovin Revenue Reporting API

TIP

データ統合によって生成されたデータは、クラスターのデータ消費量にカウントすることに注意してください。

# 概要

API名	統合タイプ	データ粒度	アトリビューション	コスト	収益	インプレッション	クリック	コンバージョン
Revenue Reporting API	API	集計			✅	✅

AppLovinは、Max収益の集計指標APIであるRevenue Reporting API (opens new window)を提供しています。

AppLovin のバックエンドにログインし、Report Keyを入手します。
TE のバックエンドにログインし、サードパーティ統合に進み、AppLovin Revenue Reporting API のプランを追加し、関連設定を完了します。
TEシステムがデータを正常に受信し、レポートの構築が完了したかどうかを確認してください。

AppLovinのバックエンドにログインし、「Account」-「Key」からReport Keyを取得してください。このキーはしっかり保管してください。

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

「認証情報」ボタンをクリックし、ポップアップ内で取得した認証情報を入力してください。

「定期取得」モジュールで、TE システムが AppLovin Basic Reporting API データを定期的の取得を設定できます。特定の時間帯ごとや毎時など、データを一定期間ごとに取得することができます。

「イベントテーブルへのデー格納設定」を有効にすると、送信されたデータはすべてイベントテーブルに書き込まれます。イベントデータの格納をお勧めします。

データの取り込みの詳細設定を統合構成モジュールで制御することができます。これには、データの時間集計粒度、取り込む指標フィールドや次元、およびイベント名などが含まれます。

統合構成の内容はJSON形式であり、以下の内容に従ってカスタマイズ設定が可能です：

モジュール	名称	意味
sink_event	event_name	格納後のイベント名は、カスタマイズできます。
source	metrics	データ内の指標、リストタイプ、異なるレベルで異なるmetricsがサポートされています。入力する際には注意が必要です。
source	group_by	データのグループ化、リストタイプ、異なるレベルでのサポートには異なる group_by が必要です。入力時に注意してください。

- グループ粒度

以下は、source.group_by を変更することでサポートするグループ分けの粒度です。

フィールド	デフォルト	説明
day	yes	広告インプレッション日付
hour	yes	レポートの時間値（最近30日間のみ存在する場合）
has_idfa	yes	ユーザーの広告IDを取得できますか？ユーザーがLATを有効にしているか、またはGDPR適用地域内でデータトラッキングを無効にしている場合、この値は0になります。それ以外の場合は1です。
max_ad_unit	yes	MAX 広告名
max_ad_unit_id	yes	MAX 広告 ID
max_ad_unit_test	yes	広告テストグループの名前
network_placement	yes	Ad Network の Placement 名
max_placement		SDKでカスタムされたPlacement名
network	yes	広告露出のAd Network、値は参考（[MAX Mediation Documentation (](https://dash.applovin.com/documentation/mediation/features/ad-unit-automation-api#ad-networks)[applovin.com](https://dash.applovin.com/documentation/mediation/features/ad-unit-automation-api#ad-networks)[)](https://dash.applovin.com/documentation/mediation/features/ad-unit-automation-api#ad-networks)）
package_name	yes	パッケージ名、App Package NameとiOSアプリのBundle ID (iOS)
platform	yes	プラットフォーム
ad_format	yes	広告タイプ：`INTER`, `BANNER`, `REWARD`
ad_unit_waterfall_name	yes	広告 Waterfall の名称
application	yes	app名
country	yes	Country Code
custom_network_name	yes	カスタム広告 Ad Networkの名前
device_type	yes	デバイスタイプ：`PHONE`, `TABLET`
store_id		Androidではパッケージ名、iOSではiTunes IDの数字部分です

- 対応指標

以下はサポートされている指標フィールドです。調整が必要な場合は、source.metricsを変更してください。

フィールド	デフォルト	説明
impressions	yes	広告インプレッション
estimated_revenue	yes	予測の総収益（ドル）
attempts	yes	Ad Networkの広告は、プル数を試みます（ネットワークまたはnetwork_placementフィールドが存在する場合にのみ使用可能であり、max_placementが存在する場合は使用できません）
ecpm	yes	予測の eCPM（ドル）
fill_rate	yes	広告fill率 = 広告応答数 / リクエスト数（グループ内の取得フィールドに network または network_placement が存在する場合のみ使用可能で、max_placement が存在する場合は使用不可）
responses	yes	広告応答数（networkまたはnetwork_placementフィールドがグループ内で取得可能な場合にのみ使用可能であり、max_placementが存在する場合は使用不可）
requests		広告リクエスト数（ネットワークまたはnetwork_placement、max_placementが存在する場合は使用不可）

デフォルトでは、取得したデータはイベント形式でTEプロジェクトに書き込まれます。

「hour」フィールドが存在しない场合（すなわち、30日前のデータ）、データ内の「day」フィールドを使用します。これがデータの日付で、AGGREGATE データの「#event_time」に設定します。「hour」フィールドが存在する场合、「day」と「hour」フィールドを結合して AGGREGATE データの「#event_time」に設定します。
データイベント名は「-- applovin_maxreport」です。
残りのフィールドはすべて格納します。

以下のイベントプロパティは標準化処理されます。