广告。小程序/游戏在拥有一定流量且未出现严重违规的情况可以接入广告,详情请参考:《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 重新打开对应广告位的展现。
# 注意
  1. 目前可以给 ad 标签设置 qss 样式调整广告样式,以使广告与页面更融洽,但请遵循小程序流量主应用规范(待更新)。
  2. ad标签禁止了 style 属性,type 为 feeds 时 ad-width、ad-height、ad-left、ad-right 可设置组件尺寸位置,优先级比样式高。
  3. 在无广告展示时,ad 标签不会占用高度。
  4. ad 标签广告区域不支持触发 bindtap 等触摸相关事件,type 为 swip 时广告外的空白区域可利用触摸事件关闭广告。