AppLovin Cohort API統合プラン
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Cohort API | API | 集計データ | ✅ | ✅ |
AppLovinのCohort APIは、リテンション分析モデルに似た、新規獲得後N日目のデータを返すことができます。新規獲得後N日目のマネタイズや露出などのデータが含まれます。詳しくはCohort APIドキュメントを参照してください。
統合の流れ
- AppLovin管理画面にログインし、Report Keyを取得します
- AE管理画面にログインし、サードパーティ統合モジュールでAppLovin Cohort APIプランを追加して、関連する設定を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. Report Keyの取得
AppLovin Cohort APIのデータを統合するには、まずReport Keyを取得する必要があります。AppLovin管理画面にログインし、「Account」-「Key」でReport Keyを取得してください。このKeyは大切に保管してください
2. プランの設定
Report Keyを取得したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を行います。下図はAppLovin Cohort APIの設定画面です。本章の内容に従ってプランを作成してください：
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに認証作業で取得した情報を入力します
API Keyは、先ほど取得したReport Keyです。ポップアップのAPI Keyはデフォルトでは直接入力できないため、先に右側の編集アイコンをクリックしてから入力してください。
2.2 定期取得
「定期取得」モジュールで、AEシステムがAppLovin Cohort APIのデータを定期的に取得する方法を設定できます。毎日の特定の時刻、または1時間ごとに、一定期間のデータを取得するよう選択できます。
2.3 イベントデータの格納設定
「イベントデータの格納設定」スイッチをオンにすると、コールバックされたデータはすべてイベントテーブルに書き込まれます。イベントデータの格納を有効にすることをお勧めします。
2.4 統合構成
統合構成モジュールで、データ取得の詳細な設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_mapping | 格納後のイベント名。カスタマイズ可能 |
| source | report_types | データを取得するレポートタイプ。レポートタイプによってデータの差異が大きすぎるため、入力できるレポートタイプは1つだけです。複数入力した場合は、リストの最初のレポートタイプのみが取得されます |
| metrics | データ内の指標。リスト型。レポートタイプによって対応するmetricsが異なるため、入力時に注意が必要です | |
| group_by | データ内のグループ化ディメンション。リスト型。レポートタイプによって対応するgroup_byが異なるため、入力時に注意が必要です |
2.4.1 revenueレポート
- テンプレート
以下はrevenueレポートのテンプレートです。revenueレポートを取得したい場合は、次のJSONをコピーして統合構成に貼り付け、必要に応じて調整してください：
{
"sink_event": {
"event_mapping": {
"revenue": "applovin_revenue_cohort_data",
"session": "applovin_session_cohort_data",
"imp": "applovin_imp_cohort_data"
}
},
"source": {
"group_by": [
"day",
"application",
"package_name",
"platform",
"country"
],
"report_types": [
"revenue"
],
"metrics": [
"pub_revenue_0",
"iap_pub_revenue_0",
"ads_pub_revenue_0",
"reward_pub_revenue_0",
"inter_pub_revenue_0",
"banner_pub_revenue_0",
"mrec_pub_revenue_0",
"rpi_0",
"iap_rpi_0",
"ads_rpi_0",
"reward_rpi_0",
"inter_rpi_0",
"banner_rpi_0",
"mrec_rpi_0"
]
}
}
- グループ化ディメンション
以下は対応しているグループ化ディメンションです。調整が必要な場合は、source.group_byを変更できます
| フィールド | 説明 | 値の例 |
|---|---|---|
| day | データ日付 | 2019/3/25 |
| application | アプリ名 | My App |
| package_name | アプリのパッケージ名またはBundle ID | com.my.test.app |
| platform | アプリのプラットフォーム。値：android, fireos, ios | android |
| country | 2文字のCountry Code | gb |
- 指標フィールド
以下は対応している指標フィールドです。調整が必要な場合は、source.metricsを変更できます。Xは必要な日数に置き換えてください（選択可能な値：0, 1, 2, 3, 4, 5, 6, 7, 10, 14, 18, 21, 24, 27, 30, 45）
| フィールド | 説明 | 値の例 |
|---|---|---|
| pub_revenue_X | インストール後X日目の総収益 | 39.35 |
| iap_pub_revenue_X | インストール後X日目のアプリ内課金収益 | 21.23 |
| ads_pub_revenue_X | インストール後X日目の広告収益 | 18.12 |
| reward_pub_revenue_X | インストール後X日目のリワード動画広告収益 | 9.12 |
| inter_pub_revenue_X | インストール後X日目のインタースティシャル広告収益 | 6.1 |
| banner_pub_revenue_X | インストール後X日目のBanner広告収益 | 2.54 |
| mrec_pub_revenue_X | インストール後X日目のMREC（中型レクタングル）広告収益 | 0.48 |
| rpi_X | インストール後X日目のインストールあたりの総収益 | 0.15 |
| iap_rpi_X | インストール後X日目のインストールあたりのアプリ内課金収益 | 0.08 |
| ads_rpi_X | インストール後X日目のインストールあたりの広告収益 | 0.07 |
| reward_rpi_X | インストール後X日目のインストールあたりのリワード動画広告収益 | 0.05 |
| inter_rpi_X | インストール後X日目のインストールあたりのインタースティシャル広告収益 | 0.04 |
| banner_rpi_X | インストール後X日目のインストールあたりのBanner広告収益 | 0.03 |
| mrec_rpi_X | インストール後X日目のインストールあたりのMREC（中型レクタングル）広告収益 | 0.02 |
2.4.2 impレポート
- テンプレート
以下はimpレポートのテンプレートです。impレポートを取得したい場合は、次のJSONをコピーして統合構成に貼り付け、必要に応じて調整してください：
{
"sink_event": {
"event_mapping": {
"revenue": "applovin_revenue_cohort_data",
"session": "applovin_session_cohort_data",
"imp": "applovin_imp_cohort_data"
}
},
"source": {
"group_by": [
"day",
"application",
"package_name",
"platform",
"country"
],
"report_types": [
"imp"
],
"metrics": [
"installs",
"user_count_0",
"imp_0",
"imp_per_user_0",
"inter_imp_0",
"inter_imp_per_user_0",
"reward_imp_0",
"reward_imp_per_user_0",
"banner_imp_0",
"banner_imp_per_user_0",
"mrec_imp_0",
"mrec_imp_per_user_0"
]
}
}
- グループ化ディメンション
以下は対応しているグループ化ディメンションです。調整が必要な場合は、source.group_byを変更できます
| フィールド | 説明 | 値の例 |
|---|---|---|
| day | データ日付 | 2019/3/25 |
| application | アプリ名 | My App |
| package_name | アプリのパッケージ名またはBundle ID | com.my.test.app |
| platform | アプリのプラットフォーム。値：android, fireos, ios | android |
| country | 2文字のCountry Code | gb |
- 指標フィールド
以下は対応している指標フィールドです。調整が必要な場合は、source.metricsを変更できます。Xは必要な日数に置き換えてください（選択可能な値：0, 1, 2, 3, 4, 5, 6, 7, 10, 14, 18, 21, 24, 27, 30, 45）
| フィールド | 説明 | 値の例 |
|---|---|---|
| installs | 新規インストール数 | 2842 |
| user_count_X | インストール後X日目の総アクティブユーザー数 | 612 |
| imp_X | インストール後X日目の広告の総露出数 | 6120 |
| imp_per_user_X | インストール後X日目のユーザーあたりの平均広告露出数：imp_X / user_count_X | 10 |
| inter_imp_X | インストール後X日目のインタースティシャル広告露出数 | 1224 |
| inter_imp_per_user_X | インストール後X日目のユーザーあたりの平均インタースティシャル広告露出数：inter_imp_X / user_count_X | 2 |
| reward_imp_X | インストール後X日目のリワード動画広告露出数 | 1836 |
| reward_imp_per_user_X | インストール後X日目のユーザーあたりの平均リワード動画広告露出数：reward_imp_X / user_count_X | 3 |
| banner_imp_X | インストール後X日目のBanner広告露出数 | 2448 |
| banner_imp_per_user_X | インストール後X日目のユーザーあたりの平均Banner広告露出数：banner_imp_X / user_count_X | 4 |
| mrec_imp_X | インストール後X日目のMREC（中型レクタングル）露出数 | 612 |
| mrec_imp_per_user_X | インストール後X日目のユーザーあたりの平均MREC（中型レクタングル）広告露出数：mrec_imp_X / user_count_X | 1 |
2.4.3 sessionレポート
- テンプレート
以下はsessionレポートのテンプレートです。sessionレポートを取得したい場合は、次のJSONをコピーして統合構成に貼り付け、必要に応じて調整してください：
{
"sink_event": {
"event_mapping": {
"revenue": "applovin_revenue_cohort_data",
"session": "applovin_session_cohort_data",
"imp": "applovin_imp_cohort_data"
}
},
"source": {
"group_by": [
"day",
"application",
"package_name",
"platform",
"country"
],
"report_types": [
"session"
],
"metrics": [
"installs",
"daily_usage_0",
"session_count_0",
"user_count_0",
"session_length_0",
"retention_0"
]
}
}
- グループ化ディメンション
以下は対応しているグループ化ディメンションです。調整が必要な場合は、source.group_byを変更できます
| フィールド | 説明 | 値の例 |
|---|---|---|
| day | データ日付 | 2019/3/25 |
| application | アプリ名 | My App |
| package_name | アプリのパッケージ名またはBundle ID | com.my.test.app |
| platform | アプリのプラットフォーム。値：android, fireos, ios | android |
| country | 2文字のCountry Code | gb |
- 指標フィールド
以下は対応している指標フィールドです。調整が必要な場合は、source.metricsを変更できます。Xは必要な日数に置き換えてください（選択可能な値：0, 1, 2, 3, 4, 5, 6, 7, 10, 14, 18, 21, 24, 27, 30, 45）
| フィールド | 説明 | 値の例 |
|---|---|---|
| installs | 新規インストール数 | 2842 |
| daily_usage_X | インストール後X日目のユーザーの平均オンライン時間（秒） | 501 |
| session_count_X | インストール後X日目の総Session数 | 1240 |
| user_count_X | インストール後X日目の総アクティブユーザー数 | 401 |
| session_length_X | インストール後X日目のユーザーの平均Session時間（秒）：daily_usage_X / session_count_X | 0.404 |
| retention_X | インストール後X日目の継続率：user_count_X / installs | 0.141 |
2.5 データの格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
-
データ内のdayフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
-
データのイベント名は次のとおりです：
- applovin_revenue_cohort_data
- applovin_imp_cohort_data
- applovin_session_cohort_data
-
その他のフィールドはすべて格納されます
2.6 標準化フィールド
次のイベントプロパティは標準化処理されます：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| package_name | te_ads_object.app_id | アプリID |
| application | te_ads_object.app_name | アプリ名 |
| platform | te_ads_object.platform | プラットフォーム（Android、iOSなど） |
| country | te_ads_object.country | 国・地域コード |
| 【USD】固定値 | te_ads_object.currency | マネタイズ収益の通貨 |
| installs | te_ads_object.installs | インストール数 |