メインコンテンツまでスキップ

AppsFlyerデータ統合ソリューション

最終更新 2026/10/05

最終更新日：2023-04-04

1. 統合プランの紹介​

ヒント

サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください

概要​

本記事では、AppsFlyerのデータをAgentic Engine（以下、AEシステム）にコールバックする方法を説明します。本プランはAppsFlyerの複数のデータ統合方法に対応しています。以下の表は、各データ統合方法の特性とデータタイプを示しています。タイトルをクリックすると、プランの該当する章に移動できます：

インターフェースデータ粒度APIタイプ製品化データ更新頻度リクエスト回数の制限

Push APIユーザーデータ

ユーザーレベル

プッシュ型

はい

リアルタイム

無制限

Pull APIユーザーレベルデータインターフェース

ユーザーレベル

プル型

いいえ

リアルタイム

  • 1回のリクエストあたり最大1M行
  • APPごとに1日最大24回のリクエスト
  • アカウントごとに1日最大120回のリクエスト

Pull API集計データ

集計データ

プル型

いいえ

リアルタイム

  • 1分あたり最大1回のリクエスト
  • 取得の時間範囲が0-2日以内：無制限
  • 取得の時間範囲が3日以上：
    • APPごとに1日最大24回のリクエスト
    • アカウントごとに1日最大120回のリクエスト

Master API

集計データプル型

いいえ

日単位

  • 1回のリクエストの行数は無制限
  • 1日のリクエスト回数は無制限

Cohort API

集計データプル型いいえ日単位

無制限

Data Lockerユーザーレベル / 集計データプル型-日単位/時間単位転送先クラウドストレージの制限に準拠
警告

一部のプラットフォームでは、アトリビューション情報、収益データ、コストデータなど、ユーザーレベルデータの一部のフィールドのコールバックが制限されますのでご注意ください

ヒント

一部のインターフェースはAppsFlyerの有料機能です。使用する前に、AppsFlyerの担当アカウントマネージャーにインターフェースの使用権限をご確認ください。

2. Push APIユーザーレベルデータインターフェース（製品化済み）​

インターフェースの基本情報

インターフェース名APIタイプ製品化データ粒度アトリビューションデータコストデータ収益データインプレッションクリックコンバージョン
Push APIプッシュ型はいユーザーレベルはいはいはいはいはい

Push APIでは、インプレッション、クリック、アクティベーション、収益データなど、AppsFlyerのユーザーレベルのデータをリアルタイムに取得できます。コストデータは、AFプラットフォームのデータ制限により取得できない場合があります。

ヒント

Push APIの統合はAEシステムの管理画面ですでに製品化されているため、関連する製品ドキュメントを参考に、画面上で統合設定を行うことをお勧めします。

Push APIのユーザーレベルデータを統合する前に、AEシステムのユーザー識別ルールを読み、AEシステムが#distinct_idと#account_idによってユーザーを識別する仕組みを理解しておいてください。AppsFlyer Push APIインターフェースのデータ統合の流れは下図のとおりです：

元の画像を見る

2.1 クライアントSDKの設定​

Push APIのユーザーレベルデータをAEプロジェクトのユーザーデータと連携させるには、AppsFlyer SDKでAEプロジェクトのアカウントIDとゲストIDを送信する必要があります。以下はクライアントSDKの設定方法です。

方法1（自動統合）：

ヒント

統合しているAE SDKのバージョンが2.8.0~2.8.1の場合は、このプランをそのまま使用できます

統合しているAE SDKのバージョンが2.8.2以上の場合は、サードパーティデータプラグインもインストールする必要があります

この方法は自動統合の方法です。AEクライアントSDKを初期化した後、次のコードを呼び出して有効にしてください。詳しくはAndroid SDKのサードパーティデータとiOS SDKのサードパーティデータを参照してください

// AE SDKを初期化
ThinkingAnalyticsSDK instance = ThinkingAnalyticsSDK.sharedInstance(this, TA_APP_ID, TA_SERVER_URL);

// AE SDKのAppsFlyer ID関連付け機能を有効化
instance.enableThirdPartySharing(TDThirdPartyShareType.TD_APPS_FLYER);

// setCustomerUserId()でゲストIDをもう一度設定することを強くお勧めします
String distinctId = instance.getDistinctId();
AppsFlyerLib.getInstance().setCustomerUserId(distinctId);

// AppsFlyer SDKを初期化
AppsFlyerLib.getInstance().init("appid", null, this);
AppsFlyerLib.getInstance().start(this);

// AE SDKのloginでアカウントIDを設定した後、再度AF SDKにデータを同期する必要があります
instance.login("account_id");
instance.enableThirdPartySharing(TDThirdPartyShareType.TD_APPS_FLYER);

AE SDKのlogin()メソッドまたはidentify()メソッドを呼び出した場合は、再度enableThirdPartySharing()を呼び出してデータを同期する必要があります。

注意：AppsFlyer SDKのsetAdditionalData()メソッドも呼び出す必要がある場合、このメソッドは複数回呼び出すと以前のパラメータが上書きされるため、パラメータをAE SDKに渡すことができます。AE SDKが内部でパラメータを連結・マージします。

Map<String, Object> additionalData = new HashMap<>();
additionalData.put("af_test_key1", "test1");
additionalData.put("af_test_key2", "test2");
instance.enableThirdPartySharing(
    TDThirdPartyShareType.TD_APPS_FLYER,
    additionalData
);

このプランの仕組みは、内部でAppsFlyerのsetAdditionalData()メソッドを自動的に呼び出し、AEプロジェクトのゲストIDとアカウントIDを渡すというものです。

方法2（手動統合）：

手動統合の方法では、AppsFlyer SDKでsetAdditionalDataを使用してAEプロジェクトのゲストIDとアカウントIDを設定する必要があります。以下はJavaのコード例です：

// AE SDKを初期化
ThinkingAnalyticsSDK instance = ThinkingAnalyticsSDK.sharedInstance(this, TA_APP_ID, TA_SERVER_URL);

// AEのゲストIDを取得（AEの#distinct_idに対応）
String distinctId = instance.getDistinctId();

// setAdditionalData()でゲストIDをAF SDKに設定
HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("ta_distinct_id",distinctId);
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

// setCustomerUserId()でゲストIDをもう一度設定することを強くお勧めします
AppsFlyerLib.getInstance().setCustomerUserId(distinctId);

// AppsFlyer SDKを初期化
AppsFlyerLib.getInstance().init("appid", null, this);
AppsFlyerLib.getInstance().start(this);
...

// AE SDKのloginでアカウントIDを設定した後、再度AF SDKにデータを同期する必要があります
String accountId = "your_account_id";
instance.login(accountId);
HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("ta_distinct_id", distinctId);
CustomDataMap.put("ta_account_id",accountId);
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

以上の設定を行うと、コールバックデータ内のcustom_dataにta_distinct_id、ta_account_idの2つのフィールドが含まれ、customer_user_idはゲストIDと等しくなります。

注意：製品化された設定方法でAppsFlyer Push APIのデータを統合する場合は、関連フィールドに次のように入力する必要があります：

  • アカウントIDの関連フィールド：custom_data.ta_account_id
  • ゲストIDの関連フィールド：customer_user_id,custom_data.ta_distinct_id

2.2 コールバックアドレスの設定​

次に、管理者アカウントでAppsFlyerの管理画面にログインし、「Integration」-「API Access」でPush APIのセクションを見つけて、以下の方法でコールバックURLを設定してください：

  • コールバックAPIバージョン（Push API Version)

    • 2.0を選択してください

  • HTTPリクエストメソッド（HTTP method)

    • AEシステムはPOSTとGETの両方のコールバック方式に対応しています。POST方式を選択することをお勧めします

  • ターミナルアドレス（Endpoint URL）

    • ThinkingAIの担当者が、データ受信用のターミナルアドレスを提供します

  • イベントメッセージのタイプ (Event Messages)

    • 少なくともアクティベーション (Install) とアクティベーションのアプリ内イベント (Install in-app events) を選択する必要があります。その他にコールバックが必要なイベントデータがある場合は、必要に応じてチェックを入れてください

  • コールバックフィールド (Message Fields)

    • メッセージフィールドには、少なくとも以下の情報を含める必要があります：

      • モバイルアトリビューション関連のフィールド：media_source、channel、af_adset、af_adなど
      • ユーザー識別ID関連のフィールド：custom_data、customer_user_id、event_valueなど
      • イベントプロパティまたはユーザープロパティとして使用するフィールド
      • イベント関連のフィールド：event_time_selected_timezone

  • コールバックするアプリ内イベント（In-app events）

    • 必要に応じてコールバックするイベントを選択します（例：クライアントで送信したta_registrationイベント）
警告

Facebookのデータが必要な場合は、AF管理画面のFacebookチャネル設定で、Facebookのデータ利用規約（Terms of Service）に同意する必要があります。同意しない場合、Facebookのユーザーレベルデータを取得できませんのでご注意ください。

2.3 データの格納​

2.3.1 ユーザー識別ルール​

前述のクライアントSDKで設定したユーザー識別フィールドのロジックに基づいて、対応するユーザー識別ルールを決める必要があります。これにより、Push APIでコールバックされたユーザー粒度のデータを、AEプロジェクト内の対応するユーザーに関連付けることができます。

デフォルトでは、コールバックデータ内で次のルールに従ってユーザー識別フィールドを探します：

  • Step 1: custom_dataフィールドにta_account_id / ta_distinct_idが含まれているかを確認します。つまりsetAdditionalData()で設定したフィールドです
  • Step 2: event_valueフィールドにta_account_id / ta_distinct_idが含まれているかを確認します。つまりAppsFlyerのカスタムイベントで設定したフィールドです
  • Step 3: イベントがInstallイベント（event_name: install）の場合は、customer_user_idフィールドを確認し、値があればcustomer_user_idを#distinct_idとして使用します。つまりsetCustomerUserId()で設定したフィールドです

各ステップで有効なIDをいずれか1つでも取得できた場合は、以降のステップの確認を停止します。3つのステップをすべて確認しても有効なユーザーIDを取得できない場合、デフォルトでは、そのデータは無効なデータとみなされ、そのまま破棄されます。これらのデータを保持したい場合は、ThinkingAIの担当者に連絡して設定してください。これらのデータはイベントテーブルに記録され、ゲストIDは固定値 -- "without_id"になります。また、これらのデータはその後のユーザープロパティの格納の対象になりません

設定したユーザー識別フィールドが上記と異なる場合は、データ統合設定情報テンプレートに記録してください。

2.3.2 データの格納ルール​

デフォルトでは、コールバックされたデータはイベントデータとして書き込まれません。イベントデータとして書き込む必要がある場合は、受信したすべてのイベントがイベントデータとして書き込まれます。イベントデータの格納ルールは次のとおりです：

  • ユーザー識別ルールに基づいて、イベントデータを対応するAEユーザーに紐付けます
  • データ内のevent_time_selected_timezoneフィールドから時刻とタイムゾーンの情報を取得し、時刻を#event_time、タイムゾーンを#zone_offsetとして書き込みます。このフィールドが空の場合は、event_timeを#event_timeとして使用し、タイムゾーン#zone_offsetは0に設定されます
  • データのイベント名は、そのイベントのAppsFlyerでのイベント名です
  • その他のフィールドはすべて格納されます

2.3.3 ユーザープロパティの格納設定​

デフォルトでは、データから次の4つのフィールドの値を読み取り、ユーザープロパティとして設定します：

AppsFlyerのフィールドAE標準化フィールド説明
media_sourcete_ads_object.media_sourceチャネル
campaignte_ads_object.campaign_nameキャンペーン
af_adsette_ads_object.ad_group_name広告グループ
af_adte_ads_object.ad_name広告

このほか、格納するユーザープロパティをカスタマイズすることもできます。これにはユーザープロパティの格納ルール（user_setとuser_setOnceのどちらを使用するか）も含まれます。ユーザープロパティをカスタマイズする必要がある場合は、データ統合設定情報テンプレートに記録してください。

2.4 データ統合設定情報テンプレート​

以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：

インターフェース：AppsFlyer Push API
--------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
ユーザー識別ルール：XXXをゲストID/アカウントIDとして使用（未入力の場合はデフォルト）
イベントとして格納するか：いいえ/はい
ユーザー識別IDを取得できなかったデータを保持するか：いいえ/はい（イベントとして格納する場合のみ有効）
格納するユーザープロパティ：XXX，XXX（未入力の場合はデフォルト）

3. Pull APIユーザーレベルデータ​

インターフェースの基本情報

インターフェース名APIタイプ製品化データ粒度アトリビューションデータコストデータ収益データインプレッションクリックコンバージョン
Pull API Raw Dataプル型いいえユーザーレベルはいはいはいはい

Pull API Raw Dataはプル型のユーザーレベルデータインターフェースで、ユーザー粒度の履歴データの取得に非常に適しています。

3.1 統合前の準備​

3.1.1 API Tokenの取得​

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

3.1.2 App IDの取得​

AppsFlyer管理画面の「My Apps」で、アプリのApp IDを確認できます。Androidではcom.で始まり（例：com.demoapp.ta）、iOSではidで始まります（例：id12345678）

3.1.3 クライアントSDKの設定​

Pull APIのユーザーレベルデータをAEプロジェクトのユーザーデータと連携させるには、AppsFlyer SDKでAEプロジェクトのアカウントIDとゲストIDを送信する必要があります。以下はクライアントSDKの設定方法です。

方法1（自動統合）：

ヒント

統合しているAE SDKのバージョンが2.8.0~2.8.1の場合は、このプランをそのまま使用できます

統合しているAE SDKのバージョンが2.8.2以上の場合は、サードパーティデータプラグインもインストールする必要があります

この方法は自動統合の方法です。AEクライアントSDKを初期化した後、次のコードを呼び出して有効にしてください。詳しくはAndroid SDKのサードパーティデータとiOS SDKのサードパーティデータを参照してください

// AE SDKを初期化
ThinkingAnalyticsSDK instance = ThinkingAnalyticsSDK.sharedInstance(this, TA_APP_ID, TA_SERVER_URL);
// AppsFlyer IDの関連付けを有効化
instance.enableThirdPartySharing(TDThirdPartyShareType.TD_APPS_FLYER);

// AppsFlyer SDKを初期化
AppsFlyerLib.getInstance().init("appid", null, this);
AppsFlyerLib.getInstance().start(this);

// setCustomerUserId()でゲストIDをもう一度設定することを強くお勧めします
String distinctId = instance.getDistinctId();
AppsFlyerLib.getInstance().setCustomerUserId(distinctId);

// loginでアカウントIDを設定した後、再度データを同期する必要があります（任意）
instance.login("account_id");
instance.enableThirdPartySharing(TDThirdPartyShareType.TD_APPS_FLYER);

AE SDKのlogin()メソッドまたはidentify()メソッドを呼び出した場合は、再度enableThirdPartySharing()を呼び出してデータを同期する必要があります。

注意：AppsFlyer SDKのsetAdditionalData()メソッドも呼び出す必要がある場合、このメソッドは複数回呼び出すと以前のパラメータが上書きされるため、パラメータをAE SDKに渡すことができます。AE SDKが内部でパラメータを連結・マージします。

Map<String, Object> additionalData = new HashMap<>();
additionalData.put("af_test_key1", "test1");
additionalData.put("af_test_key2", "test2");
instance.enableThirdPartySharing(
    TDThirdPartyShareType.TD_APPS_FLYER,
    additionalData
);

このプランの仕組みは、内部でAppsFlyerのsetAdditionalData()メソッドを自動的に呼び出し、AEプロジェクトのゲストIDとアカウントIDを渡すというものです。

方法2（手動統合）：

手動統合の方法では、AppsFlyer SDKでsetAdditionalDataを使用してAEプロジェクトのゲストIDとアカウントIDを設定する必要があります。以下はJavaのコード例です：

// AE SDKを初期化
ThinkingAnalyticsSDK instance = ThinkingAnalyticsSDK.sharedInstance(this, TA_APP_ID, TA_SERVER_URL);

// AEのゲストIDを取得（AEの#distinct_idに対応）
String distinctId = instance.getDistinctId();
// お客様のアカウントID（またはキャラクターID）。AEの#account_idに対応
String accountId = "your_account_id";

// アクティベーション時に実装
HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("ta_distinct_id",distinctId);
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

// setCustomerUserId()でゲストIDをもう一度設定することを強くお勧めします
AppsFlyerLib.getInstance().setCustomerUserId(distinctId);
...

// 登録時に実装
HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("ta_distinct_id", distinctId);
CustomDataMap.put("ta_account_id",accountId);
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

以上の設定を行うと、コールバックデータ内のcustom_dataにta_distinct_id、ta_account_idの2つのフィールドが含まれ、customer_user_idはゲストIDと等しくなります。

3.2 対象フィールド​

デフォルトでは、Pull API Raw Dataは以下のデータの取得に対応しています：

フィールド画面表示名デフォルトで取得タイプ
Attributed Touch Typeアトリビューションタイプ（露出、クリック）はい
Attributed Touch Timeアトリビューション時刻はい時間
Install Timeアクティベーション時刻はい時間
Event Timeイベント時間はい時間
Event Nameイベント名はい
Event Valueイベント値はい
Event Revenueイベント収益はい数値
Event Revenue Currencyイベント収益の通貨タイプはい
Event Revenue USDイベント収益（USD）はい数値
Event Sourceイベントソースはい
Is Receipt Validated受信検証が有効かどうか
Partnerパートナーはい
Media Sourceメディアチャンネルはい
Channelサブチャンネルはい
Keywordsキーワードはい
Campaign広告キャンペーン名はい
Campaign ID広告キャンペーンIDはい
Adset広告グループ名はい
Adset ID広告グループIDはい
Ad広告クリエイティブ名はい
Ad ID広告クリエイティブIDはい
Ad Type広告タイプはい
Site IDサイトIDはい
Sub Site IDサブサイトIDはい
Sub Param [1-5]サブパラメータ [1-5]
Cost Modelコストモデル (CPC/CPI/CPM/Other)はい
Cost Valueコスト値はい数値
Cost Currencyコストの通貨タイプはい
Contributor [1-3] Partnerコントリビューター [1-3] パートナー
Contributor [1-3] Media Sourceコントリビューター [1-3] メディアチャンネル
Contributor [1-3] Campaignコントリビューター [1-3] 広告キャンペーン
Contributor [1-3] Touch Typeコントリビューター [1-3] アトリビューションタイプ
Contributor [1-3] Touch Timeコントリビューター [1-3] アトリビューション時刻時間
Region地域はい
Country Code国コードはい
State州/省はい
City都市はい
Postal Code郵便番号
DMADMAコード
IPIPアドレスはい
WIFIWi-Fiが有効かどうかはい
Operatorモバイルキャリアはい
Carrier携帯電話キャリアはい
Language言語はい
AppsFlyer IDAppsFlyer IDはい
Advertising IDAdvertising IDはい
IDFAIDFAはい
Android IDAndroid IDはい
Customer User IDCustomer User IDはい
IMEIIMEIはい
IDFVIDFVはい
Platformプラットフォームはい
Device Typeデバイスタイプはい
OS VersionOSはい
App Versionアプリバージョンはい
SDK VersionSDKバージョンはい
App IDApp IDはい
App Nameアプリ名はい
Bundle IDBundle IDはい
Is Retargetingリターゲティングかどうかはい
Retargeting Conversion Typeリターゲティングのコンバージョンタイプはい
Attribution LookbackアトリビューションLookback
Reengagement Windowリエンゲージメントウィンドウ
Is Primary Attributionプライマリアトリビューションかどうか
User Agentユーザーエージェント
HTTP ReferrerHTTP Referrer
Original URL元のURLはい

3.3 インターフェースのパラメータ​

  • 時間：

    • 日単位のデータを取得します（直近90日間のデータのみ取得できます）
    • デフォルトのデータのタイムゾーンはUTCです

3.4 データの格納ルール​

Pull APIユーザーレベルデータインターフェースでは複数の種類のデータが格納されます。各データの処理ルールは次のとおりです：

  • Installsデータ

    • user acquisition（UA）のみを含むInstallsデータとOrganic Installsデータを取得します
    • データはデフォルトでユーザープロパティとして書き込まれます
    • イベントとして書き込むこともできます。イベント名はaf_installです
    • ユーザー識別フィールドの設定に基づいてユーザー識別フィールドを決定します。ユーザー識別ルールが設定されていない場合は、デフォルトでデータ内のcustomer_user_idをゲストIDとして使用します。ユーザー識別フィールドを取得できなかった場合、そのデータは破棄されます。
    • すべてのフィールドが格納されます

  • Ad Revenue

    • Attributed ad revenue、Organic ad revenueを取得します。このうちAttributed ad revenueでは、user acquisition（UA）とretargetingの両方のデータを取得します
    • データはイベントとして書き込まれます。イベント名はaf_ad_revenue_rawです
    • データ内のEvent Time、つまりイベントの発生時刻を、イベントの#event_timeとして使用します
    • ユーザー識別フィールドの設定に基づいてユーザー識別フィールドを決定します。ユーザー識別ルールが設定されていない場合は、デフォルトでデータ内のcustomer_user_idをゲストIDとして使用します。ユーザー識別フィールドを取得できなかった場合、そのデータは破棄されます。
    • すべてのフィールドが格納されます

3.5 データ統合設定情報テンプレート​

以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：

インターフェース：AppsFlyer Pull API Raw Data
--------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
AppsFlyer API Token: xxxxxxxx
AppsFlyer App ID: xxxxxxxx
---------
ユーザー識別ルール：XXXをゲストID/アカウントIDとして使用（未入力の場合はデフォルト）
統合するデータ：Install、Ad Revenue
ユーザープロパティに書き込むInstallイベントのプロパティ：xxx，xxx（未入力の場合はデフォルト）

履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd（直近90日間のデータのみ取得できます）
定期取得：毎日X時に前日のデータを取得

4. Pull API集約指標インターフェース​

インターフェースの基本情報

インターフェース名APIタイプ製品化データ粒度アトリビューションデータコストデータ収益データインプレッションクリックコンバージョン
Pull API集約指標プル型いいえ集計データはいはいはいはいはい

AppsFlyer Pull API集約指標インターフェースは、さまざまな種類の集約指標データを提供しています。現在、AEシステムが対応しているデータタイプはPartners (by date)とGeo (by date)です。

4.1 統合前の準備​

4.1.1 API Tokenの取得​

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

4.1.2 App IDの取得​

AppsFlyer管理画面の「My Apps」で、アプリのApp IDを確認できます。Androidではcom.で始まり（例：com.demoapp.ta）、iOSではidで始まります（例：id12345678）

4.2 対象フィールド​

4.2.1 Partner (by date)データ​

本節ではPartner (by date)タイプのデータを紹介します。このレポートはLTVデータに基づいており、指定した期間内にインストールした新規ユーザーのその後のデータを取得します。

Facebookのデータ形式は他のメディアチャンネルの形式と異なるため、AEシステムはFacebookのみのデータと全プラットフォームのデータを個別に取得します。以下はPartner (by date)で取得できるフィールドです：

フィールド名格納名Facebookのみのデータ全プラットフォームのデータ
Date#event_time✓✓
Agency/PMD (af_prt)agency_pmd_af_prt✓✓
Media Source (pid)media_source_pid✓✓
Campaign

campaign_name（Facebook）

campaign_c（全プラットフォーム）

✓✓
Campaign IDcampaign_id

✓

Adgroup IDadgroup_id✓
Adgroup Nameadgroup_name✓
Adset IDadset_id✓
Adset Nameadset_name✓
ARPUarpu✓✓
Average eCPIaverage_ecpi✓✓
Clicksclicks✓✓
Conversion Rateconversion_rate✓✓
CTRctr✓✓
{your event name}(Unique users){your_event_name}_unique_users✓✓
{your event name} (Event counter){your_event_name}_event_counter✓✓
{your event name} (Sales in XXX){your_event_name}_sales_in_usd✓✓
Impressionsimpressions✓✓
Installsinstalls✓✓
Loyal Usersloyal_users✓✓
Loyal Users/Installsloyal_users_installs✓✓
ROIroi✓✓
Sessionssessions✓✓
Total Costtotal_cost✓✓
Total revenuetotal_revenue

✓

✓

4.2.2 Geo (by date)データ​

本節ではGeo (by date)タイプのデータを紹介します。このレポートはLTVデータに基づいており、指定した期間内にインストールした新規ユーザーのその後のデータを取得します。

Facebookのデータ形式は他のメディアチャンネルの形式と異なるため、AEシステムはFacebookのみのデータと全プラットフォームのデータを個別に取得します。以下はGeo (by date)で取得できるフィールドです：

フィールド名格納名Facebookのみのデータ全プラットフォームのデータ
Countrycountry✓✓
Date#event_time✓✓
Agency/PMD (af_prt)agency_pmd_af_prt✓✓
Media Source (pid)media_source_pid✓✓

Campaign

campaign_name（Facebook）

campaign_c（全プラットフォーム）

✓

✓
Campaign IDcampaign_id✓
Adgroupadgroup_id✓
Adgroup Nameadgroup_name✓
Adset IDadset_id✓
Adset Nameadset_name✓
ARPUarpu✓✓
Clicksclicks✓✓
Conversion Rateconversion_rate✓✓
{your event name}(Unique users){your_event_name}_unique_users✓✓
{your event name} (Event counter){your_event_name}_event_counter✓✓
{your event name} (Sales in XXX){your_event_name}_sales_in_usd✓✓
Installsinstalls✓✓
Loyal Usersloyal_users✓✓

Sessions

sessions✓✓

Total revenue

total_revenue

✓

✓

4.3 インターフェースのパラメータ​

  • 時間：

    • 日単位のデータを取得します
    • デフォルトのデータのタイムゾーンはUTCです

4.4 データの格納ルール​

デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：

  • Pull APIの集約指標インターフェースは集計データを返すため、ユーザー識別子として固定値を使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えてください

  • データ内のDateフィールド（ユーザーのインストール日）を、イベントの#event_timeとして使用します

  • データのイベント名は次のとおりです：

    • Partner (by date)

      • appsflyer_facebook_partner_by_date（Facebookのデータ）
      • appsflyer_partner_by_date（全プラットフォームのデータ）

    • Geo (by date)

      • appsflyer_facebook_geo_by_date（Facebookのデータ）
      • appsflyer_geo_by_date（全プラットフォームのデータ）

  • その他のフィールドはすべて格納されます

4.5 データ統合設定情報テンプレート​

以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：

インターフェース：AppsFlyer Pull API集計データインターフェース
--------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
AppsFlyer API Token: xxxxxxxx
AppsFlyer App ID: xxxxxxxx
---------
データ取得のタイムゾーン：XXX（デフォルトはUTC）
データ取得タイプ：Partner (by date)/Geo (by date)

履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd
定期取得：毎日X時に前日のデータを取得

5. Master API​

インターフェースの基本情報

インターフェース名APIタイプ製品化データ粒度アトリビューションデータコストデータ収益データインプレッションクリックコンバージョン
Master APIプル型いいえ集計データはいはいはいはい

Master APIは、分析ディメンションと集約指標のカスタマイズに対応しており、Pull APIの集約指標インターフェースと比べて柔軟性が高くなっています。

5.1 統合前の準備​

5.1.1 API Tokenの取得​

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

5.1.2 App IDの取得​

AppsFlyer管理画面の「My Apps」で、アプリのApp IDを確認できます。Androidではcom.で始まり（例：com.demoapp.ta）、iOSではidで始まります（例：id12345678）

5.2 対象フィールド​

Master APIにはさまざまな種類の指標が含まれており、よく使われる指標カテゴリにはLTV KPIs、Retention KPIs、Cohort KPIsがあります。Cohort KPIsが対応する分析ディメンションは他の指標カテゴリよりも限られているため、AEシステムはCohort KPIsを含むデータと含まないデータを個別に取得します。以下はこの2種類のデータに含まれるフィールドです：

  • 分析ディメンション
フィールド名af_groupings格納名Cohort KPIsを除くデータCohort KPIsを含むデータ
App IDapp_idapp_id✓✓
Media Sourcepidmedia_source✓✓
Agencyaf_prtpartner✓
Campaignccampaign✓✓
Adsetaf_adsetadset✓
Adaf_adad✓
Channelaf_channelchannel✓
Publisher IDaf_siteidpublisher_id_af_siteid✓✓
Keywordsaf_keywordskeywords
Is Primary Attributionis_primaryis_primary_attribution
Campaign IDaf_c_idcampaign_id
Adset IDaf_adset_idadset_id
Ad IDaf_ad_idad_id
Install Timeinstall_timeinstall_time✓✓
Touch Typeattributed_touch_typetouch_type✓
GEOgeogeo✓✓
  • 指標フィールド

以下はMaster APIのよく使われるフィールドの一部です。すべてのフィールドについては、AppsFlyer公式ドキュメントを参照してください：

ヒント

新しく追加する指標フィールドはCohort KPIsを除くデータに追加されます。追加が必要な場合は、データ統合設定情報テンプレートに明記してください

格納名説明Cohort KPIsを除くデータCohort KPIsを含むデータ
impressions露出数✓✓
clicksクリック数✓✓
installsインストール数✓✓
crコンバージョン率✓✓
sessionsSession数✓✓
loyal_usersロイヤルユーザーのインストール数✓✓
loyal_users_rateロイヤルユーザーの割合✓✓
cost総コスト✓✓
revenue総収益✓✓
roiROI✓✓
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_userN日目の累計収益と同じ（N = 1,2,3,4,5,6,7,15,30,40,50,60,70,80,90）✓

5.3 インターフェースのパラメータ​

  • 時間：

    • 日単位のデータを取得します
    • デフォルトのデータのタイムゾーンはUTCです

5.4 データの格納ルール​

デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：

  • Master APIの集約指標インターフェースは集計データを返すため、ユーザー識別子として固定値を使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えてください

  • データ内のinstall_timeフィールド（ユーザーのインストール時刻）を、イベントの#event_timeとして使用します

  • データのイベント名は次のとおりです：

    • Cohort KPIsを含むデータ
      • appsflyer_master_ltv_act_cohort_kpis
    • Cohort KPIsを除くデータ
      • appsflyer_master_ltv_act_retention_kpis

  • その他のフィールドはすべて格納されます

5.5 データ統合設定情報テンプレート​

以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：

データ取得インターフェース：AppsFlyer Master API集計データインターフェース
--------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
AppsFlyer API Token: xxxxxxxx
AppsFlyer App ID: xxxxxxxx
---------
データ取得のタイムゾーン：XXX（デフォルトはUTC）
追加指標：XXX, XXX（イベントに関連するactivity指標の場合は、指標データを取得するイベント名を指定できます。追加指標はCohort KPIsを除くデータ、つまりappsflyer_master_ltv_act_retention_kpisイベントに追加されます）

履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd
定期取得：毎日X時に前日のデータを取得

6. Cohort API​

インターフェースの基本情報

インターフェース名APIタイプ製品化データ粒度アトリビューションデータコストデータ収益データインプレッションクリックコンバージョン
Cohort APIプル型いいえ集計データはいはいはい

Cohort APIも集計データのAPIです。他の集計データAPIと比べると、データ指標の形はAppsFlyerのCohort DashboardやAEシステムのリテンション分析モデルの結果に近く、N日目（または累計N日目）の指標になります。

6.1 統合前の準備​

6.1.1 API Tokenの取得​

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

6.1.2 App IDの取得​

AppsFlyer管理画面の「My Apps」で、アプリのApp IDを確認できます。Androidではcom.で始まり（例：com.demoapp.ta）、iOSではidで始まります（例：id12345678）

6.2 対象フィールド​

  • 分析ディメンション

Cohort APIが対応している分析ディメンションは最大7つです。以下はデフォルトの分析ディメンションです。調整が必要な場合は、データ統合設定情報テンプレートに明記してください：

フィールド名格納名デフォルト
Adaf_ad✓
Ad IDaf_ad_id
Campaignc✓
Campaign IDaf_c_id
Channelaf_channel✓
Media Sourcepid✓
Sub Param 1af_sub1
Keywordsaf_keywords
Agencyaf_prt
Conversion Type (1)cohort_type
Site IDsite_id
Attributed Touch Type (3)attributed_touch_type
Adsetaf_adset✓
Adset IDaf_adset_id
Countrygeo
Datedate✓
警告

Facebook(Meta)のデータを取得する必要がある場合は、分析ディメンションでaf_channelとgeoを同時に選択しないでください。同時に選択すると、Facebookのコストデータを取得できなくなりますのでご注意ください

  • 指標フィールド

Cohort APIは、デフォルトの3種類の指標と1つの追加指標を返します。以下はデフォルトの指標フィールドです。調整が必要な場合は、データ統合設定情報テンプレートに明記してください：

指標タイプ格納名説明デフォルト
users（常に含まれる）usersコホートの総ユーザー数（時間枠とは無関係）✓
ecpi（常に含まれる）ecpiコホートの総eCPI（時間枠とは無関係）✓
cost（常に含まれる）costコホートの総コスト（時間枠とは無関係）✓

"event_name"（カスタムイベント）

"event_name"_unique_users_day_NN日目のカスタムイベントのトリガーユーザー数
"event_name"_count_day_NN日目のカスタムイベントの完了数
"event_name"_rate_day_NN日目のカスタムイベントの完了率
"event_name"_sum_day_NN日目にカスタムイベントによって発生した収益額

revenue

revenue_count_day_NN日目の収益イベントのトリガー数✓
revenue_sum_day_NN日目の収益額✓
ROASroas_rate_day_NN日目のROAS
roiroi_rate_day_NN日目のROI

sessions

sessions_unique_users_day_NN日目のSessionトリガーユーザー数（累計指標の場合、このデータは返されません）
sessions_count_day_NN日目のSession数
sessions_rate_day_NN日目の継続率（Sessionトリガーユーザー数 / コホートの総ユーザー数）
uninstallsuninstalls_count_day_NN日目のアンインストール数
uninstalls_rate_day_NN日目のアンインストール率

注：上表の格納名列のNはN日目の指標を表し、デフォルトの値の範囲は0-30です

6.3 インターフェースのパラメータ​

  • 時間：

    • 日単位のデータを取得します
    • デフォルトのデータのタイムゾーンはUTCです
    • データを日ごとの独立した値（つまり当日の指標を表示）にするか、累計データ（つまり0日目からN日目までの累計）にするかを選択できます
    • 完全でない日（たとえば計算対象のN日目が今日の場合）のデータをコールバックするかどうかを選択できます

6.4 データの格納ルール​

デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：

  • Cohort APIの集約指標インターフェースは集計データを返すため、ユーザー識別子として固定値を使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えてください
  • データ内のdateフィールド、つまりユーザーのアトリビューション/コンバージョン時間をイベントの#event_timeとして使用します
  • データのイベント名：appsflyer_cohort_api
  • その他のフィールドはすべて格納されます

6.5 データ統合設定情報テンプレート​

以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：

データ取得インターフェース：AppsFlyer Cohort API集計データインターフェース
--------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
AppsFlyer API Token: xxxxxxxx
AppsFlyer App ID: xxxxxxxx
---------
データ取得のタイムゾーン：XXX（デフォルトはUTC）
完全でない日のデータを許可するか：はい/いいえ（デフォルトは「はい」）
データの時間集計タイプ：当日/累計（デフォルトは累計）

グループ化ディメンション：XXX，XXX（デフォルト：date,pid,geo,c,af_adset,af_ad,af_channel）
指標フィールド：XXX（デフォルトはrevenue、1つのみ設定可能）

履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd
定期取得：毎日X時に直近N日間のデータを取得

7. Data LockerとCost ETL​

Data LockerはAppsFlyerのデータ転送サービスで、さまざまなデータをAWSまたはGCSのクラウドストレージに転送できます。

Cost ETLはAppsFlyerのコストデータ転送サービスで、各メディアチャネルの広告キャンペーンのコストデータをAWSまたはGCSのクラウドストレージに転送できます。

現在、AEシステムはAWS S3とGCSのデータの統合に対応しています。転送先のクラウドストレージの種類に応じて、次のドキュメントを参照してください：

8. 連携テストと統合後のデータ利用​

1. 連携テスト​

1.1 Push APIインターフェース

「データ管理」 ->「ユーザープロパティ管理」ページで、関連するアトリビューションデータを確認できます。関連するユーザープロパティがあれば、統合は成功しています。

AppsFlyerのコールバックフィールドAEに格納後のユーザープロパティ名データタイプ
media_source#appsflyer_media_sourceテキスト
campaign#appsflyer_campaignテキスト
af_adset#appsflyer_adsetテキスト
af_ad#appsflyer_adテキスト

イベントテーブルへの格納を有効にしている場合は、「データ管理」 ->「イベント管理」ページで関連するイベントデータを確認できます。イベント名はAppsFlyerで定義したイベント名と同じです。

1.2 Pull APIとMaster APIの集計データインターフェース

「データ管理」 ->「イベント管理」ページで、関連するイベントを確認できます。関連するイベントがあれば、統合は成功しています。

インターフェースレポート名AEに格納後のイベント名データタイプ
Pull API全メディアチャンネルの配信レポート-日別appsflyer_partner_by_dateテキスト
Pull APIFacebook配信レポート-日別appsflyer_facebook_partner_by_dateテキスト
Master APILTV, Activity, Retention関連のKPIsappsflyer_master_ltv_act_retention_kpisテキスト
Master APILTV, Activity, RetentionおよびCohort関連のKPIsappsflyer_master_ltv_act_retention_cohort_kpisテキスト

2. データ利用​

2.1 アトリビューション情報を軸にした分析

2.2 メディアごとに、チャネル、広告グループ、広告キャンペーン、広告クリエイティブのディメンションでアクティベーション、コスト、収益、ROASを計算して比較

2.3 1つのプラットフォームでマーケティングデータとユーザー行動データを同時に確認し、複数プラットフォームを行き来する手間を削減

2.4 データの連動分析（例：マネタイズや他のメディアチャンネルのデータとの連携）

2.5 revenue / costで各メディアチャンネルのROASを計算

2.6 非オーガニックユーザーの主要なユーザー行動（例：課金前の特定のイベント、特定のコアなゲームプレイのリテンション）からユーザーの質を分析し、分析から意思決定までの時間を短縮

2.7 イベントプロパティ統合後のデータタイプ

AppsFlyer Pull APIで取得したデータのイベントプロパティは、デフォルトで「文字列型として統合」されます。AEシステムの仮想プロパティ機能で文字列型のフィールドを他の型に変換できます。例：

  • installプロパティを数値型に変換："af_install_number"（データタイプは数値を選択）
  • total_costプロパティを数値型に変換："af_total_cost_number"（データタイプは数値を選択）

9. FAQ​

AppsFlyerのFAQを参照してください

このページは役に立ちましたか？
このページの内容