首页 » 技术分享 » 微信小游戏 激励视频广告 创建 拉取 错误码

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

 

激励视频广告

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

转载自原文链接, 如需删除请联系管理员。

原文链接:微信小游戏 激励视频广告 创建 拉取 错误码,转载请注明来源!

0