OAID 插件集成

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

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

使用此插件前,请确保按照相应平台的入门指南进行操作:

将 OAID 插件添加至您的应用

Maven

安卓

安装独立二进制文件

多平台

将插件作为 Prefab

Unity

将 MSA SDK 添加至您的应用

请注意:
对于华为设备,您无需通过添加 MSA SDK 来读取 OAID 值。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 及更新
v1.1.0及更新v4.28.9 及更新
v2.0.0 及更新v4.33.0 及更新

要启用 OAID 插件从 MSA SDK 读取 OAID,您需要将其加入项目中。为此,请进行下列操作:

  1. 复制 MSA SDK (AAR 文件) 到项目的 libs 目录并设置 dependency。
  2. supplierconfig.json 文件复制到项目的 assets 目录中。

您可以在MSA 官网找到 MSA SDK 和相关详细说明。

将 HMS Core SDK 添加至您的应用

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

  1. 添加华为 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 服务相关的规则和 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) 方法。

Java

安卓

C#

Unity

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

Java

安卓

C#

Unity