OAIDプラグイン

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

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

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

スタンドアロンバイナリをインストールする

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

プレハブ（Prefab）としてプラグインを使用する

Unityアプリでは、OAIDプラグインをプレハブとして読み込むことができます。スタンドアロンバイナリには、この情報を含むPrefabフォルダーが含まれています。

プレハブとしてOAIDプラグインを読み込む手順

1. AdjustOaid/Prefabフォルダーにあるプレハブの位置を特定する。
2. 手動で開始（Start Manually） オプションのチェックを外す。
3. Oaidの読み取り（Read Oaid） オプションにチェックを入れる。

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.62.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.** { *; }

プラグインを使用する

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

1
AdjustOaid.ReadOaid();
2
// ...
3
Adjust.start(config);

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

1
AdjustOaid.DoNotReadOaid();