广告组件

ad

基础库 1.19.0 开始支持本组件。

广告组件。


属性说明

属性类型默认值必填说明最低支持版本
unit-idstring广告位 id,必填。需要预先在「小程序管理后台 > 流量主模块」配置生成。1.19.0
bindloadeventhandle广告加载成功的回调方法1.19.0
binderroreventhandle广告加载失败的回调方法,具体的错误信息可以参考下方的广告错误码说明1.26.2
bindcloseeventhandle广告关闭的回调方法1.31.0
ad-intervalsnumber广告自动刷新的间隔时间,只对 banner 型广告生效。单位为秒,参数值必须大于等于 30(该参数不传入时 banner 广告不会自动刷新)1.32.1
fixedboolean广告是否在屏幕中固定展示1.34.0
typestring"banner"广告的类型,具体类型有:banner、video(视频)、large(大图)、lImg(左图右文)、rImg(右图左文),默认值为 banner1.41.0
scalenumber100广告的缩放比例,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 型广告的宽度受 css 样式影响
  • video、large、lImg、rImg 型广告宽度始终等于手机屏幕宽度,只能通过设置 scale 属性控制显示大小。

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

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


广告错误码说明

若发现广告组件未展示,可以通过 binderror 属性查看广告加载的错误码,以便定位具体原因。

下方表格是对广告错误码的详细说明。

异常说明解决方案
1000后端错误调用失败该项错误不是开发者的异常情况一般情况下忽略一段时间即可恢复
1001参数错误使用方法错误查看 ad 组件文档
1002广告单元无效可能是拼写错误、或者误用了其他 APP 的广告 ID
1003内部错误该项错误不是开发者的异常情况一般情况下忽略一段时间即可恢复
1004无适合的广告广告不是每一次都会出现,这次没有出现可能是由于该用户不适合浏览广告属于正常情况,且开发者需要针对这种情况做形态上的兼容
1005广告组件审核中广告正在被审核,无法展现广告
1006广告组件被驳回广告审核失败,无法展现广告
1007广告能力被禁用广告能力已经被封禁,封禁期间无法展现广告
1008广告单元已关闭该广告位的广告能力已经被关闭


效果示例

banner 型广告

banner 广告的效果图。

video 型广告

视频广告的效果图。

large 型广告

大图广告的效果图。

lImg 型广告

左图右文广告效果图。

rImg 型广告

右图左文广告效果图。


代码示例

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


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号

意见反馈
返回顶部