简介

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

OAID开放能力

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

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

您将建立什么

在这个Codelab中,您将学习App接入HUAWEI Ads生态系统。

您将会学到什么

硬件要求

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

软件要求

华为Android终端设备中HMS Core版本在2.6.2及以上。
查看方法:设备上 设置-> 应用 –>应用管理 搜索HMS Core

下载OAID-Initial工程。

源码下载

使用Android Studio打开OAID-Initial工程。

1、集成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.** { *; }

2、调用getAdvertisingIdInfo静态方法获取OAID信息
创建子线程,并调用静态的AdvertisingIdClient.getAdvertisingIdInfo(mContext)方法获取OAID信息,不要在主线程中调用该方法,代码示例如下:
OaidSdkUtil.java

public static void getOaid(Context context, OaidCallback callback) { if (null == context || null == callback) { Log.e(TAG, "invalid input param"); return; } try { 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并学到了:

您可以阅读下面链接,了解更多相关的信息。

相关文档

您可以点击下方按钮下载源码。

源码下载

已复制代码