微信小游戏激励视频广告创建拉取错误码

最新推荐文章于 2024-04-29 13:08:23 发布

-013-

最新推荐文章于 2024-04-29 13:08:23 发布

阅读量9.3k

点赞数 1

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/weixin_41316824/article/details/84982407

本文详细介绍了微信小程序中激励视频广告组件的使用方法，包括组件的创建、显示、隐藏及错误处理。探讨了如何调用API创建激励视频广告组件，以及如何通过监听事件来判断广告的加载状态和错误信息。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

激励视频广告

激励视频广告组件是由客户端原生的图片、文本、视频控件组成的，层级最高，会覆盖在上屏 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