广告。小程序/游戏在拥有一定流量且未出现严重违规的情况可以接入广告,详情请参考:《QQ 小程序-广告接入指引》
属性名 | 类型 | 默认值 | 必填 | 说明 | 版本 |
---|---|---|---|---|---|
unit-id | String | 是 | 广告单元 id,可在QQ 小程序管理后台的流量主模块新建 | ||
type | String | banner | 否 | 广告类型 | 1.5.0 |
ad-left | Number | 否 | type 为 feeds 时广告左边距(px),必须大于 0 | 1.5.0 | |
ad-top | Number | 否 | type 为 feeds 时广告上边距(px),必须大于 0 | 1.5.0 | |
ad-width | Number | 否 | type 为 feeds 时广告宽度(px),默认 100%,最大值为屏幕宽度,最小值为 265 | 1.5.0 | |
ad-height | Number | 否 | type 为 feeds 时广告高度(px),最小 85,最大 160 | 1.5.0 | |
block-size | Number | 1 | 否 | type 为 block 时请求积木广告数量(展示以实际拉取广告数量为准) | 1.15.0 |
block-orientation | String | landscape | 否 | type 为 block 时请求积木广告排列方向 | 1.15.0 |
bindsize | eventhandle | 否 | type 为 feeds 时广告实际宽高回调,event.detail = {width:296,height:150} | 1.4.0 | |
bindload | eventhandle | 否 | 广告加载成功的回调 | 1.4.0 | |
binderror | eventhandle | 否 | 广告加载失败的回调,event.detail = {errCode: 1002} | 1.4.0 | |
test-banner-type | String | three | 否 | 开发者工具下,type 为 banner 时,指定 banner 广告展示三图文还是单图 | 1.5.0 |
注 1:监听到 error 回调后,开发者可以针对性的处理,比如隐藏广告组件的父容器,以保证用户体验,但不要移除广告组件,否则将无法收到回调。
type 有效值:
值 | 说明 |
---|---|
banner | banner 广告 分 1 图和 3 图 1 文。3 图 1 文广告的背景色、文字颜色会根据祖先节点的背景色调整,分三种情况深色背景、浅色背景和白色背景 |
card | 卡片广告,1 图,可关闭 |
feeds | 自定义广告,可灵活控制广告上、左边距和宽高,以适应界面其他内容。可监听 size 事件获取实际宽高 |
block | 积木广告,把每个广告icon当做一块“积木”,可根据页面实际需求进行排列组合(横纵方向和1-5个数量可自定义) |
block-orientation 有效值:
值 | 说明 |
---|---|
vertical | 积木广告竖向排列 |
landscape | 积木广告横向排列 |
test-banner-type 有效值:
值 | 说明 |
---|---|
one | 1 图 |
three | 3 图 1 文 |
错误码说明
代码 | 异常情况 | 理由 | 解决方案 |
---|---|---|---|
1000 | 后端错误调用失败 | 该项错误不是开发者的异常情况 | 一般情况下忽略一段时间即可恢复。 |
1001 | 参数错误 | 使用方法错误 | 可以前往 q.qq.com 确认具体教程(小程序和小游戏分别有各自的教程,可以在顶部选项中,“设计”一栏的右侧进行切换。 |
1002 | 广告单元无效 | 可能是拼写错误、或者误用了其他 APP 的广告 ID | 请重新前往 q.qq.com 确认广告位 ID。 |
1003 | 内部错误 | 该项错误不是开发者的异常情况 | 一般情况下忽略一段时间即可恢复。 |
1004 | 无适合的广告 | 广告不是每一次都会出现,这次没有出现可能是由于该用户不适合浏览广告 | 属于正常情况,且开发者需要针对这种情况做形态上的兼容。 |
1005 | 广告组件审核中 | 你的广告正在被审核,无法展现广告 | 请前往 q.qq.com 确认审核状态,且开发者需要针对这种情况做形态上的兼容。 |
1006 | 广告组件被驳回 | 你的广告审核失败,无法展现广告 | 请前往 q.qq.com 确认审核状态,且开发者需要针对这种情况做形态上的兼容。 |
1007 | 广告组件被驳回 | 你的广告能力已经被封禁,封禁期间无法展现广告 | 请前往 q.qq.com 确认小程序广告封禁状态。 |
1008 | 广告单元已关闭 | 该广告位的广告能力已经被关闭 | 请前往 q.qq.com 重新打开对应广告位的展现。 |
ad
标签设置 qss 样式调整广告样式,以使广告与页面更融洽,但请遵循小程序流量主应用规范(待更新)。ad
标签禁止了 style 属性,type 为 feeds 时 ad-width、ad-height、ad-left、ad-right 可设置组件尺寸位置,优先级比样式高。ad
标签不会占用高度。ad
标签广告区域不支持触发 bindtap
等触摸相关事件,type 为 swip 时广告外的空白区域可利用触摸事件关闭广告。