20、鸿蒙学习——OAID、AAID、ODID

1、OAID

开放匿名设备标识符((Open Anonymous Device Identifier),是一种非永久性设备标识符,基于开放匿名设备标识符,可在保护用户个人数据隐私安全的前提下,向用户提供个性化广告,同时三方检测平台也可向广告主提供转化根因分析。OAID具有以下特性:

OAID是设备级标识符,同一台设备上不同的App获取到的OAID值一致OAID的获取受应用的跟踪开关影响:当应用的跟踪开关开启时,该应用可获取到非全0的有效OAID;当应用的跟踪开关关闭时,该应用仅能获取到全0的OAID。同一台设备上首个应用开启应用跟踪开关时,会首次生成OAID。

OAID是基于华为自有算法生成的32位类UUID(Universally Unique Identifier)标识符,格式为xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

OAID会在下述场景中发生变化:

用户恢复手机出厂设置用户操作重置OAID。

接口说明

(1)获取OAID,通过Promise异步返回结果。

getOAID(): Promise

(2)获取OAID,通过Callback回调返回值。

getOAID(callback: AsyncCallback): void

说明: 如调用getOAID接口需要申请ohos.permission.APP_TRACKING_CONSENT权限,且“要求应用请求关联”保持关闭状态。存在如下三种情况:

(1)如应用已配置ohos.permission.APP_TRACKING_CONSENT权限,且“跨应用关联访问权限”为“允许”,则返回OAID。

(2)如应用已配置ohos.permission.APP_TRACKING_CONSENT权限,且“跨应用关联访问权限”为“禁止”,则返回00000000-0000-0000-0000-000000000000。

(3)如应用未配置ohos.permission.APP_TRACKING_CONSENT权限,则返回00000000-0000-0000-0000-000000000000。

获取OAID

(1)在模块的module.json5文件中,申请广告跟踪权限 ohos.permission.APP_TRACKING_CONSENT,该权限为user_grant权限,当申请的权限为user_grant时,reason,abilities标签必填,示例代码如下:

{

"module": {

"requestPermissions": [

{

"name": "ohos.permission.APP_TRACKING_CONSENT",

"reason": "$string:reason",

"usedScene": {

"abilities": [

"EntryFormAbility"

],

"when": "inuse"

}

}

]

}

}

(2)应用在需要获取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;

}

2、AAID

应用匿名标识符,标识运行在移动智能终端设备上的应用实例,只有该应用实例才能访问该标识,它只存在于应用的安装期,总长度32位。与无法重置的设备级硬件ID相比,AAID具有更好的隐私权属性。AAID具有以下特性:

匿名化、无隐私风险:AAID和已有的任何标识符都不关联,并且每个应用只能访问自己的AAID。同一个设备上,同一个开发者的多个应用,AAID取值不同。同一个设备上,不同开发者的应用,AAID取值不同。不同设备上,同一个开发者的应用,AAID取值不同。不同设备上,不同开发者的应用,AAID取值不同。

获取AAID

(1)导入AAID模块机相关公共模块

import { AAID } from '@kit.PushKit';

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';

import { BusinessError } from '@kit.BasicServicesKit';

import { hilog } from '@kit.PerformanceAnalysisKit';

(2)调用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);

}

}

}

3、ODID

开发者匿名设备标识符,它主要用于开放给开发者的设备标识,同一个设备上运行的同一个开发者的应用,ODID相同。帮助开发者更好地理解用户在不同应用间的行为,从而提供更个性化的服务和推荐。ODID具有以下特性:

同一设备上运行的同一个开发者的应用,ODID相同。同一设备上不同开发者的应用,ODID不同。不同设备上同一个开发者的应用,ODID不同。不同设备上不同开发者的应用,ODID不同。

注意:ODID会在以下场景重新生成:

手机恢复出厂设置。同一设备上同一个开发者(developerId相同)的应用全部卸载后重新安装时。

ODID生成规则:根据签名信息里developerId解析出的groupId生成,developerId规则为groupId.developerId,若无groupId则取整个develperId作为groupId。

同一个设备上运行的同一个开发者(developerId相同)的应用,ODID相同。

同一个设备上不同开发者(developerId不同)的应用,ODID不同。

不同设备上同一个开发者(developerId相同)的应用,ODID不同。

不同设备上不同开发者(developerId不同)的应用,ODID不同。

说明:数据长度为37字节。示例:1234a567-XXXX-XXXX-XXXX-XXXXXXXXXXXX

import { deviceInfo } from '@kit.BasicServicesKit';

static getODID(): string {

return deviceInfo.ODID

}

4、UDID

设备Udid

说明:数据长度为65字节。可作为设备唯一识别码。

需要权限:ohos.permission.sec.ACCESS_UDID(该权限只允许系统应用及企业定制应用申请)

示例:9D6AABD147XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXE5536412

参考:文档中心


第三方编辑器有哪些?10款高效工具助你轻松创作!
奶茶超人