广告组件
ad
基础库 1.19.0 开始支持本组件。
广告组件。
属性说明
属性 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
---|---|---|---|---|---|
unit-id | string | 是 | 广告位 id,必填。需要预先在「小程序管理后台 > 流量主模块」配置生成。 | 1.19.0 | |
bindload | eventhandle | 否 | 广告加载成功的回调方法 | 1.19.0 | |
binderror | eventhandle | 否 | 广告加载失败的回调方法,具体的错误信息可以参考下方的广告错误码说明 | 1.26.2 | |
bindclose | eventhandle | 否 | 广告关闭的回调方法 | 1.31.0 | |
ad-intervals | number | 否 | 广告自动刷新的间隔时间,只对 banner 型广告生效。单位为秒,参数值必须大于等于 30(该参数不传入时 banner 广告不会自动刷新) | 1.32.1 | |
fixed | boolean | 否 | 广告是否在屏幕中固定展示 | 1.34.0 | |
type | string | "banner" | 否 | 广告的类型,具体类型有:banner、video(视频)、large(大图)、lImg(左图右文)、rImg(右图左文),默认值为 banner | 1.41.0 |
scale | number | 100 | 否 | 广告的缩放比例,100 为标准尺寸 | 1.41.0 |
详细说明
广告组件具备展示多种类型广告的能力,并支持通过指定 scale 控制组件的显示大小。
下方的表格将说明广告类型(type)与缩放比例(scale)的关系。
类型(type) | 缩放比例(scale)有效范围 | 说明 |
---|---|---|
banner | 无 | 该类型广告宽度由 CSS 样式决定,宽度范围是屏幕宽度的80%-100% |
video | 90-100 110 | 视频广告,该类型广告宽度是屏幕宽度的 100%,100 为标准样式,110 为通屏样式 |
large | 90-100 | 大图广告,该类型广告宽度是屏幕宽度的 100%,100 为标准样式,90 为最小样式 |
lImg | 100-150 | 左图右文广告,该类型广告宽度是屏幕宽度的 100%,100 为标准样式,150 为最大样式。容易看错,首字母是 l(L) |
rImg | 100-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>