adjust-icon

OAID

Open Anonymous Device Identifier(OAID)は、Androidデバイスの一意の識別子です。Mobile Security Alliance(MSA)は、中国で製造される全デバイスがOAIDを提供するよう推奨しています。OAIDを使用することで、Google Play Servicesが利用できないデバイスをアトリビュートおよび計測できます。

OAIDプラグインは、デバイスのOAIDを提供します。SDKは、OAIDだけでなく他の識別子も引き続き使用できます。MSA SDKを使用している全ての端末、またはHuawei Mobile Service(HMS)Core SDKを使用している全てのHuawei端末で、OAIDを読み取ることができます。

プラグインをアプリに追加する

Maven

Mavenを使用している場合は、build.gradleファイルに下記のdependencyを追加します。

build.gradle
dependencies {
implementation 'com.adjust.sdk:adjust-android:4.38.4'
implementation 'com.adjust.sdk:adjust-android-oaid:4.38.4'
}

Huawei OAIDの計測を行うには、開発者用リポジトリと追加のdependencyを加える必要があります。

  1. 以下の内容をプロジェクトのbuild.gradleファイルに追加します:
build.gradle
allprojects {
repositories {
maven {
url 'https://developer.huawei.com/repo/'
}
mavenCentral()
}
  1. 以下の内容をアプリレベルのbuild.gradleファイルに追加します:
build.gradle
dependencies {
implementation 'com.adjust.sdk:adjust-android:4.33.4'
implementation 'com.adjust.sdk:adjust-android-oaid:4.33.4'
implementation 'com.huawei.hms:ads-identifier:3.4.62.300'
}

スタンドアロンバイナリのインストール

プラグインは、リリースページからスタンドアロンバイナリとして追加することもできます。

MSA SDKをアプリに追加する

要件

MSA SDKバージョンAdjust OAIDプラグインバージョン
v1.0.10以降v4.19.0以降
v1.0.12+v4.22.0以降
v1.0.13以降v4.23.0以降
v1.0.23以降v4.24.1以降
v1.0.25以降v4.27.0以降
v1.0.26以降v4.28.4以降
v1.1.0以降v4.28.9以降
v2.0.0以降v4.33.0以降

OAIDプラグインによりMSA SDKからOAID値を読み取ることができるようにするには、MSA SDKをプロジェクトに追加する必要があります。これを行うには、以下の手順に従ってください。

  1. MSA SDK(AARファイル)をプロジェクトのlibsディレクトリにコピーし、dependencyを設定します。
  2. さらに、supplierconfig.jsonをプロジェクトのassetsディレクトリにコピーします。
  3. MSA SDKと詳細な手順については、MSAのWebサイトをご覧ください。

HMS Core SDKをアプリに追加する

HMS Core SDKを使用して、HuaweiデバイスのOAIDにアクセスすることができます。Adjust OAIDプラグインがHMS Core SDKから値を読み込めるようにするには、build.gradleを以下のように更新してください:

  1. Huawei mavenレポジトリを追加する
build.gradle
repositories {
maven {
url "https://developer.huawei.com/repo/"
}
}
  1. HMS Core SDKを追加する
build.gradle
dependencies {
implementation 'com.huawei.hms:ads-identifier:3.4.56.300'
}

Proguardの設定

アプリがGoogle Play ストアを対象としていない場合は、Android開始ガイドに記載されている全てのルールを追加する必要はありません。Google Play開発者サービスとインストール リファラー ライブラリに関連するルールは削除することができます。維持する必要があるのは、Adjust SDKに適用されるルールのみです。

Proguard.pro
-keep public class com.adjust.sdk.** { *; }

DependencyとしてMSA SDK AARに追加する場合は、以下のルールを追加します。

Proguard.pro
-keep class com.bun.miitmdid.core.** { *; }

プラグインを使用する

プラグインを設定したら、デバイスのIMEIとMEIDを収集できます。これを行うには、AdjustOaid.readOaid(applicationContext)メソッドをAdjust SDKの開始前に呼び出します。

SDKが OAIDを読み取らないようにするには、AdjustOaid.doNotReadOaid()メソッドを呼び出します。