# AppsFlyer Master API
WARNING
データ統合によって生成されたデータは、クラスターのデータ消費量にカウントすることに注意してください。
# 概要
API名 | 統合タイプ | データ粒度 | アトリビューション | コスト | 収益 | 露出 | クリック | コンバージョン |
---|---|---|---|---|---|---|---|---|
Master API | API | 集計 | ✅ | ✅ | ✅ | ✅ |
Master API (opens new window) は、カスタム分析次元および集計指標をサポートしており、Pull APIの集計指標インターフェースと比較して柔軟性が高いです。
# 統合プロセス
- AppsFlyerのバックエンドにログインし、V2.0 API TokenとApp IDを取得してください。
- TEバックエンドにログインし、サードパーティ統合に入り、AppsFlyer Master API プランを追加し、関連する設定を完了してください。
- TEシステムがデータを正常に受信し、レポートの構築が完了したかどうかを確認してください。
# API TokenとApp ID 取得
# 1.1 API Token取得
管理者アカウントにログインし、「API Access」をAppsFlyerのサイドバーメニューで見つけ、Pull APIのためのV2.0 API Tokenを取得してください。
# 1.2 App ID取得
AppsFlyerのバックエンド「My Apps」で、アプリのApp IDを見つけることができます。Androidではcom.から始まり、例えばcom.demoapp.taです。iOSではidから始まり、例えばid12345678です。
# プラン構成
AppsFlyerのAPI TokenとApp IDを取得した後、TEシステムにログインして、「サードパーティ」モジュールで新しいプランの設定を完了することができます。以下はAppsFlyer Master APIの設定画面です。この章の内容に従ってプランを作成してください:
# 2.1 認証情報の設定
「認証情报」ボタンをクリックし、ポップアップ内にAPI TokenとApp IDを入力してください。
# 2.2 定期取得
「定期取得」モジュールで、TEシステムがAppsFlyer Master APIデータを定期的に取得するルールを設定できます。特定の時間帯に毎日一定期間のデータを取得することができます。取得したデータもデータ量に含まれるため、長い時間のデータを定期的に取得しないようお勧めします。
# 2.3 取得タイムゾーン
デフォルトでは、UTC+0が設定されている場合でも、取得するデータのタイムゾーンを設定できます。
# 2.4 格納設定
データがイベントの形式で書き込まれるかどうかを制御することができます。閉じると、データはイベントテーブルに書き込まれないため、この設定を閉じないでください。
# 2.5 統合構成
最後に、データの取得の詳細な設定を統合構成モジュールで制御することができます。データのタイプ、取得する次元、および格納後のイベント名などが含まれます。
統合設定の内容はJSON形式であり、以下の内容に従ってカスタム設定を行うことができます。
API | 名称 | 意味 |
---|---|---|
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にはさまざまなタイプの指標が含まれており、AppsFlyer公式ウェブサイト (opens new window)のドキュメントを参照してください。
WARNING
一部の指標は異なるディメンションのフィールドをサポートしています。調整が必要な場合は、TEスタッフに連絡して操作を行ってください。
もし調整が必要な場合は、source.metricsを変更してください。
# 2.6 データ格納ルール
デフォルトでは、取得したデータはイベント形式で TE プロジェクトに書き込まれます。
- Master API の集計指標インターフェースは、集計データを返すため、ユーザー識別子として固定値を使用します。すべてのデータが仮想ユーザーにマウントされると考えてください。
- データ内の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 | APP 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 | 収益 |