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

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

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

1
val appToken = "{YourAppToken}"
2
val environment = AdjustConfig.ENVIRONMENT_SANDBOX
3
val config = AdjustConfig(this, appToken, environment)
4
config.enablePreinstallTracking()
5
//...
6
Adjust.initSdk(config)

1
String appToken = "{YourAppToken}";
2
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
3
AdjustConfig config = new AdjustConfig(this, appToken, environment);
4
config.enablePreinstallTracking();
5
//...
6
Adjust.initSdk(config);

1
var yourAppToken = yourAppToken;
2
var environment = AdjustConfig.EnvironmentSandbox;
3
var adjustConfig = new AdjustConfig(yourAppToken, environment);
4
adjustConfig.enablePreinstallTracking();

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

System Properties
Content Provider
System Installer Receiver
World-readable directory
デフォルトのリンクトークン

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
val appToken = "{YourAppToken}"
2
val environment = AdjustConfig.ENVIRONMENT_SANDBOX
3
val config = AdjustConfig(this, appToken, environment)
4
config.setPreinstallFilePath("../EngagementFile.xml")
5
//...
6
Adjust.initSdk(config)

1
String appToken = "{YourAppToken}";
2
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
3
AdjustConfig config = new AdjustConfig(this, appToken, environment);
4
config.setPreinstallFilePath("../EngagementFile.xml");
5
//...
6
Adjust.initSdk(config);

1
var yourAppToken = yourAppToken;
2
var environment = AdjustConfig.EnvironmentSandbox;
3
var adjustConfig = new AdjustConfig(yourAppToken, environment);
4
adjustConfig.setPreinstallFilePath("../EngagementFile.xml");

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

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

Campaign Labで新しいリンクを作成します。
```
1
https://app.adjust.com/{token}
```
このトークンをコピーして、setDefaultTrackerメソッドにパスします。

1
val appToken = "{YourAppToken}"
2
val environment = AdjustConfig.ENVIRONMENT_SANDBOX
3
val config = AdjustConfig(this, appToken, environment)
4
config.setDefaultTracker("{Token}")
5
//...
6
Adjust.initSdk(config)

1
String appToken = "{YourAppToken}";
2
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
3
AdjustConfig config = new AdjustConfig(this, appToken, environment);
4
config.setDefaultTracker("{Token}");
5
//...
6
Adjust.initSdk(config);

1
var yourAppToken = yourAppToken;
2
var environment = AdjustConfig.EnvironmentSandbox;
3
var adjustConfig = new AdjustConfig(yourAppToken, environment);
4
adjustConfig.setDefaultTracker("{Token}");

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