menu
Is this helpful?

# AppsFlyer Master API

WARNING

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

# 概要

API 統合タイプ データ粒度 アトリビューション コスト 収益 露出 クリック コンバージョン
Master API API 集計

Master API (opens new window) は、カスタム分析次元および集計指標をサポートしており、Pull APIの集計指標インターフェースと比較して柔軟性が高いです。

# 統合プロセス

  1. AppsFlyerのバックエンドにログインし、V2.0 API TokenとApp IDを取得してください。
  2. TEバックエンドにログインし、サードパーティ統合に入り、AppsFlyer Master API プランを追加し、関連する設定を完了してください。
  3. 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 収益