OAID、AAID和ODID分别是什么,如何获取设备的唯一标识?
OAID
概述
OAID:开放匿名设备标识符,是一种非永久性设备标识符,基于开放匿名设备标识符,可在保护用户个人数据隐私安全的前提下,向用户提供个性化广告,同时三方监测平台也可以向广告主提供转化根因分析。OAID具有以下特性:
特点
OAID是设备级标识符,同一台设备上不同的App获取到的OAID值一样。
OAID的获取受应用的跟踪开关影响:当应用的跟踪开关开启时,该应用可获取到非全0的有效OAID;当应用的跟踪开关关闭时,该应用仅能获取到全0的OAID。
同一台设备上首个应用开启应用跟踪开关时,会首次生成OAID。
获取OAID信息
在模块的module.json5文件中,申请广告跟踪权限ohos.permission.APP_TRACKING_CONSENT,该权限为user_grant权限,当申请的权限为user_grant权限时,reason,abilities标签必填,配置方式参见requestPermissions标签说明,示例代码如下所示:
{
"module": {
"requestPermissions": [
{
"name": "ohos.permission.APP_TRACKING_CONSENT",
"reason": "$string:reason",
"usedScene": {
"abilities": [
"EntryFormAbility"
],
"when": "inuse"
}
}
]
}
}
应用在需要获取OAID信息时,应通过调用requestPermissionsFromUser接口获取对应权限。注意:其中context的获取方式参见各类Context的获取方式。示例代码如下所示:
import { abilityAccessCtrl, PermissionRequestResult } from '@kit.AbilityKit';
import { identifier } from '@kit.AdsKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
async function requestOAID(context: Context): Promise
// 向用户请求授权广告跨应用关联访问权限
let isPermissionGranted: boolean = false;
try {
const atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
const result: PermissionRequestResult =
await atManager.requestPermissionsFromUser(context, ['ohos.permission.APP_TRACKING_CONSENT']);
isPermissionGranted = result.authResults[0] === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED;
} catch (err) {
hilog.error(0x0000, 'testTag', `Failed to request permission. Code is ${err.code}, message is ${err.message}`);
}
if (isPermissionGranted) {
hilog.info(0x0000, 'testTag', 'Succeeded in requesting permission');
try {
const oaid = await identifier.getOAID();
hilog.info(0x0000, 'testTag', 'Succeeded in getting OAID');
return oaid;
} catch (err) {
hilog.error(0x0000, 'testTag', `Failed to get OAID. Code is ${err.code}, message is ${err.message}`);
}
} else {
hilog.error(0x0000, 'testTag', 'Failed to request permission. User rejected');
}
return undefined;
}
AAID
概述
AAID:应用匿名标识符,标识运行在移动智能终端设备上的应用实例,只有该应用实例才能访问该标识符,它只存在于应用的安装期,总长度32位。与无法重置的设备级硬件ID相比,AAID具有更好的隐私权属性。AAID具有以下特性:
特点
匿名化、无隐私风险:AAID和已有的任何标识符都不关联,并且每个应用只能访问自己的AAID。
同一个设备上,同一个开发者的多个应用,AAID取值不同。
同一个设备上,不同开发者的应用,AAID取值不同。
不同设备上,同一个开发者的应用,AAID取值不同。
不同设备上,不同开发者的应用,AAID取值不同
获取AAID
导入AAID模块及相关公共模块。
import { AAID } from '@kit.PushKit';
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
调用AAID.getAAID()方法获取AAID信息。
export default class EntryAbility extends UIAbility {
// 入参want与launchParam并未使用,为初始化项目时自带参数
async onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): Promise
// 获取AAID
try {
const aaid: string = await AAID.getAAID();
hilog.info(0x0000, 'testTag', 'Succeeded in getting AAID.');
} catch (err) {
let e: BusinessError = err as BusinessError;
hilog.error(0x0000, 'testTag', 'Failed to get AAID: %{public}d %{public}s', e.code, e.message);
}
}
}
ODID
概述
ODID:开发者匿名设备标识符,它主要用于开放给开发者的设备标识,同一设备上运行的同一个开发者的应用,ODID相同。帮助开发者更好地理解用户在不同应用间的行为,从而提供更个性化的服务和推荐。ODID具有以下特性:
特点
同一设备上运行的同一个开发者的应用,ODID相同。
同一个设备上不同开发者的应用,ODID不同。
不同设备上同一个开发者的应用,ODID不同。
不同设备上不同开发者的应用,ODID不同。
如果想获取设备的唯一标识符,可以使用AAID,获取方法参考链接;广告业务场景下则可以使用OAID;开发者基于应用的分析可以用ODID。
ODID值会在以下场景重新生成:手机恢复出厂设置。同一设备上同一个开发者(developerId相同)的应用全部卸载后重新安装时。
ODID生成规则:根据签名信息里developerId解析出的groupId生成,developerId规则为groupId.developerId,若无groupId则取整个developerId作为groupId。同一设备上运行的同一个开发者(developerId相同)的应用,ODID相同。同一个设备上不同开发者(developerId不同)的应用,ODID不同。不同设备上同一个开发者(developerId相同)的应用,ODID不同。不同设备上不同开发者(developerId不同)的应用,ODID不同。说明:数据长度为37字节。示例:1234a567-XXXX-XXXX-XXXX-XXXXXXXXXXXX
获取ODID
let odid: string = deviceInfo.ODID;
// 输出结果:the value of the ODID is :1234a567-XXXX-XXXX-XXXX-XXXXXXXXXXXX
console.info('the value of the deviceInfo odid is :' + odid);
参考链接
获取AAID、广告标识服务、设备信息