adjust-icon

OAID 插件

OAID (匿名设备标识符) 是针对安卓设备的一种唯一标识符。MSA (中国移动安全联盟) 推荐所有中国生产的设备提供 OAID。在 Google Play 服务不适用的市场中,您可以使用 OAID 对安卓设备进行归因和跟踪。

OAID 插件提供设备的 OAID。SDK 会继续使用 OAID 和其他标识符。对于所有使用 MSA SDK 的设备或使用 HMS (华为移动服务) Core SDK 的华为设备,OAID 均可读取。

将插件添加至您的应用

安装独立二进制文件

您也可以访问我们的发布页面,将插件作为独立二进制文件进行添加。

将插件作为 Prefab

您可以在 Unity 应用中将 OAID 插件作为 Prefab 进行加载。此独立二进制文件包含一个含有此信息的Prefab文件夹。

要将 OAID 插件作为 Prefab 进行加载:

  1. 找到 AdjustOaid/Prefab 文件夹中的 Prefab。
  2. 取消选择 Start Manually
  3. 勾选 Read Oaid 选项。

将 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,您需要将其加入项目中。为此,请进行下列操作:

  1. 复制 MSA SDK (AAR 文件) 到项目的 libs 目录并设置 依赖。
  2. supplierconfig.json 文件复制到项目的 assets 目录中。
  3. 您可以在MSA 官网找到 MSA SDK 和相关详细说明。

将 HMS Core SDK 添加至您的应用

您可以使用 HMS Core SDK 来访问华为设备的 OAID。要启用 Adjust OAID 插件并从 HMS Core SDK读取值,请按如下方式更新您的 build.gradle

  1. 添加华为 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.62.300'
}

ProGuard 设置

如果您的应用不是针对 Google Play 商店,则无需添加安卓入门指南中的所有规则。您可以移除与 Google Play 服务相关的规则和 install referrer 库,只需保留适用于 Adjust SDK 的规则。

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

如需添加 MSA SDK AAR 作为依赖,请添加以下规则:

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

使用插件

设置好插件后就可以收集设备的 OAID 了。为此,请在启用 Adjust SDK 前调用 AdjustOaid.readOaid(applicationContext) 方法。

AdjustOaid.ReadOaid();
// ...
Adjust.start(config);

如果您想阻止 SDK 读取 OAID,请调用 AdjustOaid.doNotReadOaid() 方法。

AdjustOaid.DoNotReadOaid();