概要:GAIDを利用できないAndroidデバイスを、OAIDまたはIMEIを使用してアトリビューション計測する方法を説明します。 AppsFlyerでアトリビューションデータを確認する際の推奨方法も紹介します。
中国国内市場におけるAndroidアプリのアトリビューション
中国では、アプリの運営者が次のような課題に直面します。
- 大半のAndroidデバイスでGoogle Play開発者サービス(GPS)が有効になっていないため、GAIDを利用できません。
- サードパーティのAndroidアプリストアを利用することで、デバイスメーカーによるストアハイジャックが発生する余地が生まれます。
- アトリビューションサーバーにアクセスできない、または応答が遅い場合があります。
- Google PlayとサードパーティのAndroidアプリストアのアトリビューションデータを管理・確認する必要があります。
AppsFlyerでは、次の方法でこれらの課題に対応できます。
- OAIDに基づくアトリビューション計測の実装
- Androidバージョン28以前のデバイスで、GAIDの代わりにデバイスのIMEIを使用
- 固有の識別子を組み込んだAPKを用意し、Androidのストアハイジャックを検出
- 中国国内で利用できるアトリビューションリンクの設定
アプリの準備
アプリにSDKを実装し、対象デバイスのAndroidバージョンに応じた方法でAPKを準備します。
アプリへのSDKの実装
中国で提供されるAndroidデバイスには、通常、Google Play開発者サービスがインストールされていません。そのため、アトリビューション用の固有の識別子としてGAIDを使用できません。
GAIDの代わりに、利用可能なIMEIやOAIDを使用することで、アトリビューションを記録できます。
OAID:
- GAIDやIDFAと同様に、ユーザーがリセットできる広告IDです。
- AppsFlyer Android SDK V5.1.0以降が必要です。
- AppsFlyer SDK V5.4.0以降では、デフォルトでOAIDの自動収集を試みます。
- 複数のメーカーが、AppsFlyerとのOAIDによるアトリビューション計測の相互運用テストを完了しています。対象には、Huawei、Lenovo、OPRO、Vivo、Samsung、Xiaomiが含まれます。
IMEI:
- AppsFlyer SDKでは、設定を変更しない限りIMEIにアクセスしません。これは、通常はデバイスでGoogle Play開発者サービスが有効になっており、IMEIは不要であることを前提としているためです。中国では、この前提が当てはまりません。
- アプリにAppsFlyer SDKを実装する際に、IMEIへのアクセスを有効にする必要があります。
- Androidバージョンにかかわらずアトリビューション計測を行えるよう、必要に応じてOAIDとIMEIの両方を実装してください。
- これは、2019年後半にリリースされたAndroid 10(APIレベル29)以降、IMEIへのアクセスが制限されているためです。アプリからもAppsFlyer SDKからも、これらの識別子を収集することはできません。識別子を利用できない場合、AppsFlyerは確率論的モデリングによるアトリビューション計測を行います。
開始前の確認事項:
- AppsFlyer Android SDK V5.1.0以降が必要です。
次のいずれかの手順で設定します。
Android APIレベル29以降でのOAIDの収集
Android APIレベル23〜28でのIMEIの収集
IMEIを収集する方法は2つあります。
- setImeiData
- setCollectIMEI(true)
次のコード例を参考に、SDKを実装してください。このコード例では、onConversionDataSuccessメソッドを使用しています。これは、SDK V5.0以降でコンバージョンデータを取得するメソッドの名称です。 V5.0より前のSDKを使用している場合、メソッド名は onInstallConversionDataLoadedです。 SDKを最新バージョンにアップグレードすることを推奨します。
注意:Android APIレベル23以降では、IMEIにアクセスするために、確認画面を表示してユーザーの許可を得る必要があります。このため、StartTracking APIの実行後にIMEIが取得される場合があります。 APIレベル29以降では、IMEIへのアクセスが制限されます。
Public class AFApplication extends Application {
private static final String AF_DEV_KEY = "";
private static AFApplication instance;
@Override
public void onCreate() {
//If you want to show debug log.
AppsFlyerLib.getInstance().setDebugLog(true); //Developer collect the imei and android id, then send them to AppsFlyer SDK.
AppsFlyerLib.getInstance().setImeiData("customer imei");
AppsFlyerLib.getInstance().setAndroidIdData("customer android_id");
//Or use the two APIs below let AppsFlyer SDK collect IMEI & android id
//no matter if the Google Play Service exists or not.
AppsFlyerLib.getInstance().setCollectIMEI(true);
AppsFlyerLib.getInstance().setCollectAndroidID(true);
//Configure the min time between two sessions, the recommendation is 2 seconds。
AppsFlyerLib.getInstance().setMinTimeBetweenSessions(2);
final AppsFlyerConversionListener conversionDataListener = new
AppsFlyerConversionListener() {
@Override
public void onConversionDataSuccess(Map<String, Object=""> map) {}
@Override
public void onConversionDataFail(String error) {}
@Override
public void onAppOpenAttribution(Map<string, string=""> map) {}
@Override
public void onAttributionFailure(String s) {}
}
AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionDataListener);
AppsFlyerLib.getInstance().startTracking(context, AF_DEV_KEY);
}
@Override
protected void attachBaseContext(Context base) {
instance = this;
super.attachBaseContext(base);
}
public static synchronized AFApplication getAppInstance() {
return instance;
}
}
アプリの初回起動時に、MainActivityのonResume()コールバックで、READ_PHONE_STATE権限のリクエストがユーザーに送信されます。
アプリモジュールのbuild.gradle
allprojects {
repositories {
....
maven { url 'https://jitpack.io'}
}
}
dependencies {
implementation 'com.github.tbruyelle:rxpermissions:0.10.2'
}
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
startIMEILogic();
}
private void startIMEILogic() {
SharedPreferences permissions_flags = getSharedPreferences("appsflyer-data", MODE_PRIVATE);
if (!permissions_flags.contains(Manifest.permission.READ_PHONE_STATE)) {
requestIMEIPermissions();
}
}
private void requestIMEIPermissions() {
if (ContextCompat.checkSelfPermission(this,
Manifest.permission.READ_PHONE_STATE)
!= PackageManager.PERMISSION_GRANTED) {
ActivityCompat.requestPermissions(this,
new String[]{Manifest.permission.READ_PHONE_STATE},
MY_PERMISSIONS_REQUEST_READ_PHONE_STATE);
} else {
//Permission was already granted
SharedPreferences.Editor permissionsFlagsEditor = getSharedPreferences("appsflyer-data", MODE_PRIVATE).edit();
permissionsFlagsEditor.putBoolean(Manifest.permission.READ_PHONE_STATE, true);
permissionsFlagsEditor.apply();
}
}
@Override
public void onRequestPermissionsResult(int requestCode,
String[] permissions, int[] grantResults) {
if (requestCode == MY_PERMISSIONS_REQUEST_READ_PHONE_STATE) {
SharedPreferences.Editor permissionsFlagsEditor = getSharedPreferences("appsflyer-data", MODE_PRIVATE).edit();
boolean granted;
// If request is cancelled, the result arrays are empty.
if (grantResults.length > 0
&& grantResults[0] == PackageManager.PERMISSION_GRANTED) {
// permission was granted!
granted = true;
AppsFlyerLib.getInstance().setCollectIMEI(true);
} else {
// permission denied!
granted = false;
}
AppsFlyerLib.getInstance().setMinTimeBetweenSessions(0);
AppsFlyerLib.getInstance().reportTrackSession(this);
AppsFlyerLib.getInstance().setMinTimeBetweenSessions(5);
permissionsFlagsEditor.putBoolean(Manifest.permission.READ_PHONE_STATE, granted);
permissionsFlagsEditor.apply();
}
}
}
public class MainActivity extends AppCompactActivity {
@Override
protected void onResume() {
super.onResume();
final RxPermissions rxPermissions = new RxPermissions(this);
if(RxPreference.Instance().getBoolean(RxPreference.KEY_PERMISSION_DIALOG_HAS_SHOW, false){
return;
}
if(rxPermissions.isGranted(Manifest.permission.READ_PHONE_STATE)) {
return;
}
RxPreference.Instance().putBoolean(RxPreference.KEY_PERMISSION_DIALOG_HAS_SHOW, true);
rxPermissions.request(Manifest.permission.READ_PHONE_STATE)
.subscribe(granted -> {
if (granted) {
AppsFlyerLib.getInstance().setImeiData("customer imei");
AppsFlyerLib.getInstance().setAndroidIdData("customer android_id");
//or
AppsFlyerLib.getInstance().setCollectIMEI(true);
AppsFlyerLib.getInstance().setCollectAndroidID(true);
//NOTE: Here the report session API is reportTrackSession() not the startTracking()
AppsFlyerLib.getInstance().reportTrackSession(AFApplication.getAppInstance());
} else {
}
});
}
}
IMEIを収集する方法は2つあります。
- setImeiData
- setCollectIMEI(true)
次のコード例を参考に、SDKを実装してください。注意:このコード例では、コンバージョンデータの取得にonConversionDataSuccessメソッドを使用しています。これは、SDK V5以降でのメソッド名です。 5.0.0より前のSDKを使用している場合、メソッド名は onInstallConversionDataLoadedです。 SDK 5.0.0へのアップグレードを推奨します。詳しくは、こちらを参照してください。
public class AFApplication extends Application {
private static final String AF_DEV_KEY = "";
private static AFApplication instance;
@Override
public void onCreate() {
//If you want to show debug log.
AppsFlyerLib.getInstance().setDebugLog(true);
//Developer collect the imei and android id, then send them to AppsFlyer SDK.
AppsFlyerLib.getInstance().setImeiData("customer imei");
AppsFlyerLib.getInstance().setAndroidIdData("customer android_id");
//Or use the two APIs below to let AppsFlyer SDK collect IMEI & android id no matter the
//Google Play Service is exist or not.
AppsFlyerLib.getInstance().setCollectIMEI(true);
AppsFlyerLib.getInstance().setCollectAndroidID(true);
final AppsFlyerConversionListener conversionDataListener = new AppsFlyerConversionListener() {
@Override
public void onConversionDataSuccess(Map<String, Object=""> map) {}
@Override
public void onConversionDataFail(String error) {}
@Override
public void onAppOpenAttribution(Map<string, string=""> map) {}
@Override
public void onAttributionFailure(String s) {}
};
AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionDataListener);
AppsFlyerLib.getInstance().startTracking(context, AF_DEV_KEY);
}
@Override
protected void attachBaseContext(Context base) {
instance = this;
super.attachBaseContext(base);
}
public static synchronized AFApplication getAppInstance() {
return instance;
}
}
APKの準備
AppsFlyerでのアトリビューションデータの表示方法を、次の中から選択します。
- (推奨)1つのアプリに集約:中国国内のすべてのサードパーティAndroidアプリストアのデータを、専用の1つのアプリにまとめて表示します。 AppsFlyer上の1つのアプリで、中国国内のすべてのストアのアトリビューションデータを確認できます。この方法を使用する場合は、後述のAppsFlyerへのアプリの追加に進んでください。
- Google Playのデータも1つのアプリに集約:サードパーティのアプリストアとGoogle Playのアトリビューションデータをまとめて表示します。この方法では、Google Playとサードパーティのストアで、同じパッケージ名を使用する必要があります。 AppsFlyerにアプリがすでに登録されていることを前提としています。この方法を使用する場合は、後述のAPK / マニフェストの準備に進んでください。
- 複数のアプリに分けて表示:各ストアのアトリビューションデータを、別々のアプリで表示します。たとえば、Google Play、サードパーティストアA、サードパーティストアBなどのデータを個別に表示します。この方法については、複数のアプリを使用する方法を参照してください。
AppsFlyerへのアプリの追加
AppsFlyerにアプリを追加するには:
- AppsFlyerで[マイアプリ]をクリックします。
- [アプリを追加]をクリックします。
アプリの追加画面が開きます。 - [Google Play以外で配信するAndroid APK]を選択します。
- 次の項目を入力します。
- Androidパッケージ名:任意のテキストを入力します。
- チャネル名:後述のマニフェストに設定するチャネル名と同じ値を入力します。この項目にはcn_marketを設定することを推奨します。
- アプリURL
注意:[承認待ちまたは未公開]を選択してアプリを作成することもできますが、推奨しません。この方法を使用する場合は、事前に担当のCSMにご相談ください。
APK / マニフェストの準備
サードパーティのアプリストアごとに、次の手順で個別のAPK / マニフェストを準備します。
- 中国からのトラフィックを識別するため、マニフェストに次の記述を追加します。
注意:パラメータでは大文字と小文字が区別されます。チャネルにはcn_marketを設定することを推奨します。< meta-data android:name="CHANNEL" android:value="cn_market"> - 次のいずれかの方法でストアを識別します。
-
マニフェストを使用する方法:AndoridManifest.xmlファイルに次の行を追加します。 AF_STOREの値は、ストアごとに固有の値にする必要があります。
または<meta-data android:name="AF_STORE" android:value="example_store"/> -
APIを使用する方法:サードパーティのアプリストアごとに、個別のAPKを用意します。 setOutOfStore APIを呼び出し、AF_STOREの値を設定します。ストアごとに固有の値を設定してください。
AppsFlyerLib.getInstance().setOutOfStore("example_store")
-
マニフェストを使用する方法:AndoridManifest.xmlファイルに次の行を追加します。 AF_STOREの値は、ストアごとに固有の値にする必要があります。
これらの方法でAF_STOREパラメータを設定すると、その値がアトリビューションデータのinstall_app_store項目に設定されます。この項目は、次のレポートで利用できます。
- コホート分析
- ローデータレポート
アトリビューションに関するその他の考慮事項
アトリビューションリンクに対応していないストアへの対応
中国のサードパーティAndroidアプリストアの多くは、広告配信による送客も行う広告プラットフォームです。こうしたストアの中には、アトリビューションリンクの使用に対応していないものがあります。その場合は、次の方法で対応できます。
- install_app_store項目を使用(推奨):アトリビューションリンクを経由せずに発生したインストールは、AppsFlyerではオーガニックインストールとして計測されます。 install_app_store項目を利用すると、実際のインストール元を特定できます。注意:install_app_store項目は、前述のAF_STOREパラメータによって設定されます。
- マニフェストファイルのプリインストール名を使用。マニフェストに設定されたプリインストール名を利用する方法です。ただし、プリインストール用APKが市場に流出すると、アトリビューション情報が不正確になるという欠点があります。この方法を使用する場合は、APKを保護するための適切な取引条件を設けてください。
中国国内向けアトリビューションリンク
中国国内で利用できるリンク
中国国内のトラフィックのみを扱うメディアソースでは、ここで説明するドメインのリンクを使用してください。これらのリンクは中国国内からアクセスでき、より良いユーザー体験を提供します。
通常のアトリビューションリンク:https://app.aflink.com (aflink.com)
OneLinkアトリビューションリンク:https://go.onelnk.com (onelnk.com)。注意:onelnk.comドメインを使用する前に、AppsFlyerの担当CSMにお問い合わせください。
注意:WeChatではonelnk.comのみが許可リストに登録されており、onelink.meはブロックされています。
af_rの使用
af_rを使用し、ユーザーのリダイレクト先がGoogle Playではなく、APKのダウンロードURLまたはAPKを配布するストアになるようにします。
注意:中国国内の連携済みメディアソースでは、デフォルトのアトリビューションURLテンプレートに&redirect=falseが設定されていることがよくあります。この場合、リダイレクトはAppsFlyerではなく、広告プラットフォーム側で行われます。
連携済みメディアソースの詳細は、次の記事を参照してください。中国におけるAndroidアプリのプロモーション
ストアハイジャックの検出
サードパーティのアプリストアを利用する場合、ユーザーはまず、メディアソース(アドネットワーク)のサードパーティストアからアプリをインストールします。インストールハイジャックが発生するケースでは、警告のポップアップが表示され、デバイス(携帯電話)メーカーのアプリストアから直接アプリをインストールまたは更新するよう促されます。ユーザーが同意すると、メーカーのアプリストアにリダイレクトされ、APKがダウンロードされます。このようにして、デバイスメーカーがインストールを横取りします。
以下に、通常の場合とハイジャックが発生する場合の流れを示します。
通常の流れ
ユーザーがmedia-exampleの広告をクリックすると、そのままアプリがダウンロードされるか、legitimate-app-storeにリダイレクトされてアプリをダウンロードします。 AppsFlyerには、次のアトリビューション情報が記録されます。
- メディアソース:media-example
- インストール元のアプリストア:legitimate-app-store
ハイジャックが発生する場合の流れ
ユーザーがmedia-exampleの広告をクリックします。ダウンロードが始まると警告のポップアップが表示され、デバイスメーカーのアプリストアからアプリをダウンロードするよう促されます。ユーザーが同意すると、メーカーのストアにリダイレクトされ、アプリをダウンロードします。 AppsFlyerには、次のアトリビューション情報が記録されます。
- メディアソース:media-example
- インストール元のアプリストア:manufacturer-store
AppsFlyerでのハイジャックの特定
インストールハイジャックを特定するには、メディアソースとインストール元のアプリストアの項目を比較します。想定されるインストール元のストアと実際のストアが異なる場合は、インストールハイジャックが発生したことを示します。