SDKシグネチャーライブラリの実装

AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。

事前準備

シグネチャーライブラリをAndroidアプリに実装する前に、以下を確認してください。

使用中のAndroid APIバージョンが 21以降 であること。
お使いのAdjust SDKバージョンが 4.38.2以降 であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。
Proguardを使用している場合、シグネチャーライブラリとAdjust SDKの両方で全く同じProguard設定を使用する必要があります。

シグネチャーv1またはv2ライブラリから移行

以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。

以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。
以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。

シグネチャーライブラリはGitHubでリリースされており、バージョン 3.20.1以降はMavenに反映されています。シグネチャーライブラリをプロジェクトに追加するには、アプリレベルのbuild.gradleに以下を追加します（利用可能な最新のバージョンに変更してください）。

1
dependencies {
2
   implementation 'com.adjust.signature:adjust-android-signature:x.x.x'
3
}

または、ベータ版リリースはバージョン3.24.1以降からMavenで利用可能です。シグネチャーライブラリをプロジェクトに追加するには、プロジェクトレベルとアプリレベルのbuild.gradleにそれぞれ以下を追加します（利用可能な最新のバージョンに変更してください）。

1
repositories {
2
        maven {
3
            url "https://oss.sonatype.org/content/repositories/snapshots/"
4
        }
5
...

1
dependencies {
2
   implementation 'com.adjust.signature:adjust-android-signature:x.x.x-SNAPSHOT'
3
}

これで、シグネチャーライブラリがプロジェクトに実装されました。Adjustでデジタル証明書を設定するには、次のセクションの手順に従ってください。

GitHubから最新の安定版またはベータ版を取得します。
アプリモジュールディレクトリ内に新しいlibsディレクトリを作成します。
提供されたAARライブラリをlibsディレクトリにコピーします。

Android Studioのディレクトリのスクリーンショット

アプリレベルのbuild.gradleファイルを開き、以下を追加します。

1
android {
2
   defaultConfig {
3
      ndk.abiFilters 'armeabi-v7a','arm64-v8a','x86','x86_64'
4
   }
5
}
6

7
dependencies {
8
   implementation files('libs/adjust-lib.aar')
9
}

Android Studioのポップアップで Sync Now を選択して、変更を同期します。

Adjustで証明書を設定する

アプリにシグネチャーライブラリを実装すると、Adjust SDKからAdjustに送信される全てのリクエストが署名されます。また、Adjust SDKは、署名証明書のフィンガープリントなどの関連情報をAdjustのサーバーに送信します。

証明書フィンガープリントは、証明書内に保持される公開情報の暗号化ハッシュです。これはアプリの信頼性を検証するために使用できます。

シグネチャーライブラリでは、証明書フィンガープリントの信頼性を検証できません。フィンガープリントを含むリクエストをAdjustが信頼性のあるものとして受理するには、フィンガープリントをAdjustの許可リストに追加する必要があります。これを行うには、証明書フィンガープリントを取得し、Adjustに送信する必要があります。

以下の手順に従って、証明書のフィンガープリントを取得し、設定します。

アプリをテストする

Adjustテストコンソールを使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。

シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。

インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。
デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。Adjust Insightsアプリで取得したアプリのアルゴリズムと広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：adid、android_id、gps_adid、imei、oaid。

コールは以下のようになります。
Terminal window
```
1
$ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}'
```
テストコンソールからデバイスのデータを削除したら、テストデバイスにアプリをインストールして起動し、インストール情報をAdjustに送信します。
テストデバイスの広告IDをテストコンソールに入力し、インストールイベント情報を取得します。以下の点を確認してください。
1. SignatureVerificationResultフィールドに次の値が表示されている： Valid Signature
2. SignatureVersionフィールドに次の値が表示されている： 3

これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、support@adjust.comまでお問い合わせください。

これで、シグネチャーライブラリがアプリに連携されました。 2回のアトリビューション期間が経過したら、 SDKシグネチャーの検証を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。

シグネチャーライブラリの更新

シグネチャーライブラリの更新とは、既存のライブラリを削除して新しいバージョンと連携し、テストを再度実行することです。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。シークレットIDが以下の基準を満たす場合は、必ず無効にしてください。

インストールのレポーティングに貢献していない。
アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースしている。