Android开发中匿名设备标识符OAID使用及初始化

简介

随着隐私保护意识的提高，设备标识符的获取变得越来越受到关注。2021年12月1日起，应用商店将禁止在应用中获取IMEI等设备标识符，而是推荐使用集成了匿名设备标识符OAID的SDK。

本文将详细讲解OAID的使用及初始化方法。

OAID的获取

1. 集成SDK

由于OAID是从Android Q（Android 10）开始引入的，因此需要使用相应的SDK。目前市面上常用的SDK有华为应用的HMS Core和广告ID联盟（CAID）提供的SDK。

其中，HMS Core SDK 集成方式详见华为官网文档；广告ID联盟SDK 集成方式详见广告ID联盟官网文档。

2. 初始化SDK

在集成完SDK后，需要对SDK进行初始化，以获取OAID。

HMS Core SDK 的初始化代码示例：

AGConnectOAID oaidClient = AGConnectOAID.getInstance();
oaidClient.getOAID().addOnSuccessListener(new OnSuccessListener<String>() {
    @Override
    public void onSuccess(String oaid) {
        // 获取OAID成功，可将其用于后续的数据统计或广告投放等操作
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
        // 获取OAID失败
    }
});

广告ID联盟SDK 的初始化代码示例：

CaidCAIDHelper.initOAID(mContext, new IOaidCallback() {
    @Override
    public void onSuccuss(String oaid) {
        // 获取OAID成功，可将其用于后续的数据统计或广告投放等操作
    }

    @Override
    public void onFail(String errMsg) {
        // 获取OAID失败
    }
});

OAID的使用

获取OAID后，便可以将其用于数据统计或广告投放等操作。下面以百度统计和穿山甲广告SDK为例，介绍OAID的使用方法。

1. 百度统计SDK

在使用百度统计SDK时，需要将OAID作为统计参数传入SDK中。

/*
 * 以下为示例代码
 */

// 初始化SDK
StatService.autoTrace(this.getApplicationContext(), true);

// 将OAID传入SDK
HashMap<String, String> trackParams = new HashMap<String, String>();
trackParams.put("oaid", oaid);
StatService.trackCustomKVEvent(this, "event_id", trackParams);

2. 穿山甲广告SDK

在使用穿山甲广告SDK时，获取SDK中的AdSlot实例后，将OAID作为其extras属性中的kv值传入即可。

/*
 * 以下为示例代码
 */

// 创建AdSlot实例，可根据需求自行定制
AdSlot adSlot = new AdSlot.Builder()
        .setCodeId("codeid")
        .setAdCount(1)
        .setSupportDeepLink(true)
        .setImageAcceptedSize(640, 320)
        .build();

// 将OAID作为extras属性中的kv值传入AdSlot实例中
JSONObject jsonObject = new JSONObject();
try {
    jsonObject.put("oaid", oaid);
} catch (JSONException e) {
    e.printStackTrace();
}
adSlot.setExt(jsonObject.toString());

// 加载广告
TTAdManager ttAdManager = TTAdManagerHolder.get();
ttAdManager.createAdNative(this).loadAd(adSlot, new TTAdNative.NativeAdListener() {
    @Override
    public void onError(int code, String message) {
        // 广告拉取失败
    }

    @Override
    public void onNativeAdLoad(List<TTNativeAd> ads) {
        // 广告拉取成功
    }
});

小结

通过本文，我们详细讲解了OAID的获取和使用，希望读者能够对OAID在Android开发中的应用有更清晰的认识。