adView

来自于:开发者立即使用

initsdk showBanner hideBanner Destory showInterstitialAD showSplash

概述

adView 封装了adView聚合广告平台的SDK,支持横幅、插屏、开屏主流广告形式。使用该模块需要先到adView官网申请得到应用的SDK-KEY值。模块采用拆分的机制,防止安装包过大,您需要将所需的第三方SDK以模块样式添加,在 这篇帖子 中下载添加使用

使用此模块之前需要先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:

  • 名称:adView

  • 参数:android_key ,(必须配置)adView官网后台申请到的安卓应用SDK-KEY值。

示例代码

  1. <feature name="adView">
  2. <param name="android_key" value="SDK20171229121124u7qv5iq78htehpl"/>
  3. </feature>

initsdk

初始化SDK

initsdk

示例代码

  1. var adView = api.require('adView');
  2. adView.initsdk();

可用性

可用性Android系统

可提供的1.0.0及更高版本

showBanner

显示横幅广告

showBanner({params}, callback(ret))

params

x:

  • 类型:字符串
  • 描述:横幅左上角的 x 坐标(相对于所属的 Window 或 Frame)。
  • 默认值:0

y:

  • 类型:字符串
  • 描述:(可选项)数字类型;横幅左上角的 y 坐标(相对于所属的 Window 或 Frame);
  • 默认值:0

w:

  • 类型:字符串
  • 描述:(可选项)数字类型;横幅的宽度;页面从x位置开始自动充满所属的 Window 或 Frame 的宽度;默认:
  • 默认值:自适应。宽度值不能小于300,否则曝光不成功,导致无法计费。//部分平台应用横幅广告宽度仅为320*50,无法填满屏幕,会居中显示;

h:

  • 描述:(不可选项)数字类型;横幅的高度
  • 固定值:50 。

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块添加到指定window或frame
  • 默认:模块依附于当前 window

  • fixed:

  • 类型:布尔

  • 描述:(可选项)模块是否随所属 window 或 frame 滚动

  • 默认值:true(不随之滚动)

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: show/click/failed/hide
  3. }

示例代码

  1. var adView = api.require('adView');
  2. adView.showBanner({
  3. x : 0,
  4. y : 0,
  5. fixedOn:'',
  6. fixed : true
  7. },
  8. function(ret, err) {
  9. alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
  10. });

可用性

Android系统

可提供的1.0.0及更高版本

hideBanner 隐藏横幅广告 hideBanner(callback(ret)) ##callback(ret) ret: - 类型:JSON对象 - 内部字段: js { status: hide } ##示例代码 js var adView = api.require('adView'); adView.hideBanner(function(ret, err) { alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err)); }); ##可用性 ##Android系统 可提供的1.0.0及更高版本

Destory

销毁广告

Destory(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: destory
  3. }

示例代码

  1. var adView = api.require('adView');
  2. adView.Destory(function(ret, err) {
  3. alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
  4. });

补充说明

广告销毁后横幅/插屏/开屏均不可用,需再次initsdk后才能调用

可用性

Android系统

可提供的1.0.0及更高版本

showInterstitialAD

插屏广告

showInterstitialAD(callback(ret))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: falied/show/click/close
  3. }

示例代码

  1. var adViewinst = api.require('adViewinst');
  2. adViewinst.showInterstitialAD(function(ret, err) {
  3. alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
  4. });

可用性

Android系统

可提供的1.0.0及更高版本

showSplash

开屏广告

showSplash(callback(ret))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 备注:回调close/click/failed中任意一个参数,都意味开屏广告结束
  • 内部字段:
  1. {
  2. status: show/close/click /failed
  3. }
  4. 示例代码
  5. ```js
  6. var adView = api.require('adView');;
  7. adView.showSplash(function(ret, err) {
  8. alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
  9. });

可用性

Android系统

可提供的1.0.0及更高版本

补充说明

部分广告平台请求到的广告尺寸无法全屏显示,所以将开屏广告的背景设为透明