DU Ad Platform_SDK for Android 接 入 手册 Version: DUAd_SDK_CW1.2.0 DU Ad Platform_SDK for Android 接 入 手册 1. 概述 2. 接 入流程 3. 获取身份 3.1 APP_ID 3.2 广告位 ID 3.3

Transcription

1 DU Ad Platform_SDK for Android 接 入 手册 Version: DUAd_SDK_CW1.2.0 DU Ad Platform_SDK for Android 接 入 手册 1. 概述 2. 接 入流程 3. 获取身份 3.1 APP_ID 3.2 广告位 ID 3.3 Facebook Placement_ID( 可选 ) 3.4 AdMob_ID( 可选 ) 4. 加载与配置 4.1 加载 DU Ad Platform_SDK 压缩包 4.2 配置 AndroidManifest.xml 4.3 混淆代码 5. 初始化 6. 控制 用户信息获取许可状态 6.1 用户信息获取许可状态的设置接 口 6.2 用户信息获取许可状态的获取接 口 7. 获取原 生 广告数据 7.1 构造原 生 广告数据类接 口 7.2 注册 广告数据监听回调接 口 7.3 获取 广告数据接 口 7.4 销毁原 生 广告对象 8. 原 生 广告数据介绍 8.1 构成元素 8.2 数据获取接 口 8.3 AdMob 数据获取接 口 9. 注册原 生 广告 View 监听 10. 原 生 广告 List 使 用 10.1 构造原 生 广告 List 使 用类 10.2 构造 子原 生 广告类 10.3 注册原 生 广告 List 监听接 口 10.4 注册原 生 广告 子类监听接 口 10.5 获取 广告数据接 口 10.6 原 生 广告数据获取 10.7 销毁原 生 广告 List 对象 11. 广告墙使 用 11.1 注册 广告墙 Activity 11.2 设置相关 12. 插屏 广告使 用 12.1 构造插屏 广告对象

2 12.2 注册插屏 广告回调 12.3 使 用插屏 广告 13. 横幅 广告使 用 13.1 构造横幅 广告对象 13.2 注册横幅 广告回调 13.3 设置相关 13.4 添加横幅到布局中 13.5 使 用横幅 广告 1. 概述 本 文档描述如何在安卓应 用中接 入来 自百度开发者平台的 DU Ad Platform_SDK 产品 百度开发者平台可以为应 用提供 广告服务 DU Ad Platform_SDK 是百度开发者平台中 用来提供原 生 广告的 一款产品 DU Ad Platform_SDK 目前 支持 Android2.3 API Level9( 含 ) 以上的系统版本 2. 接 入流程 DU Ad Platform_SDK 的接 入流程如下 : 1. 申请 广告 ID 2. 导 入 DU Ad Platform_SDK 工程包 3. 初始化 DU Ad Platform_SDK 4. 广告接 入 5. 完成接 入 3. 获取身份 本章描述 DU Ad Platform_SDK 接 入过程中需要的四个身份 :APP_ID, 广告位 ID,Facebook Placement_ID,AdMob_ID 3.1 APP_ID 1. 定义 APP_ID 是开发者的应 用在 DAP 广告平台的唯 一标识 2. 获取 方式访问百度开发者平台进 行行申请 3. 代码

3 app_license 3.2 广告位 ID 1. 定义 广告位 ID 是 DAP 开发者平台上 广告所在的 广告位置的标识 开发者可以为 一个应 用创建多个 广告位 2. 获取 方式访问百度开发者平台进 行行申请 3. 代码 pid 3.3 Facebook Placement_ID( 可选 ) 1. 定义 Facebook Placement_ID 是 Facebook 广告所在 广告位置的标识 使 用 DAP 聚合 Facebook 广告时才需要 Facebook Placement_ID 2. 获取 方式访问 Facebook 开发者平台进 行行申请 3. 代码 fbids 3.4 AdMob_ID( 可选 ) 1. 定义 AdMob_ID 是开发者应 用在 AdMob 广告平台的唯 一标识 使 用 DAP 聚合 AdMob 广告时才需要 AdMob_ID 2. 获取 方式访问 AdMob 广告平台进 行行申请 3. 代码 amid 4. 加载与配置 本章描述在安卓应 用中如何加载 DU Ad Platform_SDK 的压缩包, 如何配置 AndroidManifest.xml, 以及根据项 目需要配置混淆代码 请严格按照本章进 行行配置, 否则有可能会出现运 行行异常

4 4.1 加载 DU Ad Platform_SDK 压缩包 1. 下载 DU Ad Platform_SDK 的压缩包 2. 解压 DU Ad Platform_SDK 的压缩包 解压后有两个 子 目录 文件夹, 名称和内容如下 : DUAd_SDK: 该 文件夹存放 DU Ad Platform_SDK 的 aar 包 :DuappsAd-CW-xxx.aar DUAd_SDK_DEMO 该 文件夹存放使 用 DU Ad Platform_SDK 过程中的示例例程序 本 文档中所有接 口都可以在 DUAd_SDK_DEMO 中找到对应的使 用示例例 3. 加载 DU Ad Platform_SDK: Android Studio 导 入 : 拷 贝 SDK aar 包放到你的安卓 工程 文件根 目录的 libs 目录下, 然后配置 build.gradle : repositories { flatdir { dirs 'libs' dependencies { compile filetree(include: ['*.jar'], dir: 'libs') compile(name: 'DuappsAd-CW-xxx-release', ext: 'aar') * 注 : flatdir 指定的位置即为 aar 存放的位置 Eclipse 导 入 : 1. 新建 一个 Eclipse android library. 2. 将 DuappsAd-CW-xxx.aar 后缀改成 zip 解压. 3. 将 classes.jar 拷进 libs 目录下 4. 用解压出的 AndroidManifest.xml 替换新建 Eclipse android library 中的 manifest. 5. 用解压出的 res 文件夹替换新建 Eclipse android library 中的 res 文件夹. 注 : 使 用 DAP 进 行行聚合 Facebook 和 AdMob 广告时需要额外添加对应的依赖 4.2 配置 AndroidManifest.xml 在安卓 工程 目录下, 打开 AndroidManifest.xml, 配置以下内容 : 1. 添加权限 DU Ad Platform_SDK 使 用的最低权限如下 : <uses-permission android:name="android.permission.internet" /> <uses-permission android:name="android.permission.access_network_state" />

5 2. 在 app_license 的 value 中填 入已申请的 APP_ID <application android:name="com.mobula.sample.mobulaapplication" > <meta-data android:name="app_license" android:value="your_app_license" /> <provider android:name="com.duapps.ad.stats.duadcacheprovider" android:authorities="${applicationid.duadcacheprovider" android:exported="false"> </provider> </application> 注 : applicationid 必须与平台注册的应 用包名 一致, 否则将 无法获得 广告 3. 注册 APP 安装 广播监听 请正确添加该监听, 否则会影响您的变现效率 <receiver android:name="com.duapps.ad.base.packageaddreceiver" > <intent-filter> <action android:name="android.intent.action.package_added" /> <data android:scheme="package" /> </intent-filter> </receiver> 4. 使 用 AdMob 广告时需额外添加以下 Activity 不不使 用时不不 用添加 <!--Admob begin--> <activity android:name="com.google.android.gms.ads.adactivity" android:configchanges="keyboard keyboardhidden orientation screenlayo ut uimode screensize smallestscreensize" android:theme="@android:style/theme.translucent" /> 4.3 混淆代码 请务必按如下混淆规则对应 用代码进 行行混淆, 否则有可能会出现运 行行异常 : 1. 将以下类添加到 proguard 配置 :

6 -keep class com.duapps.ad.**{*; -dontwarn com.duapps.ad.** -keep public class * extends android.content.broadcastreceiver -keep public class * extends android.content.contentprovider class * -keepclassmembernames class * *; -keep class com.google.android.gms.common.googleplayservicesutil { public <methods>; -keep class com.google.android.gms.ads.identifier.advertisingidclient { public <methods>; -keep class com.google.android.gms.ads.identifier.advertisingidclient$info { public <methods>; 注 : 混淆 方法参 见 Android 官 方混淆 文档 :${ android-sdk /tools/proguard/ 2. 如接 入 Facebook 广告, 须将以下类添加到 proguard 配置 : -keep class com.facebook.ads.nativead 3. 如接 入 AdMob 广告, 须将以下类添加到 proguard 配置 -keep public class com.google.android.gms.ads.** {public *; 5. 初始化 在完成 DU Ad Platform_SDK 接 入操作之前, 安卓应 用 首先需要对 DU Ad Platform_SDK 做初始化 没有进 行行初始化的 广告位 id 无法拉取 广告 1. 创建 Json 文件, 将 Placement_ID 与 广告位 ID 建 立对应关系 具体格式如下 : { "native": [ { "pid":"your_dap_placement_id", { "pid":"your_dap_placement_id", "fbids": [ "YOUR_FACEBOOK_PLACEMENT_ID" ], "amid":"your_admob_ad_id"

7 ], "list": [ { "pid": "YOUR_DAP_PLACEMENT_ID", "fbids":"your_facebook_placement_id" ], "offerwall": [ { "pid": "YOUR_DAP_PLACEMENT_ID", "fbids":"your_facebook_placement_id" ] 注 : 1. 如果某 广告位不不需要 Facebook 广告, 请将该 广告位对应的 "fbids" 部分删除 如需绑定 FBID, 请确保 Facebook Audience Network 版本不不低于 FB 如果开发者某 广告位不不需要 AdMob 广告, 请将该 广告位对应的 "amid" 部分删除 3. 原 生 广告 List 插屏 应 用墙 横幅 广告暂时不不 支持 AdMob 聚合 横幅 广告暂时不不 支持 Facebook 聚合 4. 如果不不希望通过静态创建 json 文件的 方式进 行行初始化, 可以直接创建符合 json 格式的字符串串并传值 2. 在 application 的 OnCreate() 方法中使 用 DuAdNetwork.init() public static void init(context context,string pidsjson) Context context String pidsjson 说明 ACTIVITY CONTEXT Placement_ID 与 广告位 ID 的对应关系 代码示例例 : public void oncreate() { super.oncreate(); // 初始化 SDK DuAdNetwork.init(this, getconfigjson(getapplicationcontext())); //DuAdNetwork.setLaunchChannel("YOUR_APP_CHANNEL");

8 // 从 assets 中读取 txt private String getconfigjson(context context) { BufferedInputStream bis = null; ByteArrayOutputStream bos = new ByteArrayOutputStream(); try { bis = new BufferedInputStream(context.getAssets().open("json.txt")); byte[] buffer = new byte[4096]; int readlen = -1; while ((readlen = bis.read(buffer)) > 0) { bos.write(buffer, 0, readlen); catch (IOException e) { Log.e("", "IOException :" + e.getmessage()); finally { closequietly(bis); return bos.tostring(); private void closequietly(closeable closeable) { if (closeable == null) { return; try { closeable.close(); catch (IOException e) { // empty 3. 填写投放渠道 用以区分不不同 app 投放渠道的数据, 此接 口可选择使 用, 不不是必需 在 application 的 OnCreate() 方法中使 用 DuAdNetwork.setLaunchChannel() public static void setlaunchchannel (String channelname) String channelname 说明 此接 口可以帮你根据你的 APP 投放渠道, 区分数据 6. 控制 用户信息获取许可状态 此配置为针对 GDPR 做出的修改, 适 用于需要进 行行 用户信息获取许可状态配置的地区, 为可选配置 6.1 用户信息获取许可状态的设置接 口

9 建议在初始化时调 用该接 口 public static void setconsentstatus(context context, boolean consentstatus) Context context boolean consentstatus 说明 ACTIVITY CONTEXT 用户许可状态 true: 获得了了 用户授权时传 入, 可以按正常 方式请求和展示 广告 false: 用户拒绝授权或收回授权时传 入, 广告请求直接返回 4000( 见 7.2 错误码 ) 6.2 用户信息获取许可状态的获取接 口 public static boolean getconsentstatus(context context) 获取当前 用户信息获取许可状态, 允许收集 用户信息则返回 True, 否则返回 False 7. 获取原 生 广告数据 本章描述如何获取 广告数据 包括构造 广告数据类接 口, 填充 广告缓存接 口, 和获取 广告数据接 口三个部分 7.1 构造原 生 广告数据类接 口 步骤如下 : 1. 构造原 生 广告类创建原 生 广告对象必须指定对应的 广告位 ID 不不同的 广告位会获取到不不同的 广告数据 2. 设置 广告缓存个数 广告缓存个数可以设置 1-5 个 推荐不不设置 广告缓存个数 如果不不设置或者设置 无效值, 会使 用默认缓存 :1 个 注 : 此 方法只在通过 DU Ad Platform 聚合其他渠道时 生效 public DuNativeAd (Context context, int pid) public DuNativeAd (Context context, int pid, int cachesize)

10 Context context int pid int cachesize 说明 ACTIVITY CONTEXT 广告位 ID, 该 pid 注册在 Json 的 native 数组中缓存 广告个数 7.2 注册 广告数据监听回调接 口 广告数据获取与点击事件的响应均通过回调接 口返回 此过程与 广告数据获取过程异步, 不不会阻塞开 发者的线程 public void setmobulaadlistener(duadlistener adlistener) DuAdListener adlistener 说明 回调函数返回获取 广告错误, 获取 广告的数据, 广告点击事件 public interface DuAdListener { public void onerror(dunativead ad, AdError error); public void onadloaded(dunativead ad); public void onclick(dunativead ad); 使 用获取数据 方法后,DU Ad Platform_SDK 会在回调函数中通知开发者获取 广告数据的结果 获取 广告成功 DU Ad Platform_SDK 会回调 onadloaded() 方法, 通过 DuNativeAd 的对象开发者可以得到具体的 广告数据内容 获取 广告失败 DU Ad Platform_SDK 会回调 onerror() 方法, 通过 AdError 对象开发者可以得到具体错误信息 获取 广告数据失败的错误码及含义如下 :

11 常量量 错误码 说明 NETWORK_ERROR_CODE 1000 客户端 网络错误 NO_FILL_ERROR_CODE 1001 没有获取到 广告数据 LOAD_TOO_FREQUENTLY_ERROR_CODE 1002 请求接 口过频繁 IMPRESSION_LIMIT_ERROR_CODE 1003 展示超出限制 SERVER_ERROR_CODE 2000 服务器器错误 INTERNAL_ERROR_CODE 2001 服务器器 网络错误 TIME_OUT_CODE 3000 获取 广告数据等待时间超时 UNKNOW_ERROR_CODE 3001 未知错误 NO_USER_CONSENT_ERROR_CODE 4000 用户信息获取未受到许可 获取 广告点击事件 DU Ad Platform_SDK 会回调 onclick() 方法, 通知开发者该 DuNativeAd 的对象的 广告被 点击 7.3 获取 广告数据接 口 开发者可根据 自 己产品的需求, 选择时机获取 广告数据 public void fill() 调 用 fill() 接 口可以提前缓存 广告, 在 load() 广告时可以更更快获取 建议在 广告展示的前置场景调 用该 方法 注 : 广告数据会缓存到客户端内存中, 不不会缓存 广告的图 片数据, 只会缓存图 片的 Url 地址, 缓存数据量量 小 public void load() 异步获取 广告对象数据, 没有缓存时会进 行行 广告请求 建议在使 用 load() 后再次调 用 fill() 接 口进 行行 广告缓存 public DuNativeAd getcachead() 同步获取 广告对象数据 可以循环拿取, 一直到 广告缓存为 0

12 在使 用该接 口展示 广告时, 请进 行行缓存 非空判断, 避免缓存池为空导致空指针 建议在使 用 get() 后再次调 用 fill() 接 口进 行行 广告缓存 public boolean ishascached() 获取当前是否有 广告缓存, 有缓存则返回 True 代码示例例 DuNativeAd nativead = new DuNativeAd(this, PID, CACHESZIE); if (nativead!= null) { nativead.setmobulaadlistener (mlistener); nativead.load(); DuAdListener mlistener = new DuAdListener () public void onerror (DuNativeAd ad, AdError error) { Log.d(TAG, "onerror : " + public void onclick (DuNativeAd ad) { Log.d(TAG, "onclick : click public void onadloaded (final DuNativeAd ad) { Log.d(TAG, "onadloaded : " + ad.gettitle()); ; 7.4 销毁原 生 广告对象 在退出原 生 广告展示界 面时, 建议销毁原 生 广告对象 public void destroy() 8. 原 生 广告数据介绍

13 8. 原 生 广告数据介绍 本章描述 广告数据的构成元素及构成元素的获取接 口 8.1 构成元素 广告数据的构成元素包括图标, 标题,CTA 按钮, 宣传 文案, 评价和宣传图 1. 图标 2. 标题 3. CTA 按钮 4. 宣传 文案 5. 评价 8.2 数据获取接 口 图标获取接 口 public String geticonurl() 返回 广告图标的 Url 地址 标题获取接 口 public String gettitle() 返回标题 文案 广告中必须包含 一个标题 请保留留 至少 20 个字符的空间 用来显示标题, 可以 用省略略号代替超出的 文本 CTA 按钮获取接 口 public String getcalltoaction() 返回 CTA 按钮 文案 广告中必须包含 一个触发按钮 请不不要缩短或改变按钮 文案 按钮 文案的最 大字符 长度个数 :25

14 宣传 文案获取接 口 public String getshortdesc() 返回 广告的宣传 文案 需确保有 72 个字符可以被显示 如果 广告区域不不 足以显示 72 个字符, 建议不不要在 广告中添加宣传 文案, 或者使 用滚动 文本效果, 让全部宣传 文案能够被显示 评级获取接 口 public float getratings() 返回该 广告应 用在 Google Play 上的评级 宣传图获取接 口 public String getimageurl() 返回 广告宣传图的 Url 地址, 当返回值为 NULL 时, 当前 广告数据中不不含宣传图 广告中可以添加宣传图 片, 促进 用户点击 广告的欲望 可以缩放和裁剪宣传图的 一部分, 但请不不要扭曲和改变它 宣传图的 大 小通常是 :796*416 像素 DuAdChoicesView 该 View 是 Facebook 原 生 广告返回的 AdChoices 角标 使 用 Facebook 原 生 广告时必须添加的元素, 非 Facebook 原 生 广告不不 用添加 构造 方法 : public DuAdChoicesView(Context mcontext, DuNativeAd mnativead, boolean isexpand) Context mcontext DuNativeAd mnativead boolean isexpand 说明 ACTIVITY CONTEXT 原 生 广告对象控制 AdChoises 角标是否可扩展, 推荐值为 true 代码示例例 :

15 import com.duapps.ad.duadmediaview; import com.duapps.ad.duadchoicesview; LinearLayout adchoicescontainer = (LinearLayout) findviewbyid(r.id.ad_choices_container); if (mnativead.getadchanneltype() == DuNativeAd.CHANNEL_TYPE_FB) { DuAdChoicesView choicesview = new DuAdChoicesView(getApplicationContext(), mnativead, true); adchoicescontainer.addview(adchoicesview); DuAdMediaView mmediaview = new DuAdMediaView(this); mmediaview.setautoplay(true); mmediaview.setnativead(mnativead.getrealsource()); 8.3 AdMob 数据获取接 口 AdMob 原 生 广告分为两种类型 :AppInstall 类型和 Content 类型 在拿到 广告数据后请先对 广告类型进 行行判断 请在 onadloaded() 回调中调 用该 方法, 具体使 用可参照 demo public int getadchanneltype() if (ad.getadchanneltype() == DuNativeAd.CHANNEL_TYPE_AM_INSTALL) { //AppInstall 类型 广告, 需要动态使 用 Admob 提供的 NativeAppInstallAdView if (lp == null) { lp = new LayoutParams(LayoutParams.WRAP_CONTENT,LayoutParams.WRAP_CONTENT); if (installadview == null) { installadview = new NativeAppInstallAdView(ShowADCardActivity.this); installadview.setheadlineview(titleview); installadview.seticonview(iconview); installadview.setbodyview(descview); installadview.setimageview(bigimgview); installadview.setstarratingview(ratingview); installadview.setcalltoactionview(btnview); installadview.addview(rl, lp); fl.addview(installadview); nativead.registerviewforinteraction(installadview); else if(ad.getadchanneltype() == DuNativeAd.CHANNEL_TYPE_AM_CONTENT){ //Content 类型 广告, 需要动态使 用 AdMob 提供的 NativeContentAdView if (lp == null) { lp = new LayoutParams(LayoutParams.WRAP_CONTENT,LayoutParams.WRAP_CONTENT);

16 if (contentadview == null) { contentadview = new NativeContentAdView(ShowADCardActivity.this); contentadview.setheadlineview(titleview); contentadview.setlogoview(iconview); contentadview.setbodyview(descview); contentadview.setimageview(bigimgview); contentadview.setcalltoactionview(btnview); contentadview.addview(rl, lp); fl.addview(contentadview); nativead.registerviewforinteraction(contentadview); else { // 广告类型是 DuNativeAd.DAP_NORMAL_AD(FB & DU) 时, 请按普通 方式注册 广告 View. fl.addview(rl); nativead.registerviewforinteraction(bigimgcontainer); 9. 注册原 生 广告 View 监听 DU Ad Platform_SDK 会 自动统计 广告的展示和被点击次数, 开发者必须注册 广告可点击区域视图的 监听 public void registerviewforinteraction(view view) public void registerviewforinteraction(view view, List<View> views) 返回值 View view List <View> views 说明 广告内容中可点击的 view 更更细致的 子 view * 注 : 不不建议在多线程使 用此接 口 10. 原 生 广告 List 使 用 建议需要同时展示多条原 生 广告时使 用该 方法 构造原 生 广告 List 使 用类

17 public DuNativeAdsManager(Context context, int pid, int cachesize) Context context int pid int cachesize 说明 ACTIVITY CONTEXT 广告位 ID, 该 pid 注册在 Json 的 List 数组中缓存 广告个数 10.2 构造 子原 生 广告类 public NativeAd() 10.3 注册原 生 广告 List 监听接 口 public void setlistener(adlistarrivallistener adlistener) AdListArrivalListener adlistener 说明 回调函数返回获取 广告错误, 获取 广告的数据 public interface AdListArrivalListener { public void onerror(aderror error); public void onadloaded(list<nativead> mnativead); 使 用获取数据 方法后,DU Ad Platform_SDK 会在回调函数中通知开发者获取 广告数据的结果 获取 广告成功 DU Ad Platform_SDK 会回调 onadloaded() 方法, 通过 List<NativeAd> 的对象开发者可以得到每个 广告对象, 并分别获得对应的 广告元素获取 广告失败 DU Ad Platform_SDK 会回调 onerror() 方法, 通过 AdError 对象开发者可以得到具体错误信息 10.4 注册原 生 广告 子类监听接 口 public void setmobulaadlistener(duaddatacallback mcallback)

18 DuAdDataCallBack mcallback 说明 此接 口可以获得单个 广告点击事件, onadloaded(), onaderror() 已经由 AdListArrivalListener 回调, 在该接 口 无返回 public interface DuAdDataCallBack { public void onerror(aderror error); public void onadloaded(nativead mnativead); public void onadclick(); 获取 广告点击事件 DU Ad Platform_SDK 会回调 onclick() 方法, 通知开发者该 NativeAd 的对象的 广告被点 击 代码示例例 : private NativeAd mnativead; private LinkedList<NativeAd> lists = new LinkedList<NativeAd>(); private DuNativeAdsManager adsmanager = = new DuNativeAdsManager(getApplicationContext(), PID, protected void onresume() { super.onresume(); if (adsmanager!= null) { adsmanager.setlistener(listener); adsmanager.load(); mnativead = lists.get(mpositon); mnativead.setmobulaadlistener(callback); mnativead.registerviewforinteraction(btnview); AdListArrivalListener listener = new AdListArrivalListener() { NativeAd nativead; // 返回 广告 public void onadloaded(list arg0) { for (int i = 0; i < arg0.size(); i++) { // 获取单个 广告对象 nativead = (NativeAd) arg0.get(i); if (!(nativead.equals(null))) { lists.add(nativead);

19 // 返回 public void onaderror(aderror arg0) { Log.d(TAG, "onerror : " + arg0.geterrorcode()); ; DuAdDataCallBack callback = new DuAdDataCallBack() public void onadloaded(nativead data) public void onaderror(aderror error) public void onadclick() { Log.d(TAG, "onclick : click list ad"); ; 10.5 获取 广告数据接 口 public void fill() 开发者可根据 自 己产品的需求, 选择时机使 用填充 广告缓存接 口 调 用 fill() 接 口可以提前缓存 广告, 在 load() 广告时可以更更快展示 建议在 广告展示的前置场景调 用该 方法 注 : 广告数据会缓存到客户端内存中, 不不会缓存 广告的图 片数据, 只会缓存图 片的 Url 地址, 缓存数据量量 小 public void load() 异步获取 广告对象数据, 没有缓存时会进 行行 广告请求 10.6 原 生 广告数据获取 图标获取接 口

20 public String getadiconurl() 返回 广告图标的 Url 地址 标题获取接 口 public String getadtitle() 返回标题 文案 广告中必须包含 一个标题 请保留留 至少 20 个字符的空间 用来显示标题, 可以 用省略略号代替超出的 文本 CTA 按钮获取接 口 public String getadcalltoaction() 返回 CTA 按钮 文案 广告中必须包含 一个触发按钮 请不不要缩短或改变按钮 文案 按钮 文案的最 大字符 长度个数 :25 宣传 文案获取接 口 public String getadbody() 返回 广告的宣传 文案 需确保有 72 个字符可以被显示 如果 广告区域不不 足以显示 72 个字符, 建议不不要在 广告中添加宣传 文案, 或者使 用滚动 文本效果, 让全部宣传 文案能够被显示 评级获取接 口 public float getadstarrating() 返回该 广告应 用在 Google Play 上的评级 宣传图获取接 口 public String getadcoverimageurl() 返回 广告宣传图的 Url 地址, 当返回值为 NULL 时, 当前 广告数据中不不含宣传图 广告中可以添加宣传图 片, 促进 用户点击 广告的欲望 可以缩放和裁剪宣传图的 一部分, 但请不不要扭曲和改变它 宣传图的 大 小通常是 :796*416 像素 DuAdChoicesView 该 View 是 Facebook 原 生 广告返回的 AdChoices 角标 使 用 Facebook 原 生 广告时必须添加的元素, 非 Facebook 原 生 广告不不 用添加 构造 方法 : public DuAdChoicesView(Context mcontext, NativeAd mnativead, boolean isexpand)

21 Context mcontext NativeAd mnativead boolean isexpand 说明 ACTIVITY CONTEXT 原 生 广告对象控制 AdChoises 角标是否可扩展, 推荐值为 true 10.7 销毁原 生 广告 List 对象 在退出原 生 广告展示界 面时, 建议销毁原 生 广告 List 对象 public void destroy() 代码示例例 protected void ondestroy() { super.ondestroy(); adsmanager.setlistener(null); adsmanager.destroy(); 11. 广告墙使 用 广告墙是 一个被封装的列列表 广告

22 11.1 注册 广告墙 Activity 在安卓 工程 目录下, 打开 AndroidManifest.xml, 添加以下 Activity: <activity android:name="com.duapps.ad.offerwall.ui.offerwallact"/> 11.2 设置相关 广告墙 支持设置的如下 : OfferWallAct.KEY_PID DAP 平台申请的 广告位 id, 该 pid 注册在 Json 的 Offerwall 数组中 在 DAP 后台创建该 广告位时, 广告形式必须选择 广告墙, 否则将 无法获取 广告 该属性必须填写 OfferWallAct.KEY_TITLE_ID 标题 文案设置, 支持传 入资源 ID 默认值为 "Featured Apps" 及对应语 言 文本 OfferWallAct.KEY_TAB_BACKGROUND_COLOR 设置 广告墙 Tab 背景 色, 形如 #FFFFFF 默认值为 #EDEDED

23 OfferWallAct. KEY_TAB_INDICATOR_COLOR 设置 Tab 选择指示器器的颜 色及被选中的 Tab 的 文字颜 色 ; 形如 #FFFFFF 默认值为 #1C86EE OfferWallAct.KEY_TAB_TEXT_COLOR 设置标题及未被选中的 Tab 的 文字颜 色 ; 形如 #FFFFFF 默认值为 # 代码示例例 : Intent intent = new Intent(MainActivity.this, OfferWallAct.class); Bundle b = new Bundle(); b.putint("pid", YOUR_PID); b.putint(offerwallact.key_title_id, R.string.app_name); // 可选 b.putstring(offerwallact.key_tab_background_color, "#EDEDED"); // 可选 b.putstring(offerwallact.key_tab_indicator_color, "#1C86EE"); // 可选 b.putstring(offerwallact.key_tab_text_color, "#000000"); // 可选 intent.putextras(b); startactivity(intent); 12. 插屏 广告使 用 插屏 广告样式 :

24 12.1 构造插屏 广告对象 public InterstitialAd(Context context, int pid, int type) Context context int pid int type 说明 ACTIVITY CONTEXT 广告位 ID, 该 pid 注册在 Json 的 native 数组中 InterstitialAd.Type.SCREEN 全屏 广告 InterstitialAd.Type.NORMAL 半屏 广告此缺省时, 默认为半屏 12.2 注册插屏 广告回调 public void setinterstitiallistener (AbsInterstitialListener adlistener) AbsInterstitialListener adlistener 说明 回调函数返回获取 广告错误, 获取 广告的数据, 广告点击事 件

25 public interface AbsInterstitialListener { // 广告接收失败回调 public void onadfail(int errorcode); // 广告接收成功回调 public void onadreceive(); // 广告销毁回调 public void onaddismissed(); // 广告展示回调 public void onadpresent(); // 广告点击回调 public void onadclicked(); 12.3 使 用插屏 广告 public void fill() 调 用 fill() 接 口可以提前缓存 广告, 在 load() 广告时可以更更快获取 建议在 广告展示的前置场景调 用该 方法 注 : 广告数据会缓存到客户端内存中, 不不会缓存 广告的图 片数据, 只会缓存图 片的 Url 地址, 缓存数据量量 小 public void load() 获取 广告对象数据, 没有缓存时会进 行行 广告请求 建议在使 用 load() 后再次调 用 fill() 接 口进 行行 广告缓存 public void show() 广告展示 方法, 请在回调 onadreceive() 中使 用本 方法 public void close() 广告关闭 方法, 该 方法已废弃 public void destroy()

26 广告对象销毁 方法, 在退出插屏 广告展示界 面时建议使 用 13. 横幅 广告使 用 横幅 广告样式 : 横幅 广告尺 寸 :320 x 50 px 13.1 构造横幅 广告对象 public BannerAdView(Context context, int pid, int cachesize, BannerListener listener) Context context int pid int cachesize BannerListener listener 说明 ACTIVITY CONTEXT 广告位 ID, 该 pid 注册在 Json 的 native 数组中 广告缓存个数横幅 广告监听器器 ( 同 一个 BannerAdView 只回调 首次 load() 的结果 ) 13.2 注册横幅 广告回调 public BannerListener ()

27 public interface BannerListener { // 广告接收失败回调 public void onerror(string msg); // 广告接收成功回调 public void onadloaded(); 代码示例例 : BannerAdView mbanneradview = new BannerAdView(this, PID, CACHESIZE, new BannerListener() public void onadloaded() { Log.d(TAG, public void onerror(string msg) { Log.d(TAG, "onerror:" + msg); ); 13.3 设置相关 public void setbgstyle(int BannerStyle) Int BannerStyle 说明设置背景颜 色 : BannerStyle.STYLE_BLUE : 蓝 色背景 BannerStyle.STYLE_GREEN : 绿 色背景 ; public void setclosestyle(int BannerCloseStyle) Int BannerCloseStyle 说明设置按钮位置 : BannerCloseStyle.STYLE_BOTTOM : 右下 角 BannerCloseStyle.STYLE_TOP : 右上 角

28 13.4 添加横幅到布局中 YourLayout.addView(mBannerAdView); 13.5 使 用横幅 广告 public void load() 获取 广告对象数据, 没有缓存时会进 行行 广告请求 public void destroy() 广告对象销毁 方法, 在退出横幅 广告展示界 面时建议使 用