ad

本组件从基础库版本 1.19.0 开始支持

用于在小程序中提供一个 广告组件。

属性类型说明基础库版本
unit-idString广告位 id,必填。需要预先在「小程序管理后台 > 流量主模块」配置生成。1.19.0
bindloadeventHandler广告加载成功的回调方法1.19.0
binderroreventHandler广告加载失败的回调方法,具体的错误信息可以参考广告错误码说明1.26.2
bindcloseeventHandler广告关闭的回调方法1.31.0
ad-intervalsnumber广告自动刷新的间隔时间,单位为秒,参数值必须大于等于 30(该参数不传入时 banner 广告不会自动刷新)1.32.1
fixedboolean广告是否在屏幕中固定展示1.34.0
typestring广告的类型,具体类型有:banner、video、large、lImg、rImg,默认值为 banner1.41.0
scalenumber广告的缩放比例,100 为标准尺寸1.41.0

详细说明

广告组件具备展示多种类型广告的能力,并支持通过指定 scale 控制组件的显示大小。

下方的表格将说明广告类型(type)与缩放比例(scale)的关系。

类型(type)缩放比例(scale)有效范围说明
banner该类型广告宽度由 CSS 样式决定,宽度范围是屏幕宽度的80%-100%
video90-100 110视频广告,该类型广告宽度是屏幕宽度的 100%,100 为标准样式,110 为通屏样式
large90-100大图广告,该类型广告宽度是屏幕宽度的 100%,100 为标准样式,90 为最小样式
lImg100-150左图右文广告,该类型广告宽度是屏幕宽度的 100%,100 为标准样式,150 为最大样式。容易看错,首字母是 l(L)
rImg100-150右图左文广告,该类型广告宽度是屏幕宽度的 100%,100 为标准样式,150 为最大样式

可以看出 banner 类型同其它类型相比是有区别的。

广告组件的 type 属性允许传入多个类型值,以便字节跳动平台为你的小程序提供最适合的广告类型。

<!--多类型示例--->
<ad type="video large lImg rImg" scale="110 90 150 130"></ad>

视频广告(标准)

大图广告(标准)

左图右文、右图左文广告(标准)

代码示例

<!--基础示例-->
<view>
  <ad
    unit-id="371e6m5eo89h576679"
    bindload="adloadhandler"
    binderror="aderrorhandler"
    bindclose="adclosehandler"
  ></ad>
</view>
点击纠错