InterstitialAd

插屏广告组件。插屏广告是一个单例(小程序端是页面内单例,在小程序端的单例对象不允许跨页面使用)。

默认是隐藏的,调用 InterstitialAd.load()加载数据,InterstitialAd.show() 将其显示。 InterstitialAd.destroy()销毁实例,销毁后需要重新调用qq.createInterstitialAd()创建实例。

方法

Promise InterstitialAd.load()

加载插屏广告

Promise InterstitialAd.show()

显示插屏广告

Promise InterstitialAd.destroy()

销毁插屏广告

InterstitialAd.onClose(function callback)

监听用户点击 关闭广告 按钮的事件

InterstitialAd.offClose(function callback)

取消监听用户点击 关闭广告 按钮的事件

InterstitialAd.onLoad(function callback)

监听广告数据加载事件

InterstitialAd.offLoad(function callback)

取消监听广告数据加载事件

InterstitialAd.onError(function callback)

监听广告组件错误事件

InterstitialAd.offError(function callback)

取消监听广告组件错误事件

.load

Promise InterstitialAd.load()

加载插屏广告

返回值

Promise

插屏广告加载数据的结果

.show

Promise InterstitialAd.show()

显示插屏广告

返回值

Promise

插屏广告显示操作的结果

错误码说明

代码 异常情况 理由
2001 触发频率限制 小程序启动一定时间内不允许展示插屏广告
2002 触发频率限制 距离小程序插屏广告或者激励视频广告上次播放时间间隔不足,不允许展示插屏广告
2003 触发频率限制 当前正在播放激励视频广告或者插屏广告,不允许再次展示插屏广告
2004 广告渲染失败 该项错误不是开发者的异常情况,或因小程序页面切换导致广告渲染失败
2005 广告调用异常 插屏广告实例不允许跨页面调用

.destroy

Promise InterstitialAd.destroy()

销毁插屏广告,销毁后才能重新创建

注意:安卓中调destroy接口销毁实例,广告界面仍需手动点击关闭按钮关闭。

返回值

Promise

插屏广告销毁操作的结果

.onClose

InterstitialAd.onClose(function callback)

监听用户点击 关闭广告 按钮的事件

参数

function callback

用户点击 关闭广告 按钮的事件的回调函数

.offClose

InterstitialAd.offClose(function callback)

取消监听用户点击 关闭广告 按钮的事件

参数

function callback

用户点击 关闭广告 按钮的事件的回调函数

.onLoad

InterstitialAd.onLoad(function callback)

监听广告数据加载事件

参数

function callback

监听广告数据加载事件的回调函数

.offLoad

InterstitialAd.offLoad(function callback)

取消监听广告数据加载事件

参数

function callback

取消监听广告数据加载事件的回调函数

.onError

InterstitialAd.onError(function callback)

监听广告组件错误事件

参数

function callback

监听广告组件错误事件的回调函数

.offError

InterstitialAd.offError(function callback)

取消监听广告组件错误事件

参数

function callback

取消监听广告组件错误事件的回调函数

错误码信息与解决方案表

错误码说明

代码 异常情况 理由 解决方案
1000 后端错误调用失败 该项错误不是开发者的异常情况 一般情况下忽略一段时间即可恢复。
1001 参数错误 使用方法错误 可以前往 q.qq.com 确认具体教程(小程序和小游戏分别有各自的教程,可以在顶部选项中,“设计”一栏的右侧进行切换。
1002 广告单元无效 可能是拼写错误、或者误用了其他 APP 的广告 ID 请重新前往 q.qq.com 确认广告位 ID。
1003 内部错误 该项错误不是开发者的异常情况 一般情况下忽略一段时间即可恢复。
1004 无适合的广告 广告不是每一次都会出现,这次没有出现可能是由于该用户不适合浏览广告 属于正常情况,且开发者需要针对这种情况做形态上的兼容。
1005 广告组件审核中 你的广告正在被审核,无法展现广告 请前往 q.qq.com 确认审核状态,且开发者需要针对这种情况做形态上的兼容。
1006 广告组件被驳回 你的广告审核失败,无法展现广告 请前往 q.qq.com 确认审核状态,且开发者需要针对这种情况做形态上的兼容。
1007 广告组件被驳回 你的广告能力已经被封禁,封禁期间无法展现广告 请前往 q.qq.com 确认小程序广告封禁状态。
1008 广告单元已关闭 该广告位的广告能力已经被关闭 请前往 q.qq.com 重新打开对应广告位的展现。