首页 > 其他分享 >激励视频广告

激励视频广告

时间:2024-12-28 16:44:02浏览次数:5  
标签:视频 rewardedVideoAd 拉取 激励 广告 RewardedVideoAd 组件

激励视频广告

小程序广告流量主操作指引:文档地址
激励视频广告组件是由客户端原生的图片、文本、视频控件组成的,层级最高,会覆盖在普通组件上。

开发者可以调用 wx.createRewardedVideoAd 创建激励视频广告组件。该方法返回的是一个单例,该实例仅对当前页面有效,不允许跨页面使用。

广告创建

激励视频广告组件默认是隐藏的,因此可以提前创建,以提前初始化组件。开发者可以在小程序页面的 onLoad 事件回调中创建广告实例,并在该页面的生命周期内重复调用该广告实例。

let rewardedVideoAd = null
Page({
  onl oad() {
    if(wx.createRewardedVideoAd){
      rewardedVideoAd = wx.createRewardedVideoAd({ adUnitId: 'xxxx' })
      rewardedVideoAd.onLoad(() => {
        console.log('onLoad event emit')
      })
      rewardedVideoAd.onError((err) => {
        console.log('onError event emit', err)
      })
      rewardedVideoAd.onClose((res) => {
        console.log('onClose event emit', res)
      })
    }
  }
})

为避免滥用广告资源,目前每个用户每天可观看激励式视频广告的次数有限,建议展示广告按钮前先判断广告是否拉取成功。

显示/隐藏

激励视频广告组件默认是隐藏的,在用户主动触发广告后,开发者需要调用 RewardedVideoAd.show() 进行显示。

rewardedVideoAd.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))

拉取失败,重新拉取

如果组件的某次自动拉取失败,那么之后调用的 show() 将会被 reject。此时可以调用 RewardedVideoAd.load() 手动重新拉取广告。

rewardedVideoAd.show()
.catch(() => {
    rewardedVideoAd.load()
    .then(() => rewardedVideoAd.show())
    .catch(err => {
      console.log('激励视频 广告显示失败')
    })
})

如果组件的自动拉取是成功的,那么调用 load() 方法会直接返回一个 resolved Promise,而不会去拉取广告。

rewardedVideoAd.load()
.then(() => rewardedVideoAd.show())

监听用户关闭广告

只有在用户点击激励视频广告组件上的 关闭广告 按钮时,广告才会关闭。这个事件可以通过 RewardedVideoAd.onClose() 监听。

img

RewardedVideoAd.onClose() 的回调函数会传入一个参数 res,res.isEnded 描述广告被关闭时的状态。

属性 类型 说明
isEnded boolean 视频是否是在用户完整观看的情况下被关闭的,true 表示用户是在视频播放完以后关闭的视频,false 表示用户在视频播放过程中关闭了视频

开发者需要根据 res.isEnded 判断是否视频是否播放结束、可以向用户下发奖励。

rewardedVideoAd.onClose(res => {
    // 用户点击了【关闭广告】按钮
    if (res && res.isEnded) {
      // 正常播放结束,可以下发游戏奖励
    } else {
      // 播放中途退出,不下发游戏奖励
    }
})

注意事项

多次调用 RewardedVideoAd.onLoad()RewardedVideoAd.onError()RewardedVideoAd.onClose() 等方法监听广告事件会产生多次事件回调,建议在创建广告后监听一次即可,或者先取消原有的监听事件再重新监听。

标签:视频,rewardedVideoAd,拉取,激励,广告,RewardedVideoAd,组件
From: https://www.cnblogs.com/AtlasLapetos/p/18624365

相关文章

  • Banner 广告
    Banner广告小程序广告流量主操作指引:文档地址开发者可以使用ad组件创建Banner广告组件,Banner广告组件在创建后会自动拉取广告数据并显示。广告尺寸设置Banner广告不允许直接设置样式属性,默认宽度为100%(width:100%),高度会自动等比例计算,因此开发者可以设置广告外层组件......
  • 广告分析数据接口说明
    广告分析数据接口说明向所有成为流量主的公众号、小程序、小游戏开发者开放数据接口。通过数据接口,开发者可以获取与公众平台官网统计模块类似但更灵活的数据,还可根据需要进行高级处理。请注意:接口侧数据库中仅存储了2016年1月1日之后的数据,将无法查询到此前的数据,即使查到,也......
  • 广告预加载接口
    广告预加载接口基础库2.14.1开始支持,低版本需做兼容处理在小程序环境下,支持通过调用wx.preloadAd接口,提前加载广告数据,再后续创建对应广告标签ad,ad-custom时,会自动使用预加载的广告数据,省去创建广告标签时再次拉取广告的耗时。预加载示例wx.preloadAd([{unitId:......
  • 原生模板 广告
    原生模板广告小程序广告流量主操作指引:文档地址开发者可以使用ad-custom组件创建原生模板广告组件,原生模板广告组件在创建后会自动拉取广告数据并显示。广告尺寸设置原生模板广告不允许直接设置样式属性,默认宽度为100%(width:100%),高度会自动等比例计算,因此开发者可以设......
  • 人工智能短视频内容理解与生成技术在美团的创新实践14
     1.背景美团围绕丰富的本地生活服务电商场景,积累了丰富的视频数据。美团场景下的短视频示例上面展示了美团业务场景下的一个菜品评论示例。可以看到,视频相较于文本和图像可以提供更加丰富的信息,创意菜“冰与火之歌”中火焰与巧克力和冰淇淋的动态交互,通过短视频形式进......
  • 人工智能短视频内容理解与生成技术在美团的创新实践14
     1.背景美团围绕丰富的本地生活服务电商场景,积累了丰富的视频数据。美团场景下的短视频示例上面展示了美团业务场景下的一个菜品评论示例。可以看到,视频相较于文本和图像可以提供更加丰富的信息,创意菜“冰与火之歌”中火焰与巧克力和冰淇淋的动态交互,通过短视频形式进......
  • 人工智能短视频内容理解与生成技术在美团的创新实践1
     1.背景美团围绕丰富的本地生活服务电商场景,积累了丰富的视频数据。美团场景下的短视频示例上面展示了美团业务场景下的一个菜品评论示例。可以看到,视频相较于文本和图像可以提供更加丰富的信息,创意菜“冰与火之歌”中火焰与巧克力和冰淇淋的动态交互,通过短视频形式进......
  • 人工智能短视频内容理解与生成技术在美团的创新实践12
      1.背景美团围绕丰富的本地生活服务电商场景,积累了丰富的视频数据。美团场景下的短视频示例上面展示了美团业务场景下的一个菜品评论示例。可以看到,视频相较于文本和图像可以提供更加丰富的信息,创意菜“冰与火之歌”中火焰与巧克力和冰淇淋的动态交互,通过短视频形式进......
  • 音视频入门基础:MPEG2-TS专题(24)——FFmpeg源码中,显示TS流每个packet的pts、dts的实现
    =================================================================音视频入门基础:MPEG2-TS专题系列文章:音视频入门基础:MPEG2-TS专题(1)——MPEG2-TS官方文档下载音视频入门基础:MPEG2-TS专题(2)——使用FFmpeg命令生成ts文件音视频入门基础:MPEG2-TS专题(3)——TSHeader简介音......
  • 你对音视频领域感兴趣吗?
    我对音视频领域有浓厚的兴趣,特别是在前端开发方面。随着互联网技术的不断发展,音视频技术已经成为了人们日常生活中不可或缺的一部分,而前端开发则是实现音视频应用的重要一环。在音视频领域,前端开发涉及到多个方面,包括音视频流的采集、编码、传输、解码和播放等。这些技术不仅涉及......