# 广告标识服务Sample

### 介绍

本示例展示了如何通过广告标识服务部件提供的接口获取开放匿名设备标识符以及重置开放匿名设备标识符

### 效果预览
| 获取OAID成功页面                                           | 获取OAID失败页面                                              |
|------------------------------------------------------|---------------------------------------------------------|
| <img src="screenshots/getOAIDdOK.png" width="270" /> | <img src="screenshots/getOAIDFailed.png" width="270" /> |


概念说明：

- 开放匿名设备标识符

  开放匿名设备标识符（Open Anonymous Device Identifier, OAID，以下简称OAID）：是一种非永久性设备标识符，基于开放匿名设备标识符，可在保护用户个人数据隐私安全的前提下，向用户提供个性化广告，同时三方监测平台也可以向广告主提供转化归因分析。

使用说明：

1.在设置应用中将跨应用关联访问权限设置为“允许”。

2.点击“通过Promise获取OAID”，上方文本框显示OAID。

3.点击“通过异步callback获取OAID”，上方文本框显示OAID。

4.重置功能需安装[ResetOAID](/code/BasicFeature/Ads/OAIDSample/lib/ResetOAID-1.0.0.hap)，此外还需将应用包名配置到设备侧系统配置文件中，具体操作步骤如下，点击“重置OAID”，重新获取OAID上方文本框OAID改变。
```
hdc shell mount -o rw,remount /
hdc file recv etc/advertising/oaid/oaid_service_config.json
// 修改oaid_service_config.json文件，添加包名
{
    "resetOAIDBundleName": ["com.samples.resetOAID"],
    "providerBundleName": "",
    "providerAbilityName": ""
}
hdc file send oaid_service_config.json etc/advertising/oaid/oaid_service_config.json
```

### 工程目录
```
entry/src/main/ets/
|---entryability
|   |---EntryAbility.ts
|---log
|   |---Logger.ts          // 日志
|---pages
|   |---Index.ets          // 主页面，获取OAID及重置OAID

```

### 具体实现

1.配置Module信息：

- 在module.json5文件中的“requestPermissions”标签中添加需要开的权限，例如应用读取开放匿名设备标识符权限
```
"requestPermissions": [
  {
    "name": "ohos.permission.APP_TRACKING_CONSENT",
    "reason": "$string:reason",
    "usedScene": {
      "abilities": [
        "EntryFormAbility"
      ],
      "when": "inuse"
    }
  }
]

```

2.获取OAID

- 在Index.ets页面中调用广告标识服务部件提供的identifer.getOAID接口

3.重置OAID

- 在Index.ets页面中调用广告标识服务部件提供的identifer.resetOAID接口

### 相关权限

获取OAID功能需要申请广告跟踪权限：
[ohos.permission.APP_TRACKING_CONSENT](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all-user.md#ohospermissionapp_tracking_consent)。

### 依赖

不涉及

### 约束与限制

1.本示例仅支持标准系统上运行。

2.本示例为Stage模型，已适配API10版本SDK，SDK版本号(API Version 10 Release),镜像版本号(4.0 Release)。

3.本工程示例需要使用DevEco Studio 版本号(4.0Release)及以上版本才可编译运行。

### 下载

如需单独下载本工程，执行如下命令：

```shell
git init
git config core.sparsecheckout true
echo code/BasicFeature/Ads/OAIDSample/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master
```