小程序插入激励视频广告教程

2023-11-09 23:55:28

在小程序中添加激励视频广告

今天登陆小程序的后台，收到了官方通知，小程序激励式视频广告组件日前已上线，也就是说可以在小程序中插入激励视频广告了。

早在今年年初的微信公开课上，微信团队就曾透露「2019 年，微信小程序将在三方面发力商业化变现：小程序激励视频，插屏广告，个人小程序变现」，现在看来正在一步一步的实现。

激励式视频广告

用户在小程序中主动触发激励式广告，并达成奖励下发标准（完整播放视频广告，并手动点击“关闭广告”按钮），将获得该小程序下发的奖励。广告触发场景与奖励内容均由流量主自定义。

下面就教大家如何在小程序中添加视频激励广告。

开通小程序流量主的步骤请先参考这篇文章：小程序中开通流量主

1、新建广告位

进入小程序的后台，点击流量主菜单，选择广告位管理，点击新建广告位。

这里的广告位类型有两个，选择激励式视频，并输入广告位名称，主要用于区分，方便管理，最后点击确定。

创建成功后复制一下你的广告位 ID，并打开开发者工具。

2、插入广告代码

视频激励广告代码插入略微复杂，不像 banner 广告，直接获取广告组件代码插入即可显示。视频激励广告代码调用是 wx.createRewardedVideoAd 接口。接口返回一个单例对象，该对象仅对单个页面有效。多次创建，返回的是同一个激励式视频广告对象。

下面直接来看看是如何插入的：

首先在 js 文件中定义一个全局作用域的视频广告对象

// 在页面中定义激励视频广告对象
var videoAd = null;

Page({
    ...
})

由于广告对象是单例，且对单个页面有效，因此官方建议在页面加载后（onLoad 事件）中创建广告对象，并在该页面的生命周期内重复调用该广告对象。

因此在 onLoad 函数中调用广告接口，并监听广告关闭。

onLoad() {
  if (wx.createRewardedVideoAd) {
    // 加载激励视频广告
    videoAd = wx.createRewardedVideoAd({
      adUnitId: '你的 adUnitId'
    })
    //捕捉错误
    videoAd.onError(err => {
    // 进行适当的提示
    })
    // 监听关闭
    videoAd.onClose((status) => {
      if (status && status.isEnded || status === undefined) {
        // 正常播放结束，下发奖励
        // continue you code
      } else {
        // 播放中途退出，进行提示
      }
    })
  }
}

注意这里需要对错误进行捕捉，否则会报下面的错误。

然后，在合适的位置展示广告，例如我这在一个 button 的 tap 事件进行广告显示。

// button 点击事件
openVideoAd() {
  console.log('打开激励视频');
  // 在合适的位置打开广告
  if (videoAd) {
    videoAd.show().catch(err => {
      // 失败重试
      videoAd.load()
        .then(() => videoAd.show())
    })
  }
}

目前调试工具无法正常显示视频广告，打开手机调试，视频广告可以正常显示。

如果视频显示异常，可以参考下表，对应的异常代码都有解决方案。