Skip to content

错误码汇总 ​

本文汇总 DeepAdx SDK 聚合层对外暴露的错误码,iOS 与 Android 已统一为 2000–2017,便于接入方在 onAdFailed / ad_loadFailure 等回调中跨端排查问题。

说明

  • iOS:错误通过 NSError 返回,domain 为 com.deepadx.error,code 为下表数值;userInfo[@"desc"] 为英文描述。
  • Android:错误通过 DeepAdxError 返回,调用 getErrorCode() / getErrorMessage() 获取码与说明(码值为字符串 "2000"–"2017")。
  • 各广告渠道(CSJ、GDT、GG 等)的原始错误码不会单独作为聚合码对外暴露;单渠道失败信息记录在日志或 msg 中,全部渠道均无可用广告时统一返回 2006。

聚合层错误码(2000–2017,iOS / Android 通用) ​

错误码英文描述(iOS desc / Android msg 基准)含义常见原因 / 处理建议
2000appID is emptyApp ID 为空或错误检查初始化是否传入 App ID,是否与平台一致
2001Ad Info request failed广告信息请求失败网络异常、服务端不可达;检查网络与 App ID
2002Ad Info is empty广告信息为空平台未配置该广告位或 placementId 错误
2003Ad Info parsing failed广告信息解析失败服务端返回数据异常,联系技术支持
2004Rules Info is empty策略为空广告位未配置投放策略
2005Suppliers sorts Info is empty策略渠道排序为空策略中未配置可用渠道顺序
2006All channels execution failed全部渠道执行失败各渠道均未返回可用广告;查看 msg 中末渠道详情
2007Suppliers is empty渠道配置为空未配置任何广告渠道
2008The request exceeds the set total time请求超出设定总时长整体加载超时,可检查网络或调大超时配置
2009Exceeded maximum impression limit展示超出最大限制达到平台配置的展示上限(频控)
2010The prerequisites to load/display ads are not met加载/展示条件不足Activity/VC 无效、容器为空、广告未 ready
2011view controller does not exist视图控制器不存在Activity/VC 已释放或未设置
2012no ads无广告返回渠道无填充(No Fill),属常见业务情况
2013Block display ads地区屏蔽当前地区被平台策略屏蔽展示
2014Failed to build ad object构建广告对象失败渠道返回数据为空或模板渲染失败;策略尚未就绪或暂无可用的渠道配置时也可能返回此码
2015Ad display interval limit展示间隔限制两次展示间隔过短,触发频控
2016Other error其他错误未分类异常或单渠道原始错误(见 msg)
2017environment mismatch环境不匹配测试/正式环境或包名与平台配置不一致

第三方渠道原始错误 ​

加载过程中,单渠道失败不会立即触发 onAdFailed / ad_loadFailure,SDK 会继续尝试下一渠道。

场景iOSAndroid
单渠道失败记录在日志记录在 Logcat;msg 中可含渠道原始错误信息
全部渠道失败回调 2006回调 2006,msg 含末渠道详情
GG No Fill(原始码 3)汇总为 2006 或 2012汇总为 2006,原始码 3 可在 msg 中查看

常见渠道原始码参考(GG) ​

原始码含义处理建议
0Internal error多为网络或 Google 服务异常
2Network error检查设备网络、防火墙
3No fill无填充,属正常情况,可稍后重试
5请求超时网络延迟过高

频控与策略未就绪 ​

频控(2009 / 2015) ​

某一渠道因频控被跳过时,SDK 会静默尝试下一渠道;仅当全部渠道均不可用时才回调失败,通常返回 2006。

策略尚未配置或未就绪 ​

首次加载前若广告位策略为空、尚未拉取完成,或尚未配置任何渠道,不会一律误报 2006,常见对应关系如下:

情况错误码
广告位策略为空2004
策略中无渠道排序2005
未配置任何渠道2007
策略已拉取但仍无法构建广告2014

地区被平台屏蔽时,对外错误码为 2013。


回调与排查建议 ​

iOS ​

objc
- (void)ad_loadFailure:(NSError *)error withAdsType:(adsType)adsType {
    NSLog(@"code=%ld desc=%@", (long)error.code, error.userInfo[@"desc"]);
}
  • 不要在「单渠道中途失败」时立即销毁广告对象,避免中断后续渠道尝试。
  • 最终失败请关注 2006、2012、2008 等汇总类错误。

Android ​

java
@Override
public void onAdFailed(DeepAdxError error) {
    Log.e("DeepAdx", error.toString());
    // [DeepAdxError] errorCode = 2006 ; errorMsg = All channels execution failed; last: ...
}
  • 频控命中时单渠道可能不回调失败,属预期行为。
  • 无填充不代表集成错误,可检查测试设备与广告位配置。

更多场景说明见 Q&A。仍无法定位问题时,请携带 完整错误码、placementId、渠道日志 联系 技术支持。

DeepAdx SDK 官方文档