adView

来自于:开发者立即使用

概述

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

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

  • 名称:adView

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

示例代码

  <feature name="adView">
    <param name="android_key" value="SDK20171229121124u7qv5iq78htehpl"/>
  </feature>

initsdk

初始化SDK

initsdk

示例代码

var adView = api.require('adView');
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对象
  • 内部字段:
{
    status: show/click/failed/hide
}

示例代码

var adView = api.require('adView');
adView.showBanner({
  x : 0,
  y : 0,
  fixedOn:'',
  fixed : true      
}, 
  function(ret, err) {
    alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
});

可用性

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对象
  • 内部字段:
{
    status: destory
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

showInterstitialAD

插屏广告

showInterstitialAD(callback(ret))

callback(ret, err)

ret:

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

示例代码

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

可用性

Android系统

可提供的1.0.0及更高版本

showSplash

开屏广告

showSplash(callback(ret))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 备注:回调close/click/failed中任意一个参数,都意味开屏广告结束
  • 内部字段:
{
    status: show/close/click /failed 
}


示例代码

```js
var adView = api.require('adView');;
adView.showSplash(function(ret, err) {
   alert("ret: " + JSON.stringify(ret) + "\err: " + JSON.stringify(err));
});

可用性

Android系统

可提供的1.0.0及更高版本

补充说明

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