デバイス出荷時にアプリがプリインストールされている場合は、プリインストールリンクを使用することで、そのユーザーを計測することができます。Adjustストア・プリインストールツール(adjust-dtt
)は、このアトリビューション情報をAPKに挿入することができます。Adjust SDKがadjust-dtt
を介して挿入される情報を読み取ることで、アプリをプリインストールしているユーザーを特定のAdjustリンクにアトリビュートします。
事前準備
GitHubから adjust-dtt
ツールをダウンロードしてください。ツールを使用するには、次のコマンドを実行して、ファイルを実行可能にしてください。
adjust-dtt
を使用する前に、マシンを設定する必要があります。adjust-dtt
を使用するには、以下のツールがデバイスにインストールされている必要があります:
ruby
:adjust-dtt
を実行するための言語ツールapktool
:APKを解凍および再圧縮するためのツールjarsigner
:APK署名のためのツール
それぞれのインストールは、以下の指示に従ってください。
ruby
RubyはmacOSデバイスにプリインストールされています。
ruby-lang Webサイトのディストリビューション手順に従ってください。
apktool
Homebrewを使用して、Apktoolをインストールできます。
あるいは、Apktool Webサイトの手順に従ってください。
Apktool Webサイトのディストリビューション手順に従ってください。
jarsigner
jarsigner
はJDK(Java Development Kit)の一部として含まれています。OpenJDKとOracle JDKの両方の実装で利用可能です。Homebrewを使用して、OpenJDKをインストールできます。これを行うには、次のコマンドを実行してください:
Oracle JDKを使用している場合は、Oracle Webサイトの手順に従ってください。
jarsigner
はJava Development Kit(JDK)の一部として含まれています。OpenJDKとOracle JDKの両方の実装で利用可能です。OpenJDKは、多くの主要なディストリビューションのリポジトリで利用可能です。お使いのディストリビューションのインストール手順を検索し、OpenJDKをインストールしてください。jarsigner
を使用するには、開発パッケージをインストールする必要があります。
Oracle JDKを使用している場合は、Oracle Webサイトの手順に従ってください。
プリインストールリンク情報を追加
ステップ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
ファイルの例です。
各ストアに同じ設定を使用したい場合、ファイルのルートフォルダでグローバルパラメーターを定義できます。ストアに設定されたパラメーターは、そのストアのグローバルパラメーターを上書きします。以下はその例です。
この例では、 store_1
のAPKを生成する際に、adjust-dtt
ツールはdifferentkeystore.jks
、 differentkeystorepass
およびdifferentkeystorealias
を使用します。これにより、各ストアごとに変更されたAPKを生成します。
ステップ4:adjust-dttツールの実行
adjust-dtt
ツールは、 adjust-config.yaml
ファイルへのパスを引数として受け取ります。APKにキャンペーン情報を追加するには、次のようなツールを実行してください:
adjust-dtt
は以下を実行します:
-
APKをフォルダに解凍します。フォルダはAPKと同じ場所にあり、APKと同じ名前になります。
-
assets
フォルダーとadjust_config.properties
ファイルを検索します。adjust_config.properties
ファイルにはデフォルトのキャンペーン情報が含まれています。assets
フォルダーとadjust_config.properties
ファイルが存在しない場合は作成します。default_tracker
の情報がadjust_config.properties
ファイルに書き込まれます。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までお問い合わせください。