菜单

iOS版SDK无填充或加载失败指引

iOS版SDK无填充或加载失败指引

1. 常见无填充问题排查思路

常见的无填充问题排查,可以参考以下方式:

    • 打开SDK日志,根据SDK请求日志,查看里面具体无填充的原因;
    • 通过Taku开发者后台的日志分析页面,查看具体无填充的原因;

常见无填充的错误问题如下:

    • Taku的appId与placementId不匹配;
    • 广告平台的appId与placementId不匹配;
    • 调用的API与广告位对应的广告形式不匹配;
    • 广告平台对应的自渲染、模板的配置与Taku后台不匹配;
    • 网络异常导致无法正常加载广告资源;

常见错误码及错误说明,请参考 错误码说明进行问题的排查确认。

1.1 Taku的appId、placementId不匹配

请检查集成时,可通过SDK打印的加载日志确认是否是匹配问题,并检查传入的Taku使用的appId和placementId是否正确。

1.2 广告源的appId、placementId不匹配

  1. 检查Taku后台该广告源的配置(打开SDK的日志,通过networkUnit字段可看到Taku后台配置的广告源参数,跟广告平台后台的配置比对是否一致)
  2. 检查代码中是否有单独初始化广告平台SDK的逻辑(项目中同时初始化两个不同的appid就会出现问题,保证初始化同一个appId即可)
  3. 检查是否开启了后台广告位的调试模式(由于调式模式的appId跟开发者广告源的appId不同,项目中同时初始化两个不同的appId就会出现问题,关闭Taku后台的调试模式后重试)
  4. 检查开屏广告是否有使用传入默认参数且传入了错误的应用以及广告位参数(传入错误时会导致使用错误的id初始化广告平台的SDK)

1.3 调用的API与广告位对应的广告形式不匹配

请根据实际请求的广告形式,确认调用API是否正确。

1.4 广告长时间无回调请求结果

请检查配置的waterfall列表,通过SDK日志确认具体哪个广告源长时间无返回

1.5 Meta广告无填充

测试Meta广告需要确保手机有安装Facebook客户端并且登录。bidding广告的测试请配置调试模式,具体见:

1.6 广告展示不出来

  1. 请打开 SDK的日志功能,检查广告是否加载成功
  • 查看控制台的日志,排查是否是某一家广告平台还是全部广告平台的问题
  • 在开发者后台,更改此广告位,仅开启有问题的那一家广告平台的广告源,然后在我们demo上换成开发者自己的那个广告位进行测试是否正常,然后广告位仅开启另一家有问题的广告平台的广告源,直到所有有问题的广告平台都测试过
    • 我们demo上正常:(说明广告源没有问题)下一步
    • 我们demo上也不正常:提供信息给我们
  • 使用其他测试机进行测试,排查是否是某一机型的问题
    • 所有测试机都有问题:(说明不是测试机型的问题)下一步
    • 某一测试机有问题:提供信息给我们

    以上均解决不了,提供信息给我们

    1.7 广告加载到收到回调的时间过长

    1. 检查网络是否正常;
    2. 检查各广告源集成是否正常;
    3. 广告位下配置了过多的广告源且广告源的填充率较低,SDK会顺序请求广告位下配置的各广告源的广告,这是一个耗时过程,如果有一家广告源能较快加载成功,SDK则会回调成功,如果广告位下所有广告源均失败,将耗费大量时间,SDK最后会回调失败。请优化广告位配置

    1.8 缺少依赖库导致广告加载失败

    可能会有各种因素导致您的应用程序加载广告失败,比如:

     💚💚 ATAdLogger(UA_6.2.30) Message:loadFail CallBack Fail::didFailToLoadADWithPlacementID:b62b420b0c5834 
    error:Error Domain=com.anythink.ATADLoadingErrorDomain Code=1009 "Adapter(ATAdColonyRewardedVideoAdapter) initialization failed" 
    UserInfo={NSLocalizedDescription=Adapter(ATAdColonyRewardedVideoAdapter) initialization failed, NSLocalizedFailureReason=The adapter not found} 💚
    
    ATRewardedVideoViewController::didFailToLoadADWithPlacementID:b62b420b0c5834 error:Error Domain=com.anythink.ATADLoadingErrorDomain 
    Code=1009 "Adapter(ATAdColonyRewardedVideoAdapter) initialization failed" 
    UserInfo={NSLocalizedDescription=Adapter(ATAdColonyRewardedVideoAdapter) initialization failed, NSLocalizedFailureReason=The adapter not found}

    该广告加载错误就是因为没有导入AdColonyAdapter和AdColony的SDK,所以我们需要添加这个平台的Adapter并引入他们的SDK到工程项目中。注意:要从加载失败的错误确认是缺少哪个adapter或者广告SDK,在管理后台--SDK下载界面勾选生成pod 依赖或者手动包导入到项目中。

    1.9 手动引入SDK,穿山甲请求失败,报请先初始化SDK后在加载

    Error Domain=com.buadsdk Code=-100 \"sdk init config is unfinished\" UserInfo={extra_reason=Please initialize SDK before requesting ads, NSLocalizedDescription=sdk init config is unfinished}

    请您确认下是否从我们官网获取并引入的SDK,如果有混淆机制,请不要混淆穿山甲的文件,否则会引起以下错误导致此问题:

    You need to replace the CSJAdSDK.bundle file with the x.x.x.x version 


    最近修改: 2025-05-30Powered by