# 开屏广告

# 介绍

SDK 为接入方提供了开屏广告,开屏广告建议为用户在进入 App 时展示的全屏广告。

开屏广告宽高默认为100%,注意开屏广告的height>=75%屏幕高,否则会影响计费

# 使用

var fnad = api.require('fnad');
var param = {positionId: "b5f4a25f971cd3", position: {height: parseInt(api.winHeight * 0.85)}};
//加载并显示开屏广告
fnad.loadSplashAd(param, function (ret, err) {
    var callback = ret.callback;
    if (callback === 'onLoadError') {
        api.toast({
            msg: ret.callback + '@' + ret.code + ':' + ret.msg
        });
    }
    api.toast({
        msg: '触发回调' + callback
    });
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 参数说明

参数示例:

var param = {
    positionId: "b5f4a25f971cd3", //String,开屏广告位ID(必填)
    position: {//开屏广告位置尺寸(可选)
        x: 0,//int,广告x坐标(可选)
        y: 0,//int,广告y坐标(可选)
        width: -1,//int,广告宽度,-1表示自适应并居中(可选)
        height: -1//int,广告高度,-1表示自适应并居中(可选)
    }
}       
1
2
3
4
5
6
7
8
9

# positionId

  • 类型: String
  • 默认值: 无
  • 必须: 是
  • 描述: 广告位Id

# position

  • 类型: JSON
  • 默认值: 无
  • 必须: 否
  • 描述: 广告坐标及尺寸

内部字段参见示例

# 回调

# callback(ret,err)

ret参数

ret = {
    callback: "onLoadSuccess",  //String,回调方法
                                //onLoadSuccess  广告加载成功
                                //onLoadError    广告加载失败
                                //onLoadTimeout  广告加载超时
                                //onAdShow       广告显示
                                //onAdClicked    广告被点击
    code: null,//int,错误代码,非错误不返回
    msg: null//int,错误消息,非错误不返回
}
1
2
3
4
5
6
7
8
9
10

回调方法

回调方法 说明
onLoadSuccess 广告加载成功
onLoadError 广告加载失败
onLoadTimeout 广告加载超时
onAdShow 广告显示
onAdClicked 广告被点击