什么是OAID、AAID、VAID
OAID
OAID是"Android ID"(安卓ID)的一种替代方案,其全称为"Open Anonymous Identifier"(开放匿名标识符)。
因传统的移动终端设备标识如国际移动设备识别码(IMEI)等已被部分国家认定为用户隐私的一部分,并存在被篡改和冒用的风险,所以在Android 10及后续版本中非厂商系统应用将无法获取IMEI、MAC等设备信息。无法获取IMEI会在用户行为统计过程中对设备识别产生一定影响。
移动安全联盟针对该问题联合国内手机厂商推出补充设备标准体系方案,选择OAID字段作为IMEI等的替代字段。OAID字段是由中国信通院联合华为、小米、OPPO、VIVO等厂商共同推出的设备识别字段,具有一定的权威性,可满足用户行为统计的使用场景。
区别
设备唯一标识符(UDID):设备唯一硬件标识,设备生产时根据特定的硬件 信息生成,可用于设备的生产环境及合法性校验。不对第三方应用提供获取接 口,无法通过 SDK 获取。
匿名设备标识符(OAID):可以连接所有应用数据的标识符,移动智能终端 系统首次启动后立即生成,可用于广告业务。可以通过 SDK 获取到接口状态(重 置、关闭)、ID 值。
开发者匿名设备标识符(VAID):用于开放给开发者的设备标识符,可在应用安装时产生,可用于同一开发者不同应用之间的推荐。可以通过 SDK 获取到 ID 值。
应用匿名设备标识符(AAID):第三方应用获取的匿名设备标识,可在应用安装时产生,可用于用户统计等。可以通过 SDK 获取到 ID值。
如何获取
官方SDK接入
SDK获取
移动安全联盟官网:http://www.msa-alliance.cn/
注意:但是注册需要企业账号,个人开发者无法注册使用,所以测试的时候在网上找了其他人提供的已经下载好的官方SDK。
百度云盘地址:https://pan.baidu.com/s/1sVzBD_3mTXD_oqyu5I2VtQ 提取码:we54
官方文档:
见附件。
配置和调用
-
把 oaid_sdk_x.x.x.aar 拷贝到项的 libs 目录,并设置依赖,其中 x.x.x 代表版本号
-
将 supplierconfig.json 拷贝到项目 assets 目录下
appid 需要移动互联网应用开发者根据应用使用需求到不同终端厂商的应用 商城申请,具体需咨询相关厂商,不需要填写其他第三方应用商店的 appid。 appid 只与 VAID 的获取有关,用于判断是否为同一开发者,如不需获取 vaid 可 不填写。目前只需设置 vivo 的 appid。(我们本次只需要获取OAID,所以不需要上架,也不需要appid)
配置文件中部分设备如果不配置厂商会无法获取,部分设备如小米即使配置文件中没有,也不影响获取,所以我们对接的时候,为了保险起见,配置文件中尽可能全一些。【 官方文档中说配置文件不用修改,只需填写对应 appid,并放到 assets 目录下即可 】 -
设置依赖
-
设置gradle编译选项,开发者可以根据自己对平台的选择进行合理配置(测试的时候不配置也没什么问题)
ndk { abiFilters ‘armeabi-v7a’,‘x86’,‘arm64-v8a’,‘x86_64’,‘armeabi’ }
代码实现
public class MainActivity extends AppCompatActivity implements IIdentifierListener{
private TextView tvContent;
String oaid;
String vaid;
String aaid;
@SuppressLint("MissingInflatedId")
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
tvContent = findViewById(R.id.tv);
MdidSdkHelper.InitSdk(getApplicationContext(), true, this);
//结果是异步返回的,使用时为空的话可以先休眠几秒
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
e.printStackTrace();
}
System.out.println("OAID: "+oaid);
System.out.println("VAID: "+vaid);
System.out.println("AAID: "+aaid);
}
@Override
public void OnSupport(boolean b, IdSupplier idSupplier) {
if(idSupplier==null) {
return;
}
oaid=idSupplier.getOAID();
vaid=idSupplier.getVAID();
aaid=idSupplier.getAAID();
StringBuilder builder=new StringBuilder();
builder.append("support: ").append(idSupplier.isSupported()?"true":"false").append("\n");
builder.append("OAID: ").append(oaid).append("\n");
builder.append("VAID: ").append(vaid).append("\n");
builder.append("AAID: ").append(aaid).append("\n");
String idstext=builder.toString();
Log.d("SdkDemo: ", idstext);
onIdsAvalid(idstext);
}
public void onIdsAvalid(@NonNull final String ids) {
runOnUiThread(new Runnable() {
@Override
public void run() {
tvContent.setText(ids);
}
});
}
}
效果
三方实现接入
接入指引
github地址:https://github.com/gzu-liyujiang/Android_CN_OAID
文档已经写的特别详细了,但是还是有一些地方需要注意一下:
dependencies {
implementation('com.github.gzu-liyujiang:Android_CN_OAID:最新版本号') {
// 如果使用了移动安全联盟SDK,共存的话需排除掉本项目依赖的华为/荣耀官方广告标识服务SDK,因为移动安全联盟SDK也依赖了华为/荣耀的SDK
// 如果华为官方广告标识服务SDK下载失败或编译报错的话,可考虑在 build.gradle 中增加以下配置:
// repositories { maven { url 'https://developer.huawei.com/repo' } }
// runtimeOnly "com.huawei.hms:ads-identifier:3.4.62.300"
exclude group: 'com.huawei.hms', module: 'ads-identifier'
// 荣耀官方广告标识服务SDK同理:
// repositories { maven { url 'https://developer.hihonor.com/repo' } }
// runtimeOnly "com.hihonor.mcs:ads-identifier:1.0.2.301"
exclude group: 'com.hihonor.mcs', module: 'ads-identifier'
}
}
在这里,如果在kotlin的dsl中应该这么写exclude group:
implementation ("com.github.gzu-liyujiang:Android_CN_OAID:4.2.9"){
exclude(group = "com.huawei.hms', module: 'ads-identifier")
exclude(group = "'com.hihonor.mcs', module: 'ads-identifier")
}
代码实现
publicclassMainActivityextendsAppCompatActivity{
privateTextViewtextViewOAID;
@SuppressLint("MissingInflatedId")
@Override
protectedvoidonCreate(BundlesavedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
textViewOAID=findViewById(R.id.textViewOAID);
//DeviceIdentifier.register(this.getApplication());
//获取IMEI,只支持Android10之前的系统,需要READ_PHONE_STATE权限,可能为空
DeviceIdentifier.getIMEI(this);
//获取安卓ID,可能为空
DeviceIdentifier.getAndroidID(this);
//获取数字版权管理ID,可能为空。很鸡肋,在某些手机上还可能造成卡死或闪退,自4.2.7版本后已弃用
DeviceIdentifier.getWidevineID();
//获取伪造ID,根据硬件信息生成,不会为空,有大概率会重复
DeviceIdentifier.getPseudoID();
//获取GUID,随机生成,不会为空
DeviceIdentifier.getGUID(this);
//是否支持OAID/AAID
DeviceID.supportedOAID(this);
//获取OAID/AAID,同步调用
DeviceIdentifier.getOAID(this);
//获取OAID/AAID,异步回调
DeviceID.getOAID(this,newIGetter(){
@Override
publicvoidonOAIDGetComplete(Stringresult){
//不同厂商的OAID/AAID格式是不一样的,可进行MD5、SHA1之类的哈希运算统一
Log.d("oaiddemo","获取成功:"+result);
textViewOAID.setText("OAIDValue:"+result);//更新TextView文本
}
@Override
publicvoidonOAIDGetError(Exceptionerror){
//获取OAID/AAID失败
Log.d("oaiddemo","获取失败:");
textViewOAID.setText("OAID获取失败");//更新TextView文本,表示获取失败
}
});
}
}
效果
对比官方和三方的结果,获取到的OAID,同一台设备是一致的。
写在最后
感谢参考的几篇文档:
https://blog.csdn.net/Myfittinglife/article/details/121520111
https://blog.csdn.net/mingtiannihao0522/article/details/104630967
https://juejin.cn/post/6924191966146068493