# 开屏广告
# 介绍
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
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
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
2
3
4
5
6
7
8
9
10
回调方法
| 回调方法 | 说明 |
|---|---|
| onLoadSuccess | 广告加载成功 |
| onLoadError | 广告加载失败 |
| onLoadTimeout | 广告加载超时 |
| onAdShow | 广告显示 |
| onAdClicked | 广告被点击 |