激励视频广告
激励视频广告组件是由客户端原生的图片、文本、视频控件组成的,层级最高,会覆盖在上屏 Canvas 上。
开发者可以调用 wx.createRewardedVideoAd 创建激励视频广告组件。该方法返回的是一个全局单例。
const video1 = wx.createRewardedVideoAd({adUnitId: 'xxxx'})
const video2 = wx.createRewardedVideoAd({adUnitId: 'xxxx'})
console.log(video1 === video2)
// true
激励视频广告组件默认是隐藏的,因此可以提前创建,以提前初始化组件。
const rewardedVideoAd = wx.createRewardedVideoAd({adUnitId: 'xxxx'})
为避免滥用广告资源,目前每个用户每天可观看激励式视频广告的次数有限,建议展示广告按钮前先判断广告是否拉取成功。
显示/隐藏
激励视频广告组件默认是隐藏的,需要调用 RewardedVideoAd.show() 进行显示。
bannerAd.show()
只有在用户点击激励视频广告组件上的 关闭广告
按钮时,广告才会关闭。开发者不可控制激励视频广告组件的隐藏。
广告拉取成功与失败
激励视频广告组件是自动拉取广告并进行更新的。在组件创建后会拉取一次广告,用户点击 关闭广告
后会去拉取下一条广告。
如果拉取成功。RewardedVideoAd.onLoad() 会执行,RewardedVideoAd.show() 返回的 Promise 也会是一个 resolved Promise。两者的回调函数中都没有参数传递。
rewardedVideoAd.onLoad(() => {
console.log('激励视频 广告加载成功')
})
rewardedVideoAd.show()
.then(() => console.log('激励视频 广告显示'))
如果拉取失败,通过 RewardedVideoAd.onError() 注册的回调函数会执行,回调函数的参数是一个包含错误信息的对象。常见异常错误参考文档
rewardedVideoAd.onError(err => {
console.log(err)
})
RewardedVideoAd.show() 返回的 Promise 也会是一个 rejected Promise。
rewardedVideoAd.show()
.catch(err => console.log(err))
监听错误码
RewardedVideoAd.onError(function callback)
监听激励视频错误事件
参数
function callback
激励视频错误事件的回调函数
参数
Object res
属性 | 类型 | 说明 | 最低版本 |
---|---|---|---|
errMsg | string | 错误信息 | |
errCode | number | 错误码 | 2.2.2 |
errCode 的合法值
值 | 说明 |
---|---|
1000 | 后端接口调用失败 |
1001 | 参数错误 |
1002 | 广告单元无效 |
1003 | 内部错误 |
1004 | 无合适的广告 |
1005 | 广告组件审核中 |
1006 | 广告组件被驳回 |
1007 | 广告组件被封禁 |
1008 | 广告单元已关闭 |
错误码信息与解决方案表
错误码是通过onError获取到的错误信息。调试期间,可以通过异常返回来捕获信息。 在小程序发布上线之后,如果遇到异常问题,可以在“运维中心“里面搜寻错误日志,还可以针对异常返回加上适当的监控信息。
代码 | 异常情况 | 理由 | 解决方案 |
---|---|---|---|
1000 | 后端错误调用失败 | 该项错误不是开发者的异常情况 | 一般情况下忽略一段时间即可恢复。 |
1001 | 参数错误 | 使用方法错误 | 可以前往developers.weixin.qq.com确认具体教程(小程序和小游戏分别有各自的教程,可以在顶部选项中,“设计”一栏的右侧进行切换。 |
1002 | 广告单元无效 | 可能是拼写错误、或者误用了其他APP的广告ID | 请重新前往mp.weixin.qq.com确认广告位ID。 |
1003 | 内部错误 | 该项错误不是开发者的异常情况 | 一般情况下忽略一段时间即可恢复。 |
1004 | 无适合的广告 | 广告不是每一次都会出现,这次没有出现可能是由于该用户不适合浏览广告 | 属于正常情况,且开发者需要针对这种情况做形态上的兼容。 |
1005 | 广告组件审核中 | 你的广告正在被审核,无法展现广告 | 请前往mp.weixin.qq.com确认审核状态,且开发者需要针对这种情况做形态上的兼容。 |
1006 | 广告组件被驳回 | 你的广告审核失败,无法展现广告 | 请前往mp.weixin.qq.com确认审核状态,且开发者需要针对这种情况做形态上的兼容。 |
1007 | 广告组件被驳回 | 你的广告能力已经被封禁,封禁期间无法展现广告 | 请前往mp.weixin.qq.com确认小程序广告封禁状态。 |
1008 | 广告单元已关闭 | 该广告位的广告能力已经被关闭 | 请前往mp.weixin.qq.com重新打开对应广告位的展现。 |
拉取失败,重新拉取
showRewardeVideo()
{
this.rewardedVideoAd.show().catch(this._onShowRewardVideoAdError.bind(this));
},
_onShowRewardVideoAdError(err)
{
console.log(err);
this.showRewardeVideo();
},
官方 : https://developers.weixin.qq.com/minigame/dev/tutorial/ad/rewarded-video-ad.html
转载自原文链接, 如需删除请联系管理员。
原文链接:微信小游戏 激励视频广告 创建 拉取 错误码,转载请注明来源!