简介

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

OAID开放能力

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

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

您将建立什么

在这个Codelab中,您将学习App如何接入HUAWEI Ads生态系统以及您的APP获取广告标识符(OAID)和"限制个性化广告"开关状态。

您将会学到什么

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

硬件要求

华为Android终端设备(手机、平板)。

软件要求

需要的知识点

Android基础开发能力。

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

集成SDK

  1. 配置HUAWEI Ads SDK的Maven仓地址。
    打开Android Studio项目级"build.gradle"文件,在"allprojects > repositories"里面配置SDK的Maven仓地址。
    allprojects { repositories { google() jcenter() maven { url 'https://developer.huawei.com/repo/' } } }
  2. 配置依赖。
    打开子工程"app"下的"build.gradle"文件,在"dependencies"新增SDK的依赖,并将{version}替换为实际的HUAWEI Ads SDK版本号,请参见版本更新说明
    dependencies { implementation 'com.huawei.hms:ads-identifier:{version}' }
  3. 同步修改的文件。
  4. 在"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.onSuccuss(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并学到了:
如何集成HUAWEI Ads的OAID开放能力。

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

Code copied