BannerAd
bannerAd.show()
show()
是 BannerAd 对象的方法,用于展示 banner 广告组件,返回一个 promise 对象。
bannerAd.show()
示例:
let example = {
adUnitId: '000000',
appSid: '000000',
style: {
top: 20,
left: 100,
width: 300
}
}
const bannerAd = swan.createBannerAd(example);
bannerAd.onLoad(() => {
bannerAd.show()
.then()
.catch(err => console.log(err));
})
bannerAd.hide()
hide()
是 BannerAd 对象的方法,用来隐藏已展示的 banner 广告组件,该方法没有返回值。
bannerAd.hide()
示例:
let example = {
adUnitId: '000000',
appSid: '000000',
style: {
top: 20,
left: 100,
width: 300
}
}
const bannerAd = swan.createBannerAd(example);
bannerAd.show()
.then(() => bannerAd.hide())
.catch(err => console.log(err));
bannerAd.onLoad()
onLoad()
是 BannerAd 对象的方法,监听 banner 广告组件的加载事件。
bannerAd.onLoad(callback)
参数值:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
callback | function | 是 | banner 广告加载完成后的回调函数 |
示例:
let example = {
adUnitId: '000000',
appSid: '000000',
style: {
top: 20,
left: 100,
width: 300
}
}
const bannerAd = swan.createBannerAd(example);
bannerAd.onLoad(() => {
console.log(' banner 加载完成');
})
bannerAd.offLoad()
offLoad()
是 BannerAd 对象的方法,用于取消监听 banner 广告组件的加载事件。
bannerAd.offLoad(callback)
参数值:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
callback | function | 否 | 取消监听 banner 广告加载事件对应的回调函数(如果不传参数,则清除所有监听 banner 广告加载事件的回调函数) |
示例:
let example = {
adUnitId: '000000',
appSid: '000000',
style: {
top: 20,
left: 100,
width: 300
}
}
let onLoadFuc = function () {
console.log(' banner 加载完成')
}
const bannerAd = swan.createBannerAd(example);
bannerAd.onLoad(onLoadFuc);
bannerAd.offLoad(onLoadFuc); // offLoad 对应的函数将取消对应的监听事件
bannerAd.onError()
onError()
是 BannerAd 对象的方法,监听 banner 广告的错误事件。
bannerAd.onError(callback)
参数值:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
callback | function | 是 | banner 广告出现错误的回调函数 |
回调函数参数值:
属性 | 类型 | 描述 |
---|---|---|
err | Object | 回调函数的参数 |
err.errCode | number | 错误码 |
err.errMsg | string | 错误信息 |
errCode 与对应的错误信息
错误码 | 错误描述 |
---|---|
103010 | appSid 缺失 |
103011 | appSid 错误,MSSP 未收录 |
103012 | appSid 无效,MSSP 上未生效 |
103020 | appSid 无效,渠道 ID 信息错误 |
107000 | adUnitId 缺失 |
107001 | adUnitId 未收录 |
107002 | adUnitId 未启用 |
107003 | adUnitId 与 appSid 不匹配 |
200000 | 无广告返回 |
201000 | 无广告数据 |
3010000 | 广告组件挂载失败 |
3010002 | 广告请求失败 |
3010003 | 网络连接错误 |
3010004 | 没有可以展示的广告 |
3010005 | 广告正在拉取中,不能重复请求 |
3010006 | 广告正在展示中,不能请求广告 |
3010007 | 广告请求参数为空 |
3010010 | 没有可以展示的 banner 广告 |
3010011 | 用户关闭banner广告后,1小时内不允许再展示该广告 |
3010012 | 小游戏启动前5秒不允许展示banner广告 |
3010013 | banner广告展示频控限制,30秒内不允许重复展示banner广告 |
else | 其余错误码均为内部错误 |
示例:
let example = {
adUnitId: '000000',
appSid: '000000',
style: {
top: 20,
left: 100,
width: 300
}
}
const bannerAd = swan.createBannerAd(example);
bannerAd.onError((err) => {
console.log(' banner 广告错误');
})
bannerAd.offError()
offError()
是 BannerAd 对象的方法,用于取消监听 banner 广告的错误事件。
bannerAd.offError(callback)
参数值:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
callback | function | 否 | 取消监听 banner 广告错误事件对应的回调函数(如果不传参数,则清除所有监听 banner 广告错误事件的回调函数) |
示例:
let example = {
adUnitId: '000000',
appSid: '000000',
style: {
top: 20,
left: 100,
width: 300
}
}
let onErrorFuc = function () {
console.log(' banner 出现错误');
}
const bannerAd = swan.createBannerAd(example);
bannerAd.onError(onErrorFuc);
bannerAd.offError(onErrorFuc); // offError 对应的函数将取消对应的监听事件
bannerAd.onResize()
onResize()
是 BannerAd 对象的方法,监听 banner 广告位尺寸变化的事件。
bannerAd.onResize(callback)
参数值:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
callback | function | 是 | 开发者改变 banner 广告位尺寸后的回调函数 |
回调函数参数值:
参数 | 类型 | 描述 |
---|---|---|
res | Object | 回调函数的参数 |
res.width | number | 改变后 banner 广告位的宽度 |
res.height | number | 改变后 banner 广告位的高度 |
示例:
let example = {
adUnitId: '000000',
appSid: '000000',
style: {
top: 20,
left: 100,
width: 300
}
}
const bannerAd = swan.createBannerAd(example);
bannerAd.onResize((res) => {
console.log(' banner 广告位宽度变化');
})
bannerAd.style.width = 350;
bannerAd.offResize()
offResize()
是 BannerAd 对象的方法,用于取消监听 banner 广告位尺寸变化的事件。
bannerAd.offResize(callback)
参数值:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
callback | function | 否 | 取消监听 banner 广告位尺寸变化事件对应的回调函数(如果不传参数,则清除所有监听 banner 广告位尺寸变化事件的回调函数) |
示例:
let example = {
adUnitId: '000000',
appSid: '000000',
style: {
top: 20,
left: 100,
width: 300
}
}
let onResizeFuc = function () {
console.log(' banner 广告位宽度变化');
}
const bannerAd = swan.createBannerAd(example);
bannerAd.onResize(onResizeFuc);
bannerAd.offResize(onResizeFuc); // offResize 对应的函数将取消对应的监听事件
bannerAd.destroy()
destroy()
是 BannerAd 对象的方法,用于销毁 banner 广告组件,该方法没有返回值。
bannerAd.destroy()
示例:
let example = {
adUnitId: '000000',
appSid: '000000',
style: {
top: 20,
left: 100,
width: 300
}
}
const bannerAd = swan.createBannerAd(example);
bannerAd.destroy();