harmony 鸿蒙广告标识服务

2023-10-30
浏览 (1039)

广告标识服务

获取OAID信息

场景介绍

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

媒体App、广告平台、三方监测平台等开发者，可获取设备上的OAID，您可基于OAID进行个性化广告推荐或广告转化归因分析。

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

OAID的特性： - OAID是设备级标识符，同一台设备上不同的App获取到的OAID值一样。 - OAID的获取受应用的跨应用关联访问权限开关影响：当应用的跨应用关联访问权限开关开启时，该应用可获取到非全0的有效OAID；当应用的跨应用关联访问权限开关关闭时，该应用仅能获取到全0的OAID。 - 同一台设备上首个应用开启应用跨应用关联访问权限开关时，会首次生成OAID。

OAID会在下述场景中发生变化： - 用户恢复手机出厂设置。 - 用户操作重置OAID。

接口说明

接口名	描述
getOAID(): Promise<string>	获取OAID，通过Promise异步返回结果。
getOAID(callback: AsyncCallback<string>):  void	获取OAID，通过Callback回调返回值。

说明： 如调用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。

开发步骤

在模块的module.json5文件中，申请广告跨应用关联访问权限ohos.permission.APP_TRACKING_CONSENT，该权限为user_grant权限，当申请的权限为user_grant权限时，reason，abilities标签必填，配置方式参见requestPermissions标签说明，示例代码如下所示：
```
{
 "module": {
   "requestPermissions": [
     {
       "name": "ohos.permission.APP_TRACKING_CONSENT",
       "reason": "$string:reason",
       "usedScene": {
         "abilities": [
           "EntryFormAbility"
         ],
         "when": "inuse"
       }
     }
   ]
 }
}
```
应用在需要获取OAID信息时，应通过调用requestPermissionFromUser接口获取对应权限。其中context的获取方式参见各类Context的获取方式。示例代码如下所示： “`ts import { identifier } from ‘@kit.AdsKit’; import { abilityAccessCtrl, common } from ‘@kit.AbilityKit’; import { hilog } from ‘@kit.PerformanceAnalysisKit’; import { BusinessError } from ‘@kit.BasicServicesKit’;

你可能感兴趣的鸿蒙文章

harmony 鸿蒙重置OAID信息（仅对系统应用开放）

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/3933b3a19785412cbdf5ea6327c84d5a