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を追加します。

dependencies {
   implementation 'com.adjust.sdk:adjust-android:4.38.5'
   implementation 'com.adjust.sdk:adjust-android-oaid:4.38.5'
}

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

1. 以下の内容をプロジェクトのbuild.gradleファイルに追加します：

allprojects {
    repositories {
        maven {
            url 'https://developer.huawei.com/repo/'
        }
    mavenCentral()
    }

2. 以下の内容をアプリレベルの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をアプリに追加する

要件

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レポジトリを追加する

repositories {
  maven {
      url "https://developer.huawei.com/repo/"
  }
}

2. 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の開始前に呼び出します。

1
AdjustOaid.readOaid(applicationContext);
2

3
// ...
4

5
Adjust.onCreate(config);

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

1
AdjustOaid.doNotReadOaid();