• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 广告标识服务
2
3## 获取OAID信息
4
5
6### 场景介绍
7
8开放匿名设备标识符（Open Anonymous Device Identifier, OAID，以下简称OAID）：是一种非永久性设备标识符，基于开放匿名设备标识符，可在保护用户个人数据隐私安全的前提下，向用户提供个性化广告，同时三方监测平台也可以向广告主提供转化归因分析。
9
10媒体App、广告平台、三方监测平台等开发者，可获取设备上的OAID，您可基于OAID进行个性化广告推荐或广告转化归因分析。
11
12
13### 接口说明
14
15| 接口名 | 描述 |
16| -------- | -------- |
17| [resetOAID()](../../reference/apis/js-apis-oaid.md#identifierresetoaid): void | 重置OAID，此接口为系统接口。 |
18
19
20### 开发步骤
21
221. 在模块的module.json5文件中，申请广告跟踪权限[ohos.permission.APP_TRACKING_CONSENT](../../security/permission-list.md#ohospermissionapp_tracking_consent)。示例代码如下所示：
23   ```
24   {
25     "module": {
26       "requestPermissions": [
27         {
28         "name": "ohos.permission.APP_TRACKING_CONSENT"
29         }
30       ]
31     }
32    }
33   ```
34
35   在应用启动时触发动态授权弹框，向用户请求授权。其中context的获取方式参见[各类Context的获取方式](../../application-models/application-context-stage.md)。示例代码如下所示：
36   ```
37   import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
38   import { BusinessError } from '@ohos.base';
39   import hilog from '@ohos.hilog';
40   import common from '@ohos.app.ability.common';
41
42   function requestOAIDTrackingConsentPermissions(context: common.Context): void {
43     // 进入页面时触发动态授权弹框，向用户请求授权广告跟踪权限
44     const atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
45      try {
46        atManager.requestPermissionsFromUser(context, ["ohos.permission.APP_TRACKING_CONSENT"]).then((data) => {
47          if (data.authResults[0] == 0) {
48            hilog.info(0x0000, 'testTag', '%{public}s', 'request permission success');
49          } else {
50            hilog.info(0x0000, 'testTag', '%{public}s', 'user rejected');
51          }
52        }).catch((err: BusinessError) => {
53          hilog.error(0x0000, 'testTag', '%{public}s', `request permission failed, error: ${err.code} ${err.message}`);
54        })
55      } catch(err) {
56        hilog.error(0x0000, 'testTag', '%{public}s', `catch err->${err.code}, ${err.message}`);
57      }
58    }
59   ```
60
612. 调用resetOAID方法重置OAID信息，此接口为系统接口。示例代码如下所示：
62   ```
63   import identifier from '@ohos.identifier.oaid';
64   import hilog from '@ohos.hilog';
65
66   // 重置OAID
67   try {
68     identifier.resetOAID();
69   } catch (err) {
70     hilog.error(0x0000, 'testTag', '%{public}s', `reset oaid catch error: ${err.code} ${err.message}`);
71   }
72   ```
73