プリインストールアプリのアクティビティを送信する

Adjust SDKを使用して、ユーザーのデバイスにプリインストールされているアプリでのアクティビティを記録することができます。これにより、キャンペーンからアプリをダウンロードしなかったユーザーの情報を記録することが可能です。

Configオブジェクトには、この機能を制御するbool``preinstallTrackingEnabledプロパティが含まれています。プリインストール計測を有効化するには、setPreinstallTrackingEnabledメソッドをtrue引数で呼び出します。

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
2
//...
3
adjustConfig.setPreinstallTrackingEnabled(true);
4
//...
5
Adjust.start(adjustConfig);

Adjust SDKは、プリインストールアプリを計測する5つのメソッドを提供しています：

• システムプロパティ（Androidのみ）
• コンテンツプロバイダー（Androidのみ）
• System Installer Receiver（Androidのみ）
• World Readable Directory（Androidのみ）
• デフォルトリンクトークン（iOSおよびAndroid）

System Properties

Original Equipment Manufacturer（OEM）パートナーは、Androidのシステムプロパティを活用して、プリインストールされたアプリをアトリビューションすることができます。OEMはアトリビューション情報をファイルに書き出し、そのパスをシステムプロパティに追加します。Adjust SDKは初期化時にこのファイルを読み取り、そのインストールをアトリビュートします。

Content Provider

コンテンツプロバイダー（content provider）メソッドは、読み取り専用のコンテンツプロバイダーを使用します。SDKはコンテンツリゾルバー（content resolver）を使用して、リクエストからプリインストール情報を収集します。

パーミッションを設定するには、以下をAndroidManifest.xmlファイルに追加してください。

<uses-permission android:name="com.adjust.preinstall.READ_PERMISSION"/>

デバイスのプレインストール済みアプリにアクセスするには、以下をAndroidManifest.xmlファイルに追加してください。

<queries>
   <intent>
       <action android:name="com.attribution.REFERRAL_PROVIDER"/>
   </intent>
</queries>

System Installer Receiver

システム インストーラー メソッドは、ブロードキャストレシーバーを使用します。システムインストーラーはプリインストール情報をブロードキャストします。Adjust SDKは、システム プリインストール リファラー レシーバーを使用してこの情報を読み取ります。

レシーバーを設定するには、以下をAndroidManifest.xmlファイルに追加します。

<receiver android:name="com.adjust.sdk.AdjustPreinstallReferrerReceiver">
   <intent-filter>
      <action android:name="com.attribution.SYSTEM_INSTALLER_REFERRER" />
   </intent-filter>
</receiver>

World-readable directory

プリインストールされたアプリのアトリビューション情報を、世界で読み取り可能なディレクトリに保存します。SDKはインストール時にこのファイルから情報を読み取って、ユーザーをアトリビュートします。システムの暗号化プロトコルが、アプリデータを保護します。

プリインストール情報を見つけられるファイルパスをsetPreinstallFilePathメソッドにパスし、Adjust SDKがその情報にアクセスできるようにしてください。

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
2
//...
3
adjustConfig.setPreinstallFilePath("../EngagementFile.xml");
4
//...
5
Adjust.start(adjustConfig);

デフォルトのリンクトークン

デフォルトのリンクトークンを設定すると、全てのプリインストールを定義済みのAdjustリンクにアトリビュートさせることができます。Adjustはアトリビューションソースが変更されるまで、このトークンに対して全ての情報を記録します。設定する方法は次のとおりです：

1. Campaign Labで新しいリンクを作成します。

   1
   https://app.adjust.com/{token}

2. このトークンをコピーして、アプリのデリゲートファイルのsetDefaultTrackerメソッドにパスします。

   1
   AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
   2
   //...
   3
   adjustConfig.setDefaultTracker("{TrackerToken}");
   4
   //...
   5
   Adjust.start(adjustConfig);

3. アプリをビルドして実行します。ログを有効にしている場合は、ログにメッセージが表示されます。

   1
   Default tracker: 'abc123'.