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();