• ad
  • 错误码信息与解决方案表
    • 注意

    ad

    广告。小程序/游戏在拥有一定流量且未出现严重违规的情况可以接入广告，详情请参考：《QQ小程序-广告接入指引》ad - 图1

    属性名类型默认值必填说明版本
    unit-idString是广告单元 id，可在QQ 小程序管理后台ad - 图2的流量主模块新建
    typeStringbanner否广告类型1.5.0
    ad-leftNumber否type为feeds时广告左边距（px），必须大于01.5.0
    ad-topNumber否type为feeds时广告上边距（px），必须大于01.5.0
    ad-widthNumber否type为feeds时广告宽度（px），默认100%，最大值为屏幕宽度，最小值为2651.5.0
    ad-heightNumber否type为feeds时广告高度（px），最小85，最大1601.5.0
    bindsizeeventhandle否type为feeds时广告实际宽高回调，event.detail = {width:296,height:150}1.4.0
    bindloadeventhandle否广告加载成功的回调1.4.0
    binderroreventhandle否广告加载失败的回调，event.detail = {errCode: 1002}1.4.0
    test-banner-typeStringthree否开发者工具下，type为banner时，指定banner广告展示三图文还是单图1.5.0

    注 1：监听到 error 回调后，开发者可以针对性的处理，比如隐藏广告组件的父容器，以保证用户体验，但不要移除广告组件，否则将无法收到回调。

    type 有效值：

    值说明
    bannerbanner广告 分 1 图和 3 图 1 文。3 图 1 文广告的背景色、文字颜色会根据祖先节点的背景色调整，分三种情况深色背景、浅色背景和白色背景
    swip翻页广告，1 图 1 文，会覆盖整个小程序，显示、隐藏逻辑需开发者自行控制
    card卡片广告，1 图，可关闭
    feeds自定义广告，可灵活控制广告上、左边距和宽高，以适应界面其他内容。可监听size事件获取实际宽高

    test-banner-type 有效值：

    值说明
    one1 图
    three3 图 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时广告外的空白区域可利用触摸事件关闭广告。