どのようにお手伝いできますか?

中国国内市場におけるアトリビューション計測

  • 更新

概要: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の実装

GAIDの代わりにIMEI、OAID、またはその両方を使用

中国で提供される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の収集

OAIDを収集する方法は2つあります。

  • setCollectOaid
  • setOaidData
APIメソッドを有効にする手順

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'
}
MainActivity MainActivity(従来の実装)
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();
       }
   }
}

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にアプリを追加するには:

  1. AppsFlyerで[マイアプリ]をクリックします。
  2. [アプリを追加]をクリックします。
    アプリの追加画面が開きます。
  3. [Google Play以外で配信するAndroid APK]を選択します。
  4. 次の項目を入力します。
    • Androidパッケージ名:任意のテキストを入力します。
    • チャネル名:後述のマニフェストに設定するチャネル名と同じ値を入力します。この項目にはcn_marketを設定することを推奨します。
    • アプリURL

注意:[承認待ちまたは未公開]を選択してアプリを作成することもできますが、推奨しません。この方法を使用する場合は、事前に担当のCSMにご相談ください。

APK / マニフェストの準備

サードパーティのアプリストアごとに、次の手順で個別のAPK / マニフェストを準備します。

  1. 中国からのトラフィックを識別するため、マニフェストに次の記述を追加します。
    < meta-data android:name="CHANNEL" android:value="cn_market">
    注意:パラメータでは大文字と小文字が区別されます。チャネルにはcn_marketを設定することを推奨します。
  2. 次のいずれかの方法でストアを識別します。
    • マニフェストを使用する方法: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")

これらの方法で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でのハイジャックの特定

インストールハイジャックを特定するには、メディアソースとインストール元のアプリストアの項目を比較します。想定されるインストール元のストアと実際のストアが異なる場合は、インストールハイジャックが発生したことを示します。