OAID 插件集成
匿名设备标识符 (OAID) 是针对安装设备的一种唯一标识符。中国移动安全联盟 (MSA) 推荐所有中国生产的设备提供 OAID。在 Google Play 服务不适用的市场中,您可以使用 OAID 对安卓设备进行归因和跟踪。
OAID 插件提供设备的 OAID。SDK 会继续使用 OAID 和其他标识符。对于所有使用 MSA SDK 的设备或使用华为移动服务 (HMS) Core SDK 的华为设备,OAID 均可读取。
使用此插件前,请确保按照相应平台的入门指南进行操作:
将 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,您需要将其加入项目中。为此,请进行下列操作:
- 复制 MSA SDK (AAR 文件) 到项目的
libs
目录并设置 dependency。 - 将
supplierconfig.json
文件复制到项目的assets
目录中。
您可以在MSA 官网找到 MSA SDK 和相关详细说明。
将 HMS Core SDK 添加至您的应用
您可以使用 HMS Core SDK 来访问华为设备的 OAID。要启用 Adjust OAID 插件并从 HMS Core SDK读取值,请按如下方式更新您的 build.gradle
:
添加华为 maven 库。
repositories { maven { url "https://developer.huawei.com/repo/" } }
添加 HMS Core SDK。
dependencies { implementation 'com.huawei.hms:ads-identifier:3.4.62.300' }
ProGuard 设置
如果您的应用不是针对 Google Play 商店,则无需添加入门指南中的所有规则。您可以移除于 Google Play 服务相关的规则和 install referrer 库,只需保留适用于 Adjust SDK 的规则。
-keep public class com.adjust.sdk.**{ *; }
如需添加 MSA SDK AAR 作为依赖,请添加以下规则:
-keep class com.bun.miitmdid.core.**{ *; }
使用插件
设置好插件后就可以收集设备的 OAID 了。为此,请在启用 Adjust SDK 前调用 AdjustOaid.readOaid(applicationContext)
方法。
如果您想阻止 SDK 读取 OAID,请调用 AdjustOaid.doNotReadOaid()
方法。