# AppsFlyer Pull API

WARNING

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

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

AppsFlyer Pull API (opens new window)は、さまざまなタイプの集計指標データを提供しており、現在TEではPartnersとGeoのデータを取得することができます。

管理者アカウントにログインし、「API Access」をAppsFlyerのサイドバーメニューで見つけ、Pull APIのためのV2.0 API Tokenを取得してください。

AppsFlyerのバックエンド「My Apps」で、アプリのApp IDを見つけることができます。Androidではcom.から始まり、例えばcom.demoapp.taです。iOSではidから始まり、例えばid12345678です。

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

「認証情报」ボタンをクリックし、ポップアップ内にAPI TokenとApp IDを入力してください。

「定期取得」モジュールで、TEシステムがAppsFlyer Pull APIデータを定期的に取得するルールを設定できます。特定の時間帯に毎日一定期間のデータを取得することができます。取得したデータもデータ量に含まれるため、長い時間のデータを定期的に取得しないようお勧めします。

データがイベントの形式で書き込まれるかどうかを制御することができます。閉じると、データはイベントテーブルに書き込まれないため、この設定を閉じないでください。

最後に、データの取得の詳細な設定を統合構成モジュールで制御することができます。データのタイプ、取得する次元、およびストレージ後のイベント名などが含まれます。

統合設定の内容はJSON形式であり、以下の内容に従ってカスタム設定を行うことができます。

API	名称	意味
sink_event	event_mapping	格納後のイベントはカスタムが可能
source	report_types	取得するデータのタイプは、カスタマイズ可能であり、デフォルトでは installs、ad_revenue
extra_params	double_columns	数値タイプのフィールド定義は、ここに書かれたフィールドは数値タイプでデータベースに保存されます。保存後のフィールド名を入力してください。
	media_source	デフォルトでは設定する必要はありませんが、Facebookのデータを個別に取得する場合には設定が必要です。その際には「facebook」と入力してください。

Partner (opens new window)タイプのデータについて説明します。このレポートはLTVデータに基づいており、指定された期間内にインストールされた新規ユーザーの後続データを取得しています。

フィールド意味	フィールド名	備考
データタイム	#event_time
代理	agency_pmd_af_prt
メディアソース	media_source_pid
キャンペーン名	campaign_c
ARPU	arpu	指標フィールド、数値タイプで書き込んでください。extra_params.double_columns
平均 eCPI	average_ecpi
クリック数	clicks
コンバージョン率	conversion_rate
CTR	ctr
Impressions	impressions
Installs	installs
Loyal Users	loyal_users
Loyal Users/Installs	loyal_users_installs
ROI	roi
Sessions	sessions
Total Cost	total_cost
Total revenue	total_revenue

Facebookのデータ形式は他のメディアチャネルと異なるため、Facebookのデータだけを取得する場合は、extra_paramsに"media_source":"facebook"という設定を追加できます。この場合、以下のフィールドが追加されます。

このセクションでは、 Geo (opens new window)タイプのデータについて説明します。このレポートはLTVデータに基づいており、指定された期間内にインストールされた新規ユーザーの後続データを取得しています。

Facebookのデータ形式が他のメディアチャネルと異なるため、TEシステムはFacebookデータとすべてのプラットフォームデータを別々に取得します。以下はGeoが取得できるフィールドです：

フィールド	格納名	備考
国家地域	country
データタイム	#event_time
代理	agency_pmd_af_prt
メディアソース	media_source_pid
キャンペーン名	campaign_c
ARPU	arpu	指標フィールド、数値タイプで書き込んでください。extra_params.double_columns
リクック数	clicks
コンバージョン率	conversion_rate
インストール数	installs
ロイヤルユーザー数	loyal_users
Sessions 数	sessions
総収益	total_revenue

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

Pull APIの集計指標インターフェースは、集計データを返すため、ユーザー識別子として固定値を使用します。すべてのデータが仮想ユーザーにマウントされると考えてください。
データの中のDateフィールド、つまりユーザーの登録時間をイベントの#event_timeとして使用します。
データイベント名：
- Partner
  - appsflyer_partner_data
- Geo
  - appsflyer_geo_data
他のフィールドはすべてデータベースに保存されます。

メタフィールド	標準化フィールド	説明
media_source	te_ads_object.media_source	メディアチャネル
monetization_network（マネタイズ）	te_ads_object.media_source	マネタイズチャネル
campaign	te_ads_object.campaign_name	広告キャンペーン名
af_c_id	te_ads_object.campaign_id	広告キャンペーンID
af_adset	te_ads_object.ad_group_name	広告グループ名
ad_unit（マネタイズ）	te_ads_object.ad_group_name	マネタイズ広告のUnit名
af_adset_id	te_ads_object.ad_group_id	広告グループ ID
af_ad	te_ads_object.ad_name	広告名
af_ad_id	te_ads_object.ad_id	広告 ID
placement（マネタイズ）	te_ads_object.placement	広告位置
af_cost_value	te_ads_object.cost	コスト
af_cost_currency	te_ads_object.currency	コスト通貨
event_revenue	te_ads_object.revenue	収益
event_revenue_currency（マネタイズ）	te_ads_object.currency	収益通貨
country_code	te_ads_object.country	国家地域コード
platform	te_ads_object.platform	プラットフォーム Android、iOS など
app_id	te_ads_object.app_id	APP ID
app_name	te_ads_object.app_name	APP 名