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を読み取ることができます。

このプラグインを使用する前に、プラットフォームの開始ガイドに従ってください。

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

Maven

Android

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

マルチプラットフォーム

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

Unity

MSA SDKをアプリに追加する

注意:
Huawei端末のOAID値を読み取る場合は、MSA SDKを追加する必要はありません。この場合、OAIDプラグインは HMS Core 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以降
v.1.1.0以降v4.28.9以降
v.2.0.0以降v4.33.0以降

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

  1. MSA SDK(AARファイル)をプロジェクトのlibsディレクトリにコピーし、dependencyを設定します。
  2. さらに、supplierconfig.jsonをプロジェクトのassetsディレクトリにコピーします。

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ストアを対象としていない場合は、開始ガイドに記載されている全てのルールを追加する必要はありません。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の開始前に呼び出します。

JavaAndroid
C#Unity
AdjustOaid.readOaid(applicationContext);

// ...

Adjust.onCreate(config);

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

JavaAndroid
C#Unity
AdjustOaid.doNotReadOaid();