# CustomAd.onError(function listener)

## 功能描述

监听原生模板广告错误事件。

## 参数

### function listener

原生模板广告错误事件的监听函数

#### 参数

##### Object res


```json
[
  {
    "属性": "errMsg",
    "类型": "string",
    "说明": "错误信息",
    "最低版本": ""
  },
  {
    "属性": "errCode",
    "类型": "number",
    "说明": "错误码",
    "最低版本": "[2.2.2](1003706)",
    "子项": [
      {
        "合法值": "1000",
        "说明": "后端接口调用失败"
      },
      {
        "合法值": "1001",
        "说明": "参数错误"
      },
      {
        "合法值": "1002",
        "说明": "广告单元无效"
      },
      {
        "合法值": "1003",
        "说明": "内部错误"
      },
      {
        "合法值": "1004",
        "说明": "无合适的广告"
      },
      {
        "合法值": "1005",
        "说明": "广告组件审核中"
      },
      {
        "合法值": "1006",
        "说明": "广告组件被驳回"
      },
      {
        "合法值": "1007",
        "说明": "广告组件被封禁"
      },
      {
        "合法值": "1008",
        "说明": "广告单元已关闭"
      },
      {
        "合法值": "2001",
        "说明": "模板渲染错误"
      },
      {
        "合法值": "2002",
        "说明": "模板为空"
      },
      {
        "合法值": "2003",
        "说明": "模板解析失败"
      },
      {
        "合法值": "2004",
        "说明": "触发频率限制"
      },
      {
        "合法值": "2005",
        "说明": "触发频率限制"
      }
    ]
  }
]
```

## 错误码信息与解决方案表

 错误码是通过onError获取到的错误信息。调试期间，可以通过异常返回来捕获信息。可以针对异常返回加上适当的监控信息辅助排查现网情况。

| 代码 | 异常情况 | 理由 | 解决方案 |
| ------ | -------------- | --------------- | -------------------------- |
| 1000  | 后端错误调用失败  | 该项错误不是开发者的异常情况 | 一般情况下忽略一段时间即可恢复。 |
| 1001  | 参数错误    | 使用方法错误 | 可以前往developers.weixin.qq.com确认具体教程（小程序和小游戏分别有各自的教程，可以在顶部选项中，“设计”一栏的右侧进行切换。|
| 1002  | 广告单元无效    | 可能是拼写错误、或者误用了其他APP的广告ID | 请重新前往mp.weixin.qq.com确认广告位ID。 |
| 1003  | 内部错误    | 该项错误不是开发者的异常情况 | 一般情况下忽略一段时间即可恢复。|
| 1004  | 无适合的广告   | 广告不是每一次都会出现，这次没有出现可能是由于该用户不适合浏览广告 | 属于正常情况，且开发者需要针对这种情况做形态上的兼容。 |
| 1005  | 广告组件审核中  | 你的广告正在被审核，无法展现广告 | 请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。|
| 1006  | 广告组件被驳回  | 你的广告审核失败，无法展现广告 | 请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。|
| 1007  | 广告组件被封禁  | 你的广告能力已经被封禁，封禁期间无法展现广告 | 请前往mp.weixin.qq.com确认小程序广告封禁状态。 |
| 1008  | 广告单元已关闭  | 该广告位的广告能力已经被关闭 | 请前往mp.weixin.qq.com重新打开对应广告位的展现。|
| 2001  | 模板渲染错误  | 渲染过程出现错误 | |
| 2002  | 模板为空  | 该广告位的广告能力已经被关闭 | |
| 2003  | 模板解析失败  | 该广告位的广告能力已经被关闭 | |
| 2004  | 触发频率限制  | 小程序启动一定时间内不允许展示原生模板广告 | |
| 2005  | 触发频率限制  | 距离小程序插屏广告或者激励视频广告上次播放时间间隔不足，不允许展示原生模板广告 | |