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	--	否	广告的类型，详见 type 的合法值	1.41.0
scale	number	100	否	广告的缩放比例，100 为标准尺寸	1.41.0

各端在各个宿主对广告类型的支持情况如下：

iOS 端

Android 端

广告组件的 type 属性允许传入多个类型值（通过一个或多个空格隔开），以便字节跳动平台为你的小程序提供最适合的广告类型。

广告组件具备展示多种类型广告的能力，并支持通过指定 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	广告单元已关闭	该广告位的广告能力已经被关闭