Adjustストア・プリインストールツール

デバイス出荷時にアプリがプリインストールされている場合は、プリインストールリンクを使用することで、そのユーザーを計測することができます。Adjustストア・プリインストールツール（adjust-dtt）は、このアトリビューション情報をAPKに挿入することができます。Adjust SDKがadjust-dttを介して挿入される情報を読み取ることで、アプリをプリインストールしているユーザーを特定のAdjustリンクにアトリビュートします。

事前準備

GitHubから adjust-dtt ツールをダウンロードしてください。ツールを使用するには、次のコマンドを実行して、ファイルを実行可能にしてください。

$ chmod +x adjust-dtt

adjust-dttを使用する前に、マシンを設定する必要があります。adjust-dttを使用するには、以下のツールがデバイスにインストールされている必要があります：

ruby：adjust-dttを実行するための言語ツール
apktool：APKを解凍および再圧縮するためのツール
jarsigner：APK署名のためのツール

それぞれのインストールは、以下の指示に従ってください。

ruby

apktool

jarsigner

プリインストールリンク情報を追加

ステップ1：keystoreファイルの取得

APKを作成すると、Android Studioがそれに署名します。これは、「未署名」バージョンのAPKを作成した場合でも同様です。この時、Android Studioはデフォルトのデバッグ署名keystoreファイルを使用してAPKに署名します。このkeystoreファイルはデフォルトで~/.android/debug.keystoreにあります。

Android Studioから署名済みAPKをエクスポートする場合、カスタム署名keystoreファイルを使用してAPKに署名します。

adjust-dtt を使用するには、デフォルトのキーストアファイルまたはカスタムキーストアファイルのいずれかにアクセスできる必要があります。これは、apktoolを使用してAPKを解凍すると、全ての署名が削除されるためです。APKを再パッケージ化しても、署名は再度有効になりません。Androidデバイスに配信するためにAPKを再署名するには、署名情報を使用してjarsignerを実行する必要があります。

ステップ2：リンクを作成する

次に、Adjustダッシュボードでリンクを作成します。このリンクトークンを、プリインストールされたアプリのデフォルトキャンペーンとして使用します。つまり、アプリをプリインストールしている全てのユーザーがこのトークンにアトリビュートされることになります。

ステップ3：configファイルの作成

キーストアファイルとリンクトークンを取得したら、設定ファイルを作成できます。adjust-dttはadjust-config.yaml構成ファイルを使用して設定を読み取ります。このファイルには、設定が必要な各種アプリストアの設定が含まれています。

パラメーター	データタイプ	グローバルまたはストアごと	説明
`apk_path`	`String`	両方	APKへの絶対パス
`keystore_path`	`String`	両方	keystoreファイルへの絶対パス
`keystore_pass`	`String`	両方	keystore署名パスワード
`keystore_alias`	`String`	両方	keystoreエイリアス
`default_tracker`	`String`	ストアごと	プリインストールをアトリビュートするためのAdjustリンクトークン

以下は、store_1、store_2、store_3という名前の3つのストアの設定を含むadjust-config.yamlファイルの例です。

apk_path: /Users/username/Desktop/apk/example-release.apk
keystore_path: /Users/username/Desktop/apk/mykeystore.jks
keystore_pass: mykeystorepass
keystore_alias: mykeystorealias
stores:
   store_1:
      default_tracker: abc123
   store_2:
      default_tracker: abc456
   store_3:
      default_tracker: abc789

各ストアに同じ設定を使用したい場合、ファイルのルートフォルダでグローバルパラメーターを定義できます。ストアに設定されたパラメーターは、そのストアのグローバルパラメーターを上書きします。以下はその例です。

apk_path: /Users/username/Desktop/apk/example-release.apk
keystore_path: /Users/username/Desktop/apk/mykeystore.jks
keystore_pass: mykeystorepass
keystore_alias: mykeystorealias
stores:
   store_1:
      default_tracker: abc123
      keystore_path: /Users/username/Desktop/apk/differentkeystore.jks
      keystore_pass: differentkeystorepass
      keystore_alias: differentkeystorealias
   store_2:
      default_tracker: abc456
   store_3:
      default_tracker: abc789

この例では、 store_1のAPKを生成する際に、adjust-dttツールはdifferentkeystore.jks 、 differentkeystorepassおよびdifferentkeystorealiasを使用します。これにより、各ストアごとに変更されたAPKを生成します。

ステップ4：adjust-dttツールの実行

adjust-dtt ツールは、 adjust-config.yaml ファイルへのパスを引数として受け取ります。APKにキャンペーン情報を追加するには、次のようなツールを実行してください：

$ adjust-dtt adjust-config.yaml

adjust-dtt は以下を実行します：

APKをフォルダに解凍します。フォルダはAPKと同じ場所にあり、APKと同じ名前になります。
assets フォルダーと adjust_config.properties ファイルを検索します。adjust_config.propertiesファイルにはデフォルトのキャンペーン情報が含まれています。
1. assetsフォルダーとadjust_config.propertiesファイルが存在しない場合は作成します。default_trackerの情報がadjust_config.propertiesファイルに書き込まれます。
2. adjust_config.propertiesファイルが存在する場合、default_trackerの情報を書き込みます。ファイルにすでにデフォルトのキャンペーン値が含まれている場合は、その2つを比較します。これらが異なる場合、adjust-config.yamlファイルの値で既存の値が上書きされます。
APKを再圧縮します。
adjust-config.yamlで指定された情報を使用してAPKに署名します。keystore_path 、 keystore_pass 、および keystore_alias パラメーターを使用しています。
元のAPKと同じ名前に _[store_name] のsuffixが付いたAPKを生成します。上記の例では、ツールは3つのAPKファイルを生成されています。これらは example-release_store_1.apk 、 example-release_store_2.apk 、および example-release_store_3.apkと命名されます。ツールでこれらのファイルが生成されたら、名前を変更できます。

このツールに関してご不明な点や問題がございましたら、support@adjust.comまでお問い合わせください。