Android SDK接入常见问题

1. 常见问题解决指南

1.1. 编译报错

1.1.1. 常见缺少库或SDK版本冲突

请开发者仔细阅读 SDK接入配置 ，补充缺少的配置，如更新SDK，请先确保旧版SDK完全删除，并重新引入SDK。

1.1.2. 混淆规则问题

如debug包正常，打release包时报错，通常为混淆规则问题，请根据 SDK接入配置 补充相关的资源混淆配置，如操作完后仍无法解决，请提供完整的打包输出日志，方便配合问题排查。

1.1.3. Single dex，方法数超过了65535

• 在build.gradle中添加以下配置：

defaultConfig {
    ...
    multiDexEnabled true
}

1.1.4. Default interface methods are only supported starting with Android N (--min-api 24) ···

• build.gradle中添加如下配置：

android {
    ...
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

1.2. 应用崩溃问题

请开发者确认崩溃的时机是什么？

• 加载就崩溃：排查是哪家广告平台、使用的是什么机型
• 广告回调触发时崩溃：请开发者检查在我们的广告回调中做了什么逻辑，全部屏蔽掉后，如果不再崩溃可确认是开发者自己的问题

如何获取崩溃日志：Android Studio中的Logcat选中此选项后，进行获取

1.3. 无广告填充或者无广告可展示问题

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

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

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

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

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

1.3.2. 广告加载失败和展示错误信息

失败信息	失败信息说明
no available ad	无广告
load ad time out	超时
slot ID type error	广告位类型错误
slot ID is invalid	无效的第三方广告位id
no available ad strategy	没有可用的瀑布流策略
sdk is not available	第三方sdk不可用：初始化失败
slot requests exceeded the limit	广告位请求次数超时段限制
material load failure	广告物料加载失败
exposure failure	广告曝光失败
render failure	渲染失败
video play failure	视频播放失败

1.3.3. 广告展示不出来

1、请打开SDK的日志功能，检查广告是否加载成功
根据log提供的广告平台错误码、错误信息查询接入文档第三方广告平台错误码
2、查看Debug log，排查是否是某一家广告平台还是全部广告平台的问题
3、在聚合管理后台，仅开启有问题的那一家广告平台的广告源，直到所有有问题的广告平台都测试过
4、使用其他测试机进行测试，排查是否是某一机型的问题
5、排查哪一种广告形式

• 激励视频、插屏广告：检查有问题的广告平台的AndroidManifest配置（一般是下载的SDK压缩包里面的部分文件没有配置到项目中导致的，请检查缺少的配置。开发者排查后解决不了的话，提供信息给我们
• 信息流广告、banner广告、开屏广告：（1）检查代码中加载广告前是否有按照文档设置了宽高；如果已经设置了宽高，转到（2）（2）请开发者使用Android Studio的Layout Inspector（Tools -> Layout Inspector）检查当前布局，确保广告View及其父View全部可见，检查广告View的宽高大小是否都大于0；