优聚智汇

简体中文

English

简体中文

English

外观

Android 错误码 ​

概述 ​

本文档列出了优聚智汇 Android SDK 可能返回的错误码及其含义，帮助开发者快速排查和解决问题。

在 onLoadError 和 onAdError 回调中，开发者会收到 UjuException 对象，通过 error.code 和 error.message 获取错误信息。本文档列出了所有可能的错误码。

SDK 核心错误码 ​

以下错误码定义在 ErrorType 枚举中，是 SDK 对外暴露的核心错误码：

错误码枚举名含义可能原因解决方案
0SUCCESS成功操作成功-
1000UNKNOWN未知错误未知原因导致的错误联系技术支持并提供日志
1001INIT_ERROR初始化失败appId/appKey 错误、网络问题、配置异常检查 appId 和 appKey 是否正确，检查网络连接
1002CONFIG_ERROR配置参数错误UjuAdConfig 或 UjuAdInitConfig 参数缺失或格式错误检查配置参数是否完整且正确
1003BIDDING_ERROR竞价错误广告竞价流程异常检查广告位配置，确认竞价策略正确
1004PERMISSION_DENIED缺少必要权限AndroidManifest.xml 缺少必要权限声明补充 INTERNET、ACCESS_NETWORK_STATE 等权限
1005PARAM_ERROR无效的参数入参校验失败，如 placementId 为空检查传入参数是否有效
1030NETWORK_ERROR网络连接异常无网络连接或网络超时检查网络连接，稍后重试
2001LOAD_ERROR广告加载失败无广告填充、适配器异常、广告位配置错误检查广告位 ID，确认适配器已引入，稍后重试
2009SHOW_ERROR广告展示失败广告未加载成功就调用 show、状态错误确保 onLoadSuccess 后再调用 show，检查 isReady()
2010TIMEOUT操作超时广告请求或加载超时检查网络状况，适当增加超时时间或重试
2011NOT_FIND_ADAPTER未找到适配器对应广告网络的适配器未引入检查 build.gradle 是否引入了对应 ADN 的适配器依赖

ADX 自有广告源错误码段 ​

SDK 内部 ADX 自有广告源使用独立的错误码段，定义在 AdxErrorEnums 中：

错误码段类别说明
0成功ADX 请求成功
1xxx数据相关数据解析、数据格式等错误
2xxx视频相关视频素材加载、播放等错误
3xxx图片相关图片素材加载、渲染等错误
4xxx网络相关ADX 网络请求、连接等错误
5xxx上报相关事件上报、追踪等错误
6xxxDeeplink 相关深度链接跳转错误
9xxx通用错误其他未分类错误

错误处理最佳实践 ​

1. 区分 onLoadError 和 onAdError ​

  • onLoadError(error: UjuException, placementId: String)：广告加载阶段失败，常见错误码 1001/1002/1003/1030/2001/2011
  • onAdError(error: UjuException)：广告展示阶段失败，常见错误码 2009/2010

2. 错误日志记录 ​

kotlin
override fun onLoadError(error: UjuException, placementId: String) {
    // 记录错误码、错误信息和广告位ID，便于排查
    Log.e("UjuAd", "加载失败: code=${error.code}, msg=${error.message}, pid=$placementId")
}

override fun onAdError(error: UjuException) {
    // 记录展示阶段的错误
    Log.e("UjuAd", "展示失败: code=${error.code}, msg=${error.message}")
}

3. 重试机制 ​

  • 对于网络错误（1030）和超时（2010），可实现合理的重试机制
  • 设置重试间隔和最大重试次数，避免无限重试
  • 建议重试间隔 3-5 秒，最大重试 3 次

4. 常见问题排查 ​

现象可能错误码排查方向
SDK 初始化失败1001检查 appId/appKey/channel 是否正确
广告不加载2001/2011检查广告位 ID、适配器依赖是否引入
广告不展示2009确认 onLoadSuccess 后再 show，检查 isReady()
无填充2001正常现象，广告库存不足，稍后重试
网络错误1030检查网络连接
权限错误1004检查 AndroidManifest.xml 权限声明

联系技术支持 ​

如果您遇到无法解决的错误问题，可以通过以下方式联系技术支持：

  • 邮件：marco@ujuad.com
  • 工单：在优聚智汇开发者后台提交工单
  • 在线客服：通过官网联系在线客服

提供错误码、错误信息、发生环境和复现步骤，有助于技术支持更快地定位和解决问题。

相关链接 ​