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を追加します。
dependencies { implementation 'com.adjust.sdk:adjust-android:5.1.0' implementation 'com.adjust.sdk:adjust-android-oaid:5.1.0'}
Huawei OAIDの計測を行うには、開発者用リポジトリと追加のdependencyを加える必要があります。
- 以下の内容をプロジェクトの
build.gradle
ファイルに追加します:
allprojects { repositories { maven { url 'https://developer.huawei.com/repo/' } mavenCentral() }
- 以下の内容をアプリレベルの
build.gradle
ファイルに追加します:
dependencies { implementation 'com.adjust.sdk:adjust-android:5.1.0' implementation 'com.adjust.sdk:adjust-android-oaid:5.1.0' implementation 'com.huawei.hms:ads-identifier:3.4.62.300'}
スタンドアロンバイナリをインストールする
プラグインは、リリースページからスタンドアロンバイナリとして追加することもできます。
MSA SDKをアプリに追加する
要件
OAIDプラグインによりMSA SDKからOAID値を読み取ることができるようにするには、MSA SDKをプロジェクトに追加する必要があります。これを行うには、以下の手順に従ってください。
- MSA SDK(AARファイル)をプロジェクトの
libs
ディレクトリにコピーし、dependencyを設定します。 - さらに、
supplierconfig.json
をプロジェクトのassets
ディレクトリにコピーします。 - MSA SDKと詳細な手順については、MSAのWebサイトをご覧ください。
HMS Core SDKをアプリに追加する
HMS Core SDKを使用して、HuaweiデバイスのOAIDにアクセスすることができます。Adjust OAIDプラグインがHMS Core SDKから値を読み込めるようにするには、build.gradle
を以下のように更新してください:
- Huawei mavenレポジトリを追加する
repositories { maven { url "https://developer.huawei.com/repo/" }}
- HMS Core SDKを追加する
dependencies { implementation 'com.huawei.hms:ads-identifier:3.4.56.300'}
Proguardの設定
アプリがGoogle Play ストアを対象としていない場合は、Android開始ガイドに記載されている全てのルールを追加する必要はありません。Google Play開発者サービスとインストール リファラー ライブラリに関連するルールは、削除することができます。維持する必要があるのは、Adjust SDKに適用されるルールのみです。
-keep public class com.adjust.sdk.** { *; }
DependencyとしてMSA SDK AARに追加する場合は、以下のルールを追加します。
-keep class com.bun.miitmdid.core.** { *; }
プラグインを使用する
プラグインを設定したら、デバイスのIMEIとMEIDを収集できます。これを行うには、AdjustOaid.readOaid(applicationContext)
メソッドをAdjust SDKの開始前に呼び出します。
SDKが OAIDを読み取らないようにするには、AdjustOaid.doNotReadOaid()
メソッドを呼び出します。