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 |
fixed | boolean | -- | 否 | 广告是否在屏幕中固定展示 | 1.34.0 |
type | string | -- | 否 | 1.41.0 | |
scale | number | 100 | 否 | 广告的缩放比例，100 为标准尺寸 | 1.41.0 |
type 的合法值
值 | 说明 | 最低支持版本 |
video | 视频类型 | 1.41.0 |
large | 大图类型 | 1.41.0 |
lImg | 左图右文 | 1.41.0 |
rImg | 右图左文 | 1.41.0 |
type 属性宿主支持情况
各端在各个宿主对广告类型的支持情况如下：
iOS 端
值 | 今日头条 | 头条极速版 | 抖音 | 西瓜视频 | 皮皮虾 | 抖音火山版 | 抖音 lite 版 |
video | × | × | × | √ | × | × | × |
large | × | × | × | √ | × | × | × |
lImg | × | × | × | √ | × | × | × |
rImg | × | × | × | √ | × | × | × |
Android 端
值 | 今日头条 | 头条极速版 | 抖音 | 西瓜视频 | 皮皮虾 | 抖音火山版 | 抖音 lite 版 |
video | × | × | × | √ | × | × | × |
large | × | × | × | √ | × | × | × |
lImg | × | × | × | √ | × | × | × |
rImg | × | × | × | √ | × | × | × |
广告组件的
type 属性允许传入多个类型值（通过一个或多个空格隔开），以便字节跳动平台为你的小程序提供最适合的广告类型。type 与 scale 对应关系
广告组件具备展示多种类型广告的能力，并支持通过指定 scale 控制组件的显示大小。
广告类型（type）与缩放比例（scale）的关系见下表：
类型（type） | 缩放比例（scale）有效范围 | 说明 | 宿主支持情况 |
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 为最大样式 | 西瓜视频 |
简言之：
- •video、large、lImg、rImg 型广告宽度始终等于手机屏幕宽度，只能通过设置 scale 属性控制显示大小。
广告错误码说明
若发现广告组件未展示，可以通过 binderror 属性查看广告加载的错误码，以便定位具体原因。
广告错误码的详细说明见下表：
值 | 异常 | 说明 | 解决方案 |
1000 | 后端错误调用失败 | 该项错误不是开发者的异常情况 | 一般情况下忽略一段时间即可恢复 |
1001 | 参数错误 | 使用方法错误 | 请详看本文档 |
1002 | 广告单元无效 | 可能是拼写错误、或者误用了其他 APP 的广告 ID | |
1003 | 内部错误 | 该项错误不是开发者的异常情况 | 一般情况下忽略一段时间即可恢复 |
1004 | 无适合的广告 | 广告不是每一次都会出现，这次没有出现可能是由于该用户不适合浏览广告 | 属于正常情况，且开发者需要针对这种情况做形态上的兼容 |
1005 | 广告组件审核中 | 广告正在被审核，无法展现广告 | |
1006 | 广告组件被驳回 | 广告审核失败，无法展现广告 | |
1007 | 广告能力被禁用 | 广告能力已经被封禁，封禁期间无法展现广告 | |
1008 | 广告单元已关闭 | 该广告位的广告能力已经被关闭 | |
效果示例
video 型广告
视频广告的效果图。
large 型广告
大图广告的效果图。
lImg 型广告
左图右文广告效果图。
rImg 型广告
右图左文广告效果图。
扫码体验
代码示例
Bug & Tip
- •Tip：本组件为原生组件。
- •Tip：监听到
error 回调后，为了提升用户体验，开发者可进行针对性处 理，比如隐藏广告组件的父容器。- •Tip：
video、large、lImg、rImg 型广告宽度始终等于手机屏幕宽度，只能通过设置 scale 属性控制显示大小。
