AppsFlyer Master API
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Master API | API | 集約指標 | ✅ | ✅ | ✅ | ✅ |
Master APIは、分析ディメンションと集約指標のカスタマイズに対応しており、Pull APIの集約指標インターフェースと比べて柔軟性が高くなっています。
統合の流れ
- AppsFlyer管理画面にログインし、V2.0 API TokenとApp IDを取得します
- AE管理画面にログインし、サードパーティ統合モジュールでAppsFlyer Master APIプランを追加して、関連する設定を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. API TokenとApp IDの取得
1.1 API Tokenの取得
1.1 API Tokenの取得
Master API用のV2.0 API Tokenを取得します
1.2 App IDの取得
AppsFlyer管理画面の「My Apps」で、アプリのApp IDを確認できます。Androidではcom.で始まり（例：com.demoapp.ta）、iOSではidで始まります（例：id12345678）
2. プランの設定
AppsFlyerのAPI TokenとApp IDを取得したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を行います。下図はAppsFlyer Master APIの設定画面です。本章の内容に従ってプランを作成してください：
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップにAPI TokenとApp IDを入力します
2.2 定期取得
「定期取得」モジュールで、AEシステムがAppsFlyer Master APIのデータを定期的に取得する方針を設定できます。毎日の特定の時刻に一定期間のデータを取得するよう選択でき、1回あたり最大31日分を取得できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
2.3 取得タイムゾーン
データはプロジェクトのタイムゾーンで取得され、プランの設定には個別の取得タイムゾーンの設定はありません。「定期取得」の説明に使用するタイムゾーンが記載されます。例：「UTC+8で毎……」
2.4 格納設定
データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。
2.5 統合構成
最後に、統合構成モジュールで、データ取得の詳細な設定を制御できます。データのタイプ、取得するディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能 |
source | metrics | データ内の指標。リスト型。カスタマイズ可能 |
| group_by | データ内のグループ化ディメンション。リスト型。カスタマイズ可能 |
- グループ化ディメンション
以下はグループ化ディメンションの一覧です。調整が必要な場合は、source.group_byを変更できます。調整する際はフィールド名を使用してください。
| フィールドの意味 | フィールド名 | 格納名 | デフォルト |
|---|---|---|---|
| App ID | app_id | app_id | ✓ |
| Media Source | pid | media_source | ✓ |
| Agency | af_prt | partner | ✓ |
| Campaign | c | campaign | ✓ |
| Adset | af_adset | adset | ✓ |
| Ad | af_ad | ad | ✓ |
| Channel | af_channel | channel | ✓ |
| Publisher ID | af_siteid | publisher_id_af_siteid | ✓ |
| Keywords | af_keywords | keywords | |
| Is Primary Attribution | is_primary | is_primary_attribution | |
| Campaign ID | af_c_id | campaign_id | |
| Adset ID | af_adset_id | adset_id | |
| Ad ID | af_ad_id | ad_id | |
| Install Time | install_time | install_time | ✓ |
| Touch Type | attributed_touch_type | touch_type | ✓ |
| GEO | geo | geo | ✓ |
- 指標フィールド
Master APIにはさまざまなタイプの指標が含まれています。以下はMaster APIのよく使われるフィールドの一部です。全フィールドについては、AppsFlyer公式ドキュメントを参照してください：
一部の指標は対応するディメンションフィールドが異なります。調整が必要な場合は、ThinkingAIの担当者に連絡して操作することをお勧めします
調整が必要な場合は、source.metricsを変更できます
| 格納名 | 説明 | デフォルト |
|---|---|---|
| impressions | 露出数 | ✓ |
| clicks | クリック数 | ✓ |
| installs | インストール数 | ✓ |
| cr | コンバージョン率 | ✓ |
| sessions | Session数 | ✓ |
| loyal_users | ロイヤルユーザーのインストール数 | ✓ |
| loyal_users_rate | ロイヤルユーザーの割合 | ✓ |
| cost | 総コスト | ✓ |
| revenue | 総収益 | ✓ |
| roi | ROI | ✓ |
| arpu_ltv | 平均ライフタイムバリュー | ✓ |
| average_ecpi | 平均eCPI | ✓ |
| uninstalls | アンインストール数 | ✓ |
| uninstalls_rate | アンインストール率 | ✓ |
retention_day_[x] | N日目の継続ユーザー数（N = 0,1,2,3,4,5,6,7,15,30） | |
| retention_rate_day_[x] | N日目の継続率（N = 0,1,2,3,4,5,6,7,15,30） | |
cohort_day_[x]_total_revenue_per_user | N日目の累計収益（N = 1,2,3,4,5,6,7,15,30,40,50,60,70,80,90） | |
cohort_day_[x]_revenue_per_user | N日目当日の収益（N = 1,2,3,4,5,6,7,15,30,40,50,60,70,80,90） | |
| cohort_[x]_days_total_revenue_per_user | N日目の累計収益と同じ（N = 1,2,3,4,5,6,7,15,30,40,50,60,70,80,90） |
2.6 データの格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- Master APIの集約指標インターフェースは集計データを返すため、ユーザー識別子として固定値を使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えてください
- データ内のinstall_timeフィールド（ユーザーのインストール時刻）を、イベントの#event_timeとして使用します
- データのイベント名：appsflyer_master_data
- その他のフィールドはすべて格納されます
2.7 標準化フィールド
次のイベントプロパティは標準化処理されます：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| media_source | te_ads_object.media_source | メディアチャンネル |
| campaign | te_ads_object.campaign_name | 広告キャンペーン名 |
| campaign_id | te_ads_object.campaign_id | 広告キャンペーンID |
| adset | te_ads_object.ad_group_name | 広告グループ名 |
| adset_id | te_ads_object.ad_group_id | 広告グループID |
| ad | te_ads_object.ad_name | 広告名 |
| ad_id | te_ads_object.ad_id | 広告ID |
| app_id | te_ads_object.app_id | アプリID |
| geo | te_ads_object.country | 国・地域コード |
| impressions | te_ads_object.impressions | 露出数 |
| clicks | te_ads_object.clicks | クリック数 |
| installs | te_ads_object.installs | コンバージョン数（インストール） |
| cost | te_ads_object.cost | 配信コスト |
| revenue | te_ads_object.revenue | マネタイズ収益 |