QQ小游戏 RewardedVideoAd 创建激励视频广告组件 API

QQ小游戏激励视频广告组件详解
最新推荐文章于 2024-04-29 13:08:23 发布
转载 最新推荐文章于 2024-04-29 13:08:23 发布 · 1.8k 阅读 · 0 ·
CC 4.0 BY-SA版权
原文链接：https://q.qq.com/wiki/develop/game/API/ad/qq.createRewardedVideoAd.html
文章标签：

#qq小游戏 #视频广告 API #createRewardedVideoAd

RewardedVideoAd 创建激励视频广告组件 qq.createRewardedVideoAd(Object object)

RewardedVideoAd qq.createRewardedVideoAd(Object object)

创建激励视频广告组件。开发者工具 0.1.26 版本开始支持调试广告组件。

参数
Object object
属性类型默认值必填说明
adUnitIdstring是广告单元 id
返回值
RewardedVideoAd

激励视频广告组件

激励视频广告组件是一个原生组件，并且是一个全局单例。层级比上屏 Canvas 高，会覆盖在上屏 Canvas 上。激励视频 广告组件默认是隐藏的，需要调用 RewardedVideoAd.show() 将其显示。

方法
Promise RewardedVideoAd.load()

加载激励视频广告数据

Promise RewardedVideoAd.show()

显示激励视频广告。激励视频广告将从屏幕下方推入。

RewardedVideoAd.onLoad(function callback)

监听激励视频广告加载事件

RewardedVideoAd.offLoad(function callback)

取消监听激励视频广告加载事件

RewardedVideoAd.onError(function callback)

监听激励视频错误事件

RewardedVideoAd.offError(function callback)

取消监听激励视频错误事件

RewardedVideoAd.onClose(function callback)

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

RewardedVideoAd.offClose(function callback)

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

.load

Promise RewardedVideoAd.load()

隐藏激励视频广告

返回值
Promise

激励视频广告加载数据的结果

.offClose

RewardedVideoAd.offClose(function callback)

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

参数
function callback

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

.offError

RewardedVideoAd.offError(function callback)

取消监听激励视频错误事件

参数
function callback

激励视频错误事件的回调函数

.offLoad

RewardedVideoAd.offLoad(function callback)

取消监听激励视频广告加载事件

参数
function callback

激励视频广告加载事件的回调函数

.onClose

RewardedVideoAd.onClose(function callback)

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

参数
function callback

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

参数

Object res

属性类型说明最低版本
isEndedboolean视频是否是在用户完整观看的情况下被关闭的

.onError

RewardedVideoAd.onError(function callback)

监听激励视频错误事件

参数
function callback

激励视频错误事件的回调函数

参数

Object res

属性类型说明最低版本
errMsgstring错误信息
errCodenumber错误码

.onLoad

RewardedVideoAd.onLoad(function callback)

监听激励视频广告加载事件

参数
function callback

激励视频广告加载事件的回调函数

.show

Promise RewardedVideoAd.show()

显示激励视频广告。激励视频广告将从屏幕下方推入。

返回值
Promise

激励视频广告显示操作的结果

错误码信息与解决方案表

错误码说明

代码异常情况理由解决方案
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 重新打开对应广告位的展现。

其他API：
QQ小游戏 BannerAd 创建banner广告组件 API
QQ小游戏 AppBox 创建广告盒子组件 API
QQ小游戏 RewardedVideoAd 创建激励视频广告组件 API

使用方法：
接QQ小游戏小程序盒子广告sdk
接QQ小游戏Banner广告sdk
接QQ小游戏小程序视频广告sdk

维尼聚合工具

微信小程序 - 最新详细实现接入“视频激励式广告“申请配置流程及示例代码教程，在小程序页面中点击按钮弹出激励视频广告及实时监控临时退出、关闭广告等，用户观看视频广告后获得奖励用于解锁道具或获取积分等！
🏆 前端领域优质创作者
07-30 1万+
微信小程序，激励式广告，产生收益，如何开通广告，广告ID，广告不显示不加载，报错，发布上线后不显示，接入广告，开通流量主插入广告功能，微信小程序视频广告，激励视频，广告位，流量主，全屏弹出视频看广告，小游戏激励广告，激励视频广告，在小程序中添加激励视频广告，流量变现，流量主激励视频，底部弹出激励视频弹窗，如何知道用户是否看完视频，实时检查是否观看完广告，播放次数限制，临时退出广告如何再次打开，插入激励广告，详细教程，激励广告视频长度如何修改，获取复活次数道具奖励补签额外金币激励，广告联盟，让用户看广告，视频
QQ小程序激励广告接入与使用
热门推荐
12-15 1万+
首先去QQ那里申请一个广告，会有一个广告ID。 代码很直观了，主要就是如何知道视频有木有看完呢，这样再决定要不要给用户奖励。 ``` //初始化广告 let videoAd = qq.createRewardedVideoAd({adUnitId: "f0f86362xxxxxxxxx473"}) //发生错误的回调 videoAd.onError(function (res)...
cocos creator 接QQ小游戏小程序RewardedVideoAd 激励视频广告sdk
Sclifftop - 保安大队长
09-23 5829
cocos creator 接QQ小游戏小程序RewardedVideoAd 激励视频广告sdk //首先，你需要初始化广告，判断什么的你自己加，我就不写很详细的 this.mVideosAd = qq.createRewardedVideoAd({ adUnitId: 你的广告的id }); t...
激励视频广告 Android,激励视频广告
weixin_42500720的博客
05-26 2900
# 激励视频广告激励视频广告组件是由客户端原生的图片、文本、视频控件组成的，层级最高，会覆盖在上屏 Canvas 上。开发者可以调用 wx.createRewardedVideoAd 创建激励视频广告组件。该方法返回的是一个全局单例。let video1 = wx.createRewardedVideoAd({ adUnitId: 'xxxx' })let video2 = wx.createRe...
微信小游戏 激励视频广告 创建 拉取 错误码
weixin_41316824的博客
12-13 9702
激励视频广告 激励视频广告组件是由客户端原生的图片、文本、视频控件组成的，层级最高，会覆盖在上屏 Canvas 上。 开发者可以调用 wx.createRewardedVideoAd 创建激励视频广告组件。该方法返回的是一个全局单例。 const video1 = wx.createRewardedVideoAd({adUnitId: 'xxxx'}) const video2 = wx....
检测微信小程序wx.createRewardedVideoAd视频激励广告跳过插件防止白嫖
Soujer
04-29 5924
晓杰搞了几个小程序靠着广告微薄收入度日，没想到有一天发现了破解的微信居然有这个插件不得不说这个插件确NB，亲测小游戏啥的视频广告瞬秒结束！，晓杰就一直研究如何检测这个插件！
小程序点击事件插入激励视频广告实例
11-17
在微信小程序开发中，为了增加用户互动性和提升用户体验，激励视频广告是一种常见且有效的策略。本文将详细讲解如何在小程序的点击事件中插入激励视频广告，以实现更佳的商业化效果。我们将主要针对QQ小程序API进行...
精选资源
Unity3d 微信小程序（小游戏）项目实现接入广告（banner、插屏和激励广告等）Demo源码
01-28
Unity3d 微信小程序（小游戏）项目实现接入广告（banner、插屏和激励广告等）Demo源码。 建议先看说明：https://blog.csdn.net/qq_33789001/article/details/128775839 广告虽然能够给平台和开发者带来一定的收益，...
cocos creator Facebook激励视频广告demo
10-17
cocos creator 预加载播放Facebook激励视频广告，也可以实时加载播放激励视频广告，实时加载会比较慢，特别是网卡的情况下
QQ/微信小程序激励视频广告插入指南
无论是微信小程序还是QQ小程序，它们都为开发者提供了丰富的API接口，以便可以嵌入各种功能，比如激励视频广告。激励视频广告是指用户观看完一段广告视频后，可以获得某种形式的奖励（如积分、道具、优惠券等）的一...
admob 广告代码参考 安卓 奖励视频
leonqiu的博客
12-21 2370
Initialize rewarded video ads JAVA KOTLIN package ...import com.google.android.gms.ads.AdRequest;import com.google.android.gms.ads.MobileAds;import com.google.android.gms.ads.reward.Rewar
【快应用】快应用广告学习之激励视频广告
Mayism123的博客
08-17 823
这里通过一个简单的在阅读中通过观看激励视频广告解锁章节的demo来加深一下对这块的掌握。快应用、激励视频广告、广告接入。一、关于激励视频广告。
uniapp 小程序 加载显示激励视频广告
这里是痞子Monkey的博客
10-11 5711
封装激励视频广告代码，在根目录创建common =>Utils.js Utils.js代码 // 在页面中定义激励视频广告 var videoAd = null; let rewarded = { //id就是传入的广告位id load(id) { if (uni.createRewardedVideoAd) { videoAd = uni.createRewardedVideoAd({ adUnitId: id }) videoAd.onLoad(() =.
码code | 小程序接入「激励式视频广告」硬核指南
weixin_33860722的博客
04-26 2926
4月16日，微信开放社区发布了“「激励式视频广告」向非游戏类小程序流量主开放“的公告，也就是说现在只要是开通了流量主的小程序，就可以跟小游戏一样插入激励视频广告。激励式视频广告的功能对用户来说：在小程序的某个场景中主动触发激励式广告，待完整播放视频广告，并手动点击“关闭广告”按钮后，将获得该小程序下发的奖励。对流量主来说：可通过视频广告的有效曝光，与平台分成收取的广告费用。100W元以下广告流水，...
cocos creator 微信小游戏 封装banner、原生格子、插屏、激励视频广告
这里是痞子Monkey的博客
12-01 5800
创建WxPlatform.ts文件 封装bannger广告 class WxPlatform { //banner广告 banner: BannerAd; showBanner() { if (cc.sys.platform != cc.sys.WECHAT_GAME) { return; } if (this.banner != null) { this.banner.destroy();...
cocos creator对接字节跳动（抖音）小游戏激励视频广告注意事项（审核不通过，次数不一致和重复获得奖励等）
灰机大大的博客
02-03 6139
cocos creator对接字节跳动（抖音）小游戏激励视频广告注意事项（审核不通过，次数不一致和重复获得奖励等）
uni-app -- 小程序添加激励视频（字节-抖音小程序）
Dark_programmer的博客
01-21 5852
激励视频1. 遇到的问题1.1关于第五个坑，是遇到这样一个报错1.2 全局只有一个RewarededVideoAd 实例2.创建RewarededVideoAd 实例2.1 创建全局唯一实例2.2 需要的页面进行展示 1. 遇到的问题 1.激励视频广告是由客户端原生渲染，覆盖在整个小程序页面区域之上，目前支持竖屏展示。 2.全局只有一个RewarededVideoAd 实例，重复创建不会覆盖。 3.激励视频广告展示的时候用户不能操作小程序。 4.开发者工具上暂不支持调试该 API，请直接在真机上进行调试。
激励视频广告组件检测到您绑定了多次 onClose 事件（已解决）
weixin_49885784的博客
04-10 2456
激励视频广告组件检测到您绑定了多次 onClose 事件（已解决）
uniapp加激励广告代码方法
jiuwulang的专栏
12-24 4939
uniapp可以加字节跳动、微信、百度等平台的广告代码，广告标签就直接用每个平台的，uniapp会自动处理，不用管。当时我也就是不知道，找了一遍文档才发现只要照着每个平台的开发文档加广告代码标签就行了。 但 js的会稍微不同，下面我就以抖音的激励广告和 banner广告 示例来分享 激励广告 直接上代码 <script> var videoAd = null; export default { data() { return { show_result: .
在EgretWing中 看广告 如何等用户看完再发奖励
最新发布
07-24
<think>我们正在使用EgretWing（一个基于Egret引擎的开发工具）开发游戏。用户的问题是如何在EgretWing中实现观看广告后发放奖励的功能。具体来说，就是当玩家观看完广告后，游戏需要发放奖励（如金币、道具等）。 在Egret引擎中，广告功能通常是通过平台提供的SDK来实现的。不同的平台（如微信小游戏、QQ小游戏、百度小游戏等）有不同的广告API。因此，实现广告奖励功能需要以下步骤： 1. 集成广告SDK：根据目标平台，集成相应的广告SDK。Egret引擎已经为一些主流平台提供了支持，例如在微信小游戏中，可以使用微信的广告API。 2. 创建广告组件：在游戏中创建一个广告组件，用于加载和显示广告。 3. 监听广告事件：特别是广告播放完成的事件，当广告播放完成时，触发发放奖励的逻辑。 4. 发放奖励：在广告播放完成的回调函数中，执行发放奖励的代码。 由于EgretWing是一个可视化编辑工具，我们可以通过编写代码来实现上述逻辑。以下是一个基于微信小游戏平台的示例代码，因为微信小游戏是目前比较常见的平台。 注意：在实际开发中，需要确保广告SDK已经正确集成到Egret项目中。Egret官方提供了微信小游戏的集成方案，可以参考Egret官方文档。 步骤详解： 步骤1：在微信小游戏项目中，首先需要创建激励视频广告。微信小游戏提供了`wx.createRewardedVideoAd`方法。 步骤2：在合适的时机（比如玩家点击了一个“看广告得奖励”的按钮）调用广告组件的`show`方法。 步骤3：监听广告的关闭事件（`onClose`），在事件回调中判断广告是否正常播放完成（通过回调参数中的`isEnded`），如果播放完成则发放奖励。 示例代码： 首先，在游戏代码中，我们声明一个广告实例，并在初始化时创建它。注意：广告单元ID（adUnitId）需要从微信小游戏后台获取。 在Egret项目的某个类中（比如游戏主类）添加以下代码： ```typescript class Main extends egret.DisplayObjectContainer { // 激励视频广告实例 private rewardedVideoAd: any; public constructor() { super(); this.addEventListener(egret.Event.ADDED_TO_STAGE, this.onAddToStage, this); } private onAddToStage(event: egret.Event) { // 初始化广告 this.initAd(); // 其他初始化代码... } // 初始化激励视频广告 private initAd(): void { // 判断是否在微信小游戏环境中 if (typeof wx !== 'undefined') { // 创建激励视频广告 this.rewardedVideoAd = wx.createRewardedVideoAd({ adUnitId: '你的广告单元ID' // 这里需要替换成实际的广告单元ID }); // 监听激励视频广告加载错误 this.rewardedVideoAd.onError(err => { console.error('激励视频广告加载错误', err); }); // 监听广告关闭事件 this.rewardedVideoAd.onClose(res => { // 用户点击了【关闭广告】按钮 if (res && res.isEnded) { // 正常播放结束，可以发放奖励 this.giveReward(); } else { // 播放中途退出，不发放奖励 console.log('广告未播放完成'); } }); } } // 显示广告的方法，可以在按钮点击事件中调用 public showRewardedAd(): void { if (this.rewardedVideoAd) { this.rewardedVideoAd.show().catch(err => { // 失败重试 this.rewardedVideoAd.load() .then(() => this.rewardedVideoAd.show()) .catch(err => { console.error('广告展示失败', err); }); }); } } // 发放奖励 private giveReward(): void { // 这里写发放奖励的代码，比如增加金币、道具等 console.log('发放奖励'); // 例如：增加金币 // player.gold += 100; } } ``` 注意： - 上述代码需要在微信小游戏环境下运行，因此使用`wx`对象前需要判断是否存在。 - 广告单元ID需要替换为实际申请到的ID。 - 广告的加载和显示可能会失败，因此需要错误处理。 在EgretWing中，我们可以将上述代码添加到游戏主类中。同时，我们需要在界面上放置一个按钮，当点击按钮时调用`showRewardedAd`方法。 另外，关于广告的测试，微信小游戏提供了测试广告单元ID，可以在开发阶段使用。 其他平台（如QQ小游戏、百度小游戏等）的实现方式类似，只是API可能略有不同，需要参考对应平台的文档。 总结：实现观看广告后发放奖励的功能，关键在于广告组件的创建和事件监听，在广告播放完成的回调中执行奖励逻辑。 相关问题： 1. 在Egret中如何集成微信小游戏SDK？ 2. 如何为不同的平台（如QQ小游戏、百度小游戏）实现广告功能？ 3. 如何设计奖励机制以避免玩家滥用广告功能？</think>在EgretWing中实现观看广告后发放奖励的功能，需要结合广告SDK和游戏逻辑处理。以下是实现步骤和代码示例： ### 实现步骤 1. **初始化广告模块** - 集成广告SDK（如腾讯广点通、穿山甲等） - 创建激励视频广告实例 2. **监听广告事件** - 广告加载完成 - 广告播放完成 - 广告播放中断 3. **奖励发放逻辑** - 验证广告是否完整播放 - 执行奖励发放逻辑 - 更新游戏状态 ### 代码实现示例 ```typescript // 1. 声明广告实例 private rewardAd: any; // 实际类型根据SDK文档确定 // 2. 初始化广告 private initAd() { if (typeof wx !== 'undefined') { // 微信小游戏环境 this.rewardAd = wx.createRewardedVideoAd({ adUnitId: '你的广告单元ID' }); // 监听广告关闭事件（关键！） this.rewardAd.onClose(res => { if (res && res.isEnded) { // 完整播放发放奖励 this.giveReward(); } else { // 中途关闭不发放 console.log("广告未完整播放"); } }); // 错误处理 this.rewardAd.onError(err => { console.error("广告加载失败", err); }); } } // 3. 触发广告播放 public showRewardAd() { if (this.rewardAd) { this.rewardAd.show().catch(err => { // 失败时重新加载 this.rewardAd.load().then(() => this.rewardAd.show()); }); } } // 4. 发放奖励（核心逻辑） private giveReward() { // 示例：增加金币 const currentGold = this.playerData.gold; this.playerData.gold = currentGold + 100; // 更新UI this.goldText.text = this.playerData.gold.toString(); // 保存游戏状态 this.saveGameData(); // 提示用户 const tip = new egret.TextField(); tip.text = "获得100金币奖励！"; this.addChild(tip); egret.Tween.get(tip).to({y: tip.y - 100}, 1000).call(() => { this.removeChild(tip); }); } // 5. 按钮绑定（在EUl中） private bindButton() { let btn = new eui.Button(); btn.label = "观看广告领奖励"; btn.addEventListener(egret.TouchEvent.TOUCH_TAP, () => { this.showRewardAd(); }); this.addChild(btn); } ``` ### 关键注意事项 1. **广告单元ID配置** - 需在广告平台创建激励视频广告位 - 不同平台（微信/QQ/百度小游戏）使用不同ID 2. **广告状态验证** ```typescript // 必须验证isEnded参数 if (res.isEnded) { // 用户完整观看 } else { // 用户提前关闭 } ``` 3. **多平台适配** ```typescript // 平台检测示例 if (window['qq']) { // QQ小游戏逻辑 } else if (window['swan']) { // 百度小游戏逻辑 } ``` 4. **错误处理** - 广告加载失败时自动重试 - 网络异常时提供备用方案（如直接发放测试奖励） ### 调试技巧 1. 开发阶段使用测试广告ID 2. 在`egretProperties.json`中添加广告SDK： ```json "modules": [ { "name": "egret" }, { "name": "game" }, { "name": "wxgame", // 微信小游戏支持 "path": "./wxgame" } ] ``` 3. 使用Egret Inspector调试广告事件[^4] ### 常见问题解决 - **广告无法加载**：检查网络连接和广告单元ID - **回调不触发**：确保使用`onClose`而非`onEnd` - **真机调试问题**：需打包为小游戏包测试[^3] - **移动端适配**：在`index.html`中添加viewport配置 > 提示：实际发布前需在各平台后台配置广告位，测试环境可使用官方提供的测试ID避免频繁触发广告限制[^1]。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值