1# 广告标识服务
2
3## 获取OAID信息
4
5
6### 场景介绍
7
8开放匿名设备标识符（Open Anonymous Device Identifier, OAID，以下简称OAID）：是一种非永久性设备标识符，基于开放匿名设备标识符，可在保护用户个人数据隐私安全的前提下，向用户提供个性化广告，同时三方监测平台也可以向广告主提供转化归因分析。
9
10媒体App、广告平台、三方监测平台等开发者，可获取设备上的OAID，您可基于OAID进行个性化广告推荐或广告转化归因分析。
11
12OAID是基于华为自有算法生成的32位类UUID（Universally Unique Identifier）标识符，格式为xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
13
14OAID的特性：
15- OAID是设备级标识符，同一台设备上不同的App获取到的OAID值一样。
16- OAID的获取受应用的跨应用关联访问权限开关影响：当应用的跨应用关联访问权限开关开启时，该应用可获取到非全0的有效OAID；当应用的跨应用关联访问权限开关关闭时，该应用仅能获取到全0的OAID。
17- 同一台设备上首个应用开启应用跨应用关联访问权限开关时，会首次生成OAID。
18
19OAID会在下述场景中发生变化：
20- 用户恢复手机出厂设置。
21- 用户操作重置OAID。
22
23### 接口说明
24
25| 接口名 | 描述 |
26| -------- | -------- |
27| <!--Del-->[<!--DelEnd-->getOAID<!--Del-->](../../reference/apis-ads-kit/js-apis-oaid.md#identifiergetoaid)<!--DelEnd-->(): Promise&lt;string&gt; | 获取OAID，通过Promise异步返回结果。 |
28| <!--Del-->[<!--DelEnd-->getOAID<!--Del-->](../../reference/apis-ads-kit/js-apis-oaid.md#identifiergetoaid-1)<!--DelEnd-->(callback:&nbsp;AsyncCallback&lt;string&gt;):&nbsp; void | 获取OAID，通过Callback回调返回值。 |
29
30> **说明：**
31> 如调用getOAID接口需要申请ohos.permission.APP_TRACKING_CONSENT权限，并获取用户授权。存在如下三种情况：<br/>
32> 1.如应用已配置ohos.permission.APP_TRACKING_CONSENT权限，且跨应用关联访问权限为“允许”，并返回OAID。<br/>
33> 2.如应用已配置ohos.permission.APP_TRACKING_CONSENT权限，且跨应用关联访问权限为“禁止”，则返回00000000-0000-0000-0000-000000000000。<br/>
34> 3.如应用未配置ohos.permission.APP_TRACKING_CONSENT权限，则返回00000000-0000-0000-0000-000000000000。
35
36
37### 开发步骤
381. 在模块的module.json5文件中，申请广告跨应用关联访问权限[ohos.permission.APP_TRACKING_CONSENT](../../security/AccessToken/permissions-for-all-user.md#ohospermissionapp_tracking_consent)，该权限为user_grant权限，当申请的权限为user_grant权限时，reason，abilities标签必填，配置方式参见[requestPermissions标签说明](../../security/AccessToken/declare-permissions.md#在配置文件中声明权限)，示例代码如下所示：
39   ```ts
40   {
41     "module": {
42       "requestPermissions": [
43         {
44           "name": "ohos.permission.APP_TRACKING_CONSENT",
45           "reason": "$string:reason",
46           "usedScene": {
47             "abilities": [
48               "EntryFormAbility"
49             ],
50             "when": "inuse"
51           }
52         }
53       ]
54     }
55   }
56   ```
57
582. 应用在需要获取OAID信息时，应通过调用requestPermissionFromUser接口获取对应权限。其中context的获取方式参见[各类Context的获取方式](../../application-models/application-context-stage.md)。示例代码如下所示：
59   ```ts
60   import { identifier } from '@kit.AdsKit';
61   import { abilityAccessCtrl, common } from '@kit.AbilityKit';
62   import { hilog } from '@kit.PerformanceAnalysisKit';
63   import { BusinessError } from '@kit.BasicServicesKit';
64
65   function requestOAIDTrackingConsentPermissions(context: common.Context): void {
66     // 进入页面时，向用户请求授权广告跨应用关联访问权限
67     const atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
68     try {
69       atManager.requestPermissionsFromUser(context, ["ohos.permission.APP_TRACKING_CONSENT"]).then((data) => {
70         if (data.authResults[0] == 0) {
71           hilog.info(0x0000, 'testTag', '%{public}s', 'succeeded in requesting permission');
72           identifier.getOAID((err: BusinessError, data: string) => {
73			 if (err.code) {
74			   hilog.error(0x0000, 'testTag', '%{public}s', `get oaid failed, error: ${err.code} ${err.message}`);
75			 } else {
76			   const oaid: string = data;
77			   hilog.info(0x0000, 'testTag', '%{public}s', `succeeded in getting oaid by callback , oaid: ${oaid}`);
78			 }
79           });
80         } else {
81           hilog.error(0x0000, 'testTag', '%{public}s', 'user rejected');
82         }
83       }).catch((err: BusinessError) => {
84         hilog.error(0x0000, 'testTag', '%{public}s', `request permission failed, error: ${err.code} ${err.message}`);
85       })
86     } catch (err) {
87       hilog.error(0x0000, 'testTag', '%{public}s', `catch err->${err.code}, ${err.message}`);
88     }
89   }
90   ```
91