SDKバージョンV4.0+を使用してください。

この方式は最も確実性が高いため、推奨されています。ただし、以後のすべてのアプリインストールは、常にプリインストールのメディアソースにアトリビューションされる点に注意してください。これは、新規インストールか再インストールかを問いません。 0>

システムプロパティ方式では、開発者とメーカーの両方で作業が必要です。

開発者

メーカーまたはメディアソースにAPKを提供します。通常のAPKを提供してください。この方式では、別のAPKを用意する必要はありません。

pre_install.appsflyerという名前のファイルを作成します。ファイルに、次のキーと値のペアを追加します。

<0>=<1>

com.appsflyer.sampleapp=huawei

プリインストール用のパラメータを追加で指定するには、次のように設定します。

pre_install.appsflyerファイルに、追加のパラメータをJSON形式で指定します。例：

com.appsflyer.sampleapp={"pid":"huawei", "c":"special_campaign","af_adset":"some_adset"}

pre_install.appsflyerファイルを作成したら、APKと一緒にメディアソースまたはメーカーに渡します。

メーカー

メーカーは、任意のパスにpre_install.appsflyerファイルを配置します。 pre_install.appsflyerファイルのアクセス権限を744に設定してください。

次に、メーカーはシステムプロパティファイルを編集し、pre_install.appsflyerファイルを参照するように設定します。この設定には、システムプロパティにキーと値のペアを追加する必要があります。

Androidのシステムプロパティへのキーと値のペアの追加：

adb shell su
setprop ro.appsflyer.preinstall.path /data/pre_install.appsflyer

別の方法として、Androidのファイルシステムからシステムプロパティファイルを取得し、編集して戻すこともできます。

adb root
adb remount
adb pull /system/build.prop
echo ro.appsflyer.preinstall.path=/data/pre_install.appsflyer >> build.prop
adb push build.prop /system/build.prop
adb shell chmod 744 /system/build.prop
adb reboot

メリット

メディアソースやメーカーごとに、異なるAPKを管理する必要がありません。 Google Playで配信するアプリを変更してパスを追加する必要がありません。メーカーは任意のパスを使用できます。また、異なる端末で動作する複数のプリインストールアプリ間に依存関係はありません。

この方式では、プリインストールキャンペーンとメディアソースへのアトリビューションが保証されます。ユーザーが初回起動前にアプリを更新した場合や、広告をクリックした後にアプリをインストールした場合でも、プリインストールのメディアソースまたはメーカーにアトリビューションされます。

デメリット

メディアソースまたはメーカー側が、作業の一部を担う必要があります。開発者は、メーカーまたはメディアソースが必要な手順を実施したことを確認する必要があります。また、アプリ開発者にとっては、この方式のテストがやや難しい場合があります。

SDK API方式では、ネイティブのAPIを使用して、プリインストールのアトリビューション先となるメーカー名またはメディアソース名を指定できます。

この方式を使用するには、SDKを初期化する前に、AFApplicationクラスに次のメソッド呼び出しを追加します。

setPreinstallAttribution(String mediaSource, String campaign, String siteId)

メディアソースと連携する場合

AppsFlyerLib.getInstance().setPreinstallAttribution("MEDIA_SOURCE_NAME", "CAMPAIGN_NAME", "123");
AppsFlyerLib.getInstance().init(AF_DEV_KEY , conversionListener , getApplicationContext());

メーカーと連携する場合

AppsFlyerLib.getInstance().setPreinstallAttribution(android.os.Build.MANUFACTURER, "CAMPAIGN_NAME", "123");
AppsFlyerLib.getInstance().init(AF_DEV_KEY , conversionListener , getApplicationContext());

メリット

SDK API方式では、メーカー名をプログラムで取得できます。メーカーを問わず、SDKのメソッドで端末から直接メーカー名を取得できます。そのため、連携するすべてのメーカーに対して、1つのAPKを管理すれば対応できます。

setPreinstallAttributionメソッドでは、キャンペーン名を指定できます。すべてを「Pre-install」キャンペーンとして扱う代わりに、メーカーやメディアソースごとにキャンペーンを分けることができます。

デメリット

メーカーと直接連携する場合は、メーカー向けとGoogle Play向けの2種類のAPKを管理する必要があります。いずれの場合も、複数のAPKが必要です。

アプリの所有者に代わってメーカーとやり取りする複数のメディアソースと連携する場合は、メディアソースごとに個別のAPKを管理する必要があります。

次の場合、プリインストールのメディアソースにインストールがアトリビューションされないことがあります。

• 新しい端末のユーザーが、プリインストールされたアプリを一度も起動せずにGoogle Playから直接更新した場合、インストールはオーガニックとみなされます。
• 新しい端末のユーザーが、広告をクリックした後にGoogle Playからアプリを更新した場合、インストールは広告を配信したメディアソースにアトリビューションされます。

この方式では、アプリのマニフェストファイルにメタデータタグを追加します。連携するメディアソースまたはメーカーごとに、この手順を行う必要があります。

applicationの閉じタグの前に、メタデータタグを追加します。

    <0/>
  1>
2>

アプリの初回起動時に、AppsFlyer SDKがマニフェストファイルのメタデータタグを検出し、その内容に応じてインストールをアトリビューションします。

メリット

マニフェストファイルに媒体名を指定する方式は、プリインストールキャンペーンを簡単にアトリビューションできる方式です。マニフェストに追加するタグは1つだけです。また、キャンペーンを計測するために、メディアソースやメーカー側で作業を行う必要はありません。

デメリット

メタデータタグにメディアソース名またはメーカー名を指定するため、メディアソースやメーカーごとに異なるAPKを管理する必要があります。

次の場合、プリインストールのメディアソースにインストールがアトリビューションされないことがあります。

• 新しい端末のユーザーが、プリインストールされたアプリを一度も起動せずにGoogle Playから直接更新した場合、インストールはオーガニックとみなされます。
• 新しい端末のユーザーが、広告をクリックした後にGoogle Playからアプリをインストールした場合、インストールは広告を配信したメディアソースにアトリビューションされます。

この方式では、開発者とメーカーの両方で作業が必要です。

開発者

この方式では、メディアソース名またはメーカー名が記載されたファイルのパスを指定できます。次の3つの手順を行ってください。

1. キーと値のペアを記載したファイルを作成します。ファイル名はpre_install.appsflyerにします。ファイルに、<PACKAGE_NAME>=<MEDIA_SOURCE>の形式でキーと値のペアを指定します。例：com.appsflyer.sampleapp=my_media_source。
   
   

   プリインストール用の追加パラメータの指定

   ファイル内に、プリインストール用の追加パラメータをJSON形式で指定できます。例えば、pre_install.appsflyerファイルに次のキーと値のペアを追加できます。

   com.appsflyer.sampleapp={"pid":"huawei", "c":"special_campaign","af_adset":"some_adset"}
   

    重要！

   このオプションを使用する場合は、次の動作に注意してください。

   1. af_channelに「Pre-install」が設定されます。
   2. JSONにpidがない場合、メディアソースは「None」と表示されます。
   3. JSONの設定にcがない場合、キャンペーン名は「Pre-install」に設定されます。
   4. JSONの形式が正しくない場合、指定した文字列がメディアソース名として扱われます。

   pre_install.appsflyerファイルを作成したら、APKと一緒にメディアソースまたはメーカーに渡します。

2. メディアソースまたはメーカーと相談し、ファイルの配置先のパスを決めます。推奨するパスは「/data/local/tmp/pre_install.appsflyer」です。
3. 配置先が決まったら、そのパスをマニフェストファイルに指定します。 applicationの閉じタグの前に、次のコードを追加します。
   

   <0/>
   

メーカー

メーカーは、合意したパスにファイルを配置する必要があります。 pre_install.appsflyerファイルのアクセス権限を744に設定してください。

アプリが起動すると、SDKはマニフェストファイル内の指定パスを確認し、そのパスでファイルを探します。ファイルが見つかると、記載されているメディアソースにインストールをアトリビューションします。

メリット

AppsFlyerは、次の2つのデフォルトのパスでpre_install.appsflyerファイルを探します。

/data/local/tmp/pre_install.appsflyer
または
/etc/pre_install.appsflyer

メーカーによっては、デフォルト以外のパスにファイルを配置したい場合があります。その場合は、マニフェストファイルにデフォルト以外のパスを指定できます。

デメリット

メディアソースやメーカーごとに、個別のpre_install.appsflyerファイルを管理する必要があります。

メーカーがpre_install.appsflyerファイルをデフォルト以外のパスに配置したい場合があります。その場合は、デフォルト以外のパスごとに個別のAPKを管理する必要があります。

デフォルト以外のパスを使用すると、次の場合にプリインストールのメディアソースにインストールがアトリビューションされないことがあります。

• 新しい端末のユーザーが、プリインストールされたアプリを一度も起動せずにGoogle Playから直接更新した場合、インストールはオーガニックとみなされます。
• 新しい端末のユーザーが、広告をクリックした後にGoogle Playからアプリをインストールした場合、インストールは広告を配信したメディアソースにアトリビューションされます。

Android Studioでアプリをビルドし、テストデバイスにインストールします。アプリが起動したら、Android StudioでLogcatを開き、「AppsFlyer」でフィルタリングします。アトリビューションされたインストールの詳細が表示されます。以下のスクリーンショットを参照してください。

設定が成功すると、メーカーまたはメディアソースにアトリビューションされたノンオーガニックインストールがダッシュボードに表示されます。このインストールイベントは、「Pre-install」キャンペーンにも表示されます。

AppsFlyerアカウントにアクセスし、テスト対象のアプリのダッシュボードを開きます。次の手順に従ってください。

1. オーバービューダッシュボードで、メディアソースのフィルターから対象のメディアソースを選択します。
   
   

2. ［キャンペーン別内訳］グラフでは、「my media source」にアトリビューションされたインストールが、Pre-installキャンペーンによるものであることを確認できます。
   
   
   集計パフォーマンスレポートでも、インストールが正しくアトリビューションされているか確認できます。このレポートでは、メディアソースとキャンペーンを確認できます。以下のスクリーンショットでは、メディアソースが「My Media Source」、キャンペーンがPre-installになっています。
   
   
3. プリインストールキャンペーンで連携するすべてのメーカーまたはメディアソースについて、この手順を繰り返します。

同じ端末にインストールされた複数のアプリでキャンペーンを実施している場合、4つの方式のいずれでもアトリビューションを計測できます。

• マニフェストファイルに媒体名を指定する方式：各アプリのManifest.xmlに、メディアソースまたはメーカーを指定します。
• SDK API方式：各アプリで、プリインストール用のSDK APIメソッドにメディアソースまたはメーカーを指定します。
• システムプロパティ方式または設定ファイルのパスを指定する方式：pre_install.appsflyerファイルに、各アプリと対応するメディアソースを指定できます。各アプリの情報は、ファイル内で1行ずつ記載してください。例：

  com.appsflyer.tester=<0>market_name0>
  com.newapp.newapp=<0>market_name0>
  com.game.king=<0>market_name0>

連携するメディアソースまたはメーカーがAppsFlyerパートナーであれば、インストールのポストバックを有効にできます。

その場合は、メディアソース名が、AppsFlyerで設定されているメディアソースのpidと一致していることを確認してください。

例えば、market_nameと連携している場合、そのpidはmarket_name_intです。 pidは、連携済みパートナーのアトリビューションリンクで確認できます。

現在、プリインストールを代理店にアトリビューションすることはできません。 

プリインストールデータにaf_prt（代理店名のパラメータ）が含まれ、ユーザーがプリインストールされたアプリを起動した場合：

• ユーザーは、代理店が使用するメディアソース（pid=）にアトリビューションされます。
• 広告主は、ユーザーレベルのすべてのデータにアクセスできます。
• ユーザーは、代理店にはアトリビューションされません。
• 代理店は、ユーザーレベルのデータにアクセスできません。