AppsFlyerとAmplitudeを連携すると、ユーザーのアトリビューションデータとイベント分析データを共有し、エンゲージメント、継続率、収益をより詳しく分析できます。用途や分析の目的に応じて、V1またはV2のいずれかの連携方式を選択してください。
連携の概要
AppsFlyerの連携済みパートナーであるAmplitudeは、プロダクト、グロース、マーケティングの各チームが、モバイルとWebにおけるユーザー行動を把握するためのプロダクト分析プラットフォームです。この連携により、AppsFlyerからインストール後の主要なイベントデータをAmplitudeに送信し、ユーザー単位で詳しく分析できます。
Amplitudeとの連携には、次の2つのバージョンがあります。
-
Amplitude V1:
AmplitudeのAttribution APIを使用します。 AppsFlyerは、連携の設定完了後に収集したインストールデータを送信します。 Amplitudeは広告IDを識別子として使用します。72時間以内に一致するユーザーイベントが記録されなければ、データは破棄されます。詳細を見る -
Amplitude V2:
AmplitudeのHTTP V2 APIを使用します。 AppsFlyerは、連携の設定完了後にインストールとアプリ内イベントの両方のデータを送信します。識別子(user_idとdevice_id)には優先順位があり、一致するユーザーが見つからない場合は新規ユーザーとして記録されます。詳細を見る
連携バージョンの比較:
| バージョン | 使用するAPI | 使用する識別子 | 対象イベント |
|---|---|---|---|
| V1 | Attribution API | 広告ID(AdID) | インストールのみ |
| V2 | HTTP V2 API |
user_id、device_id(優先する識別子が使えない場合は別の識別子を使用) |
インストールとアプリ内イベント |
重要
- Amplitude V1またはV2のいずれかを選択してください。両方を同時に使用しないでください。両方のバージョンを同時に使用すると、Amplitudeにイベントが重複して送信されることがあります。
- 一部のメディアソースでは、第三者とのデータ共有が制限されています。共有が制限されているイベントのポストバックは、設定済みでもこのパートナーには送信されません。
前提条件
設定を始める前に:
- Amplitudeのアカウントをお持ちでない場合は、Amplitudeに問い合わせて作成してください。
- AmplitudeのV1とV2のどちらを設定するか決めます。
- 重複を防ぐため、Amplitude SDKとAppsFlyerの両方から同じイベントを送信しないようにしてください。
- Amplitude V2連携の追加の前提条件も確認してください。
Amplitude V2連携の追加の前提条件
V2連携では、次の設定が必要です。
AmplitudeデバイスID
ユーザー単位のアトリビューションを有効にするには、Amplitude Device IDをAppsFlyer SDKに渡す必要があります。この値は、各ポストバックで送信されます。
Android
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeDeviceId", amplitude.getDeviceId())
言語: Java/Kotlin
ドキュメント: Android SDKリファレンス, Amplitude
iOS (Objective-C)
[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeDeviceId": [[Amplitude instance] getDeviceId]}];
言語: Objective-C
ドキュメント: iOS SDKリファレンス, Amplitude
iOS (Swift)
AppsFlyerLib.shared().customData = ["AmplitudeDeviceId": Amplitude.instance().getDeviceId()]
言語: Swift
ドキュメント: iOS SDKリファレンス, Amplitude
Unity
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeDeviceId", Amplitude.getInstance().getDeviceId());
AppsFlyer.setAdditionalData(customData);
言語: C#
ドキュメント: Unity SDKリファレンス
React Native
appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()},
(res) => {
//...
}
);
言語: JavaScript
ドキュメント: React Native SDKリファレンス
Cordova
appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()});
言語: JavaScript
ドキュメント: N/A
Flutter
var data = {"AmplitudeDeviceId": amplitude.getDeviceId()};
appsFlyerSdk.setAdditionalData(data);
言語: Dart
ドキュメント: Flutter SDKリファレンス
カスタマーユーザーID
カスタマーユーザーID(CUID)を設定します。通常、アプリの所有者がユーザー登録時に生成・設定する
一意の識別子です。詳細を見る
AmplitudeセッションID
AmplitudeのセッションIDを設定し、AppsFlyerに渡します。詳細を見る
Android
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeSessionId", amplitude.getSessionId())
言語: Java/Kotlin
ドキュメント: Android SDKリファレンス
iOS (Objective-C)
[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeSessionId": [[Amplitude instance] getSessionId]}];
言語: Objective-C
ドキュメント: iOS SDKリファレンス
iOS (Swift)
AppsFlyerLib.shared().customData = ["AmplitudeSessionId": Amplitude.instance().getSessionId()]
言語: Swift
ドキュメント: iOS SDKリファレンス
Unity
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeSessionId", Amplitude.getInstance().getSessionId());
AppsFlyer.setAdditionalData(customData);
言語: C#
ドキュメント: Unity SDKリファレンス
React Native
appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()},
(res) => {
//...
}
);
言語: JavaScript
ドキュメント: React Native SDKリファレンス
Cordova
appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()});
言語: JavaScript
ドキュメント: N/A
Flutter
var data = {"AmplitudeSessionId": amplitude.getSessionId()};
appsFlyerSdk.setAdditionalData(data);
言語: Dart
ドキュメント: Flutter SDKリファレンス
連携の設定
連携を設定するには、以下の手順を実施します。
- AppsFlyerで[連携]>[パートナー連携]>[マーケットプレイス]タブに移動します。
-
Amplitude V1連携を設定する場合は、Amplitude V1(テクノロジーパートナー)を選択します。
Amplitude V2連携を設定する場合は、Amplitude V2(テクノロジーパートナー)を選択します。
-
Amplitudeのバージョンを選択したら、[連携を設定]をクリックします。
-
[連携]タブで、次の設定を行います。
- 対象のアプリを選択します。
-
[パートナーを有効化]をオンにします。
- 残りのタブで設定を完了します。
連携タブ
[連携]タブは、以下のセクションで構成されています。
パートナーを有効化
初めて設定する場合は、[パートナーを有効化]をオンにすると、[連携]タブのパラメータを設定できます。このパートナーと連携している間は、オンにしておく必要があります。
詳しくは、パートナーの有効化を参照してください。
一般設定
拡張データ共有
追加のインストール情報をAmplitudeと共有するには、[拡張データ共有]をオンにします。オンにすると、インストールについて次のデータがAmplitudeに送信され、表に記載されたAmplitudeプロパティに対応付けられます。アプリ内イベントは対象外です。
| Amplitudeプロパティ | AppsFlyerのデータ項目 |
|---|---|
| sub_publisher | af_siteid |
| network_name | pid |
| adgroup_name | af_adset |
| creative_name | af_ad_id |
| installed_at | install_timestamp |
| search_term | af_keywords |
| channel | af_channel |
| user_id | af_customer_user_id |
| af_sub1 | af_sub1 |
| af_sub2 | af_sub2 |
| af_sub3 | af_sub3 |
| af_sub4 | af_sub4 |
| af_sub5 | af_sub5 |
| app_version | app_version |
AmplitudeのEUデータセンター
[Amplitude EU Data Center]がオフの場合、インストールポストバックは米国のデータセンターに送信されます。
AmplitudeのEUデータセンターにインストールポストバックを送信するには、[Amplitude EU Data Center]をオンにします。
APIキー
AmplitudeとAppsFlyerの接続には、固有のAPIキーを使用します。まだ取得していない場合は、連携の設定を進める前にAmplitudeから取得するか、以下の手順で取得してください。
AmplitudeからAPIキーを取得する
注意:APIキーにアクセスできるのは、AmplitudeでAdminまたはManagerのロールを持つユーザーのみです。
- Amplitudeアカウントにログインします。
-
ページ右上の設定アイコン>Organization Settingsをクリックします。
-
Projectsをクリックし、AppsFlyerにデータを送信するプロジェクトを選択します。
-
ProjectタブからAPIキーをコピーします。
- AppsFlyer管理画面でAmplitudeの設定に進みます。
デフォルトポストバック
AppsFlyerは、ユーザーのインストール後にAmplitudeへポストバックを自動送信できます。インストールとリエンゲージメント(リアトリビューションを含む)が対象です。リエンゲージメントとは、すでにアプリをインストールしているユーザーが、キャンペーンをクリックした後にアプリを開くことです。詳しくは、デフォルトポストバックを参照してください。
アプリ内イベントの設定
- APIキーを入力します。
-
[Amplitude Data Center]がオフの場合、アプリ内イベントのポストバックは米国のデータセンターに送信されます。
AmplitudeのEUデータセンターにアプリ内イベントのポストバックを送信するには、[Amplitude Data Center]をオンにします。
設定を保存すると、AppsFlyerからAmplitudeに次のデータが送信されます。
- デバイスID(IDFV/Google広告ID)
- メディアソース
- キャンペーン名
iOSデバイスのIDFAを送信できるかどうかは、ユーザーのATT同意と高度なプライバシー設定によって決まります。
アプリ内イベントポストバック
Amplitudeへのアプリ内イベントポストバックの送信を設定します。
計測リンクタブ
Amplitudeでは、計測リンクは利用できません。
コストタブ
このパートナーとの連携では、コストデータには対応していません。
広告収益タブ
このパートナーとの連携では、広告収益データには対応していません。
権限タブ
Amplitudeでは、権限の設定は利用できません。
Amplitudeコンソールでアトリビューションデータを確認する
AppsFlyerからAmplitudeに送信されたアトリビューションデータは、ダッシュボードに[AppsFlyer]で始まるイベントやプロパティとして表示されます。
重要
AppsFlyerから送信されたデータが、Amplitudeで「Blocked」と表示される場合があります。 AmplitudeでAppsFlyerのデータが表示されない場合は、ブロック対象のイベントに設定されていないか確認してください。
AmplitudeのイベントをAppsFlyerに送信する
この連携では、サーバー間APIを使用してAmplitudeのイベントをAppsFlyerに送信することもできます。手順については、Amplitudeのドキュメントを参照してください。