# 视频前贴广告

小程序广告流量主操作指引:文档地址
开发者可以在 video 组件中添加属性配置,创建小程序视频前贴广告组件,视频广告组件在创建后会自动拉取广告数据,视频播放前展示广告。

# 广告样式

展示样式在开发者所设置的video组件中,以16:9的比例,垂直或者水平居中

# 广告创建

video 组件中添加了以下广告相关的属性配置,设置ad-unit-id后可以展示对应广告

属性 类型 默认值 必填 说明
ad-unit-id string 广告单元id,可在小程序管理后台的流量主模块新建
bindadload eventhandle 广告加载成功的回调
bindaderror eventhandle 广告加载失败的回调,返回码同ad组件
bindadclose eventhandle 广告关闭的回调
bindadplay eventhandle 广告开始,结束播放的回调 event.detail = {type: 'begin/end'}

添加广告单元,绑定广告事件

<video 
  class="xxx"
  src="xxx"
  bindadplay="onAdplay"
  bindadload="onAdload"
  bindadclose="onAdclose"
  bindaderror="onAdError"
  ad-unit-id="xxx"
>
</video>

监听广告事件

Page({
  onAdplay(e) {
    console.log('onAdplay', e)
  },
  onAdload(e){
    console.log('onAdload', e)
  },
  onAdclose(e) {
    console.log('onAdclose', e)
  },
  onAdError(e) {
    console.log('onAdError', e)
  },
})

# 广告预加载

开发者可以调用 wx.preloadVideoAd 的方式进行广告的预加载


const adUnitId1 = 'xxx'
const adUnitId2 = 'xxx'
wx.preloadVideoAd([adUnitId1, adUnitId2])

# 错误码

错误码是通过bindaderror回调获取到的错误信息,前贴广告再普通广告组件ad错误码基础上新增了以下错误码。

代码 异常情况 解决方案
3001 命中频控策略 按照没有广告处理
3002 命中频控策略 按照没有广告处理
3003 命中频控策略 按照没有广告处理
3004 命中频控策略 按照没有广告处理

# 注意事项

1、支持视频预加载能力:文档地址

2、仅支持同层渲染模式下的video组件。

3、开发者可监听bindadplay事件获取广告播放状态,做出相应处理。

4、ad-unit-id不支持异步设置,只支持设置在wxml或者js文件的data属性里,通过setData设置的无效。

5、全屏模式下不展示视频前贴广告。