广告服务（OAID）

简介

支撑您在华为设备上进行广告流量变现，提供广告标识符能力方便您进行个性化广告投放。

广告标识符（OAID）
广告标识符（OAID）是一种非永久性设备标识符。使用OAID可在保护用户个人数据隐私安全的前提下，向用户提供个性化广告。
限制个性化广告
您可通过华为开放的API，获取广告标识符以及"限制广告跟踪"开关状态。
如果"限制广告跟踪"开关状态为关闭，您可基于广告标识符进行广告跟踪和个性化广告推荐以提升广告精准性。
如果用户设置"限制广告跟踪"开关为打开，开发者应用和广告商不能使用OAID来向用户推送个性化广告，但仍可以推送非个性化的广告。
隐私保护
用户可在系统"设置 > 隐私 > 广告与隐私"或"设置 > 安全与隐私 > 更多安全设置 > 匿名设备标识"界面中，重置"广告标识符"和启用"限制广告跟踪"，以保护用户个人数据的隐私安全。
用户重置"广告标识符"后，会生成一个新的OAID，您将只能获取到这个新的OAID。

OAID开放能力

您可基于OAID，向用户提供个性化的营销活动或商业广告，提升转化效果，过程如下：

开发者App可调用广告服务（Ads Kit）的接口，获得OAID和"限制广告跟踪"开关状态。
开发者App请求广告时，如果用户未启用"限制广告跟踪"，可根据OAID构建的细分人群，进行个性化的营销活动和商业广告推荐。
开发者App向用户展示广告，当广告被用户点击后，开发者App可从应用市场下载、安装被推广的App。
开发者App在曝光、点击、下载等事件中，携带OAID，用于平台对营销活动或商业广告的效果进行跟踪和分析。

您将建立什么

在这个codelab中，您将学习App如何接入Ads Kit生态系统以及您的App获取广告标识符（OAID）和"限制个性化广告"开关状态。

您将会学到什么

如何集成Ads Kit的OAID开放能力。

硬件要求

支持EMUI 3.0及以上版本的华为手机、华为平板和智慧屏。

软件要求

JDK 1.7及以上
安装Android Studio 3.X及以上
- minSdkVersion 19及以上
- targetSdkVersion 31（推荐）
- compileSdkVersion 31（推荐）
- Gradle 4.1及以上（推荐）
HMS Core（APK）版本在2.6.2及以上
查看方法：设备上点击"设置 > 应用 > 应用管理"搜索HMS Core。

需要的知识点

Android基础开发能力。

点击源码下载OAID-Initial工程。
使用Android Studio打开OAID-Initial工程。

集成SDK

配置Maven仓地址。

Android Studio的代码库配置在Gradle 插件7.0以下版本、7.0版本和7.1及以上版本有所不同。请根据您当前的Gradle 插件版本，选择对应的配置过程。

7.0以下版本

7.0版本

7.1及以上版本

7.0以下版本
i. 打开Android Studio项目级"build.gradle"文件。

ii. 添加Maven代码库。

在"buildscript > repositories"中配置Maven仓地址。
在"allprojects > repositories"中配置Maven仓地址。


buildscript { 
    repositories { 
        google() 
        jcenter() 
        // 配置HUAWEI Ads SDK的Maven仓地址 
        maven {url 'https://developer.huawei.com/repo/'} 
    } 
} 
 
allprojects { 
    repositories { 
        google() 
        jcenter() 
        // 配置HUAWEI Ads SDK的Maven仓地址 
        maven {url 'https://developer.huawei.com/repo/'} 
    } 
}

7.0版本
i. 打开Android Studio项目级"build.gradle"文件。

ii. 添加Maven代码库。

在"buildscript > repositories"中配置Maven仓地址。


buildscript { 
    repositories { 
        google() 
        jcenter() 
        // 配置HUAWEI Ads SDK的Maven仓地址 
        maven {url 'https://developer.huawei.com/repo/'} 
    } 
}

iii. 打开项目级"settings.gradle"文件，配置Maven仓地址。


dependencyResolutionManagement { 
    ... 
    repositories { 
        google() 
        jcenter()  
        // 配置HUAWEI Ads SDK的Maven仓地址 
        maven {url 'https://developer.huawei.com/repo/'} 
    } 
}

7.1及以上版本
打开项目级"settings.gradle"文件，配置Maven仓地址。


pluginManagement { 
    repositories { 
        gradlePluginPortal() 
        google() 
        mavenCentral() 
        // 配置HUAWEI Ads SDK的Maven仓地址 
        maven { url 'https://developer.huawei.com/repo/' } 
    } 
} 
dependencyResolutionManagement { 
    ... 
    repositories { 
        google() 
        mavenCentral() 
        // 配置HUAWEI Ads SDK的Maven仓地址 
        maven { url 'https://developer.huawei.com/repo/' } 
    } 
}

配置依赖。
在应用级的"build.gradle"文件中添加编译依赖，并将{version}替换为实际的HUAWEI Ads SDK版本号，请参见版本更新说明。
```
dependencies { 
    implementation 'com.huawei.hms:ads-identifier:{version}' 
}
```
同步修改的文件。

在"app/proguard-rules.pro"文件中添加如下两行代码，配置混淆脚本。



-keep class com.huawei.hms.ads.** { *; }
-keep interface com.huawei.hms.ads.** { *; }

调用getAdvertisingIdInfo静态方法获取OAID信息

创建子线程，并调用静态的AdvertisingIdClient.getAdvertisingIdInfo(mContext)方法获取OAID信息，请勿在主线程中调用该方法，代码示例如下：


public static void getOaid(Context context, OaidCallback callback) { 
    if (null == context || null == callback) { 
        Log.e(TAG, "invalid input param"); 
        return; 
    } 
    try { 
        // 获取OAID信息，请勿在主线程中调用该方法 
        AdvertisingIdClient.Info info = AdvertisingIdClient.getAdvertisingIdInfo(context); 
        if (null != info) { 
            callback.onSuccess(info.getId(), info.isLimitAdTrackingEnabled()); 
        } else { 
            callback.onFail("oaid is null"); 
        } 
    } catch (IOException e) { 
        Log.e(TAG, "getAdvertisingIdInfo IOException"); 
        callback.onFail("getAdvertisingIdInfo IOException"); 
    } 
}

将OAID-Initial工程编译生成APK文件，并将APK文件安装到设备。App运行后用户界面显示如下。点击"OAID Sample"，即可在右图查看结果。

祝贺您，您已经成功完成了codelab并学到了：
如何集成Ads Kit的OAID开放能力。

您可以阅读相关文档，了解更多相关的信息。
您还可以点击下载源码。

Code copied