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<string>

（2）获取OAID，通过Callback回调返回值。

getOAID(callback: AsyncCallback<string>): 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<string | undefined> {
  // 向用户请求授权广告跨应用关联访问权限
  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<void> {
    // 获取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

参考：文档中心