常见问题排查指引

1. 集成疑问及自测指引

1.1 集成指引

请参照集成文档的说明，完成SDK的引入配置及API调用，如对集成文档有疑问，可参考 Taku下载界面中的对外demo，建议集成时选择最新版SDK。

1.2 测试指引

为方便方便测试广告及排查相关的问题，请参考 如何测试广告，建议打开SDK日志，并通过日志进行相关问题的排查。

1.3 查看SDK的版本

• Taku SDK版本号：可调用[[ATAPI sharedInstance] version];

1.4 查看广告平台SDK的日志

SDK初始化之前调用此方法：[ATAPI setLogEnabled:YES]; 在Xcode中查看 请参考 Taku SDK日志 打开SDK的日志

1.5 常见错误码

为方便排查，SDK提供了常见错误码及错误说明，请参考 错误码说明及第三方广告平台错误码&常见问题进行问题的排查确认。

1.6 获取设备id（测试模式、流量分组）

• SDK初始化前调用此方法：[ATAPI setLogEnabled:YES]; 在Xcode进行查看

2. 常见分类问题解决指引

2.1 编译错误问题及上架问题

• 参考 编译及上架问题说明

2.2 广告填充失败或无广告可展示问题

• 参考 广告无填充问题说明
• 参考 原生Native广告异常问题说明
• 横幅Banner广告展示异常： 参考 横幅Banner广告异常问题说明
• 开屏展示异常： 参考 开屏异常问题说明
• 激励视频&插屏广告展示异常： 参考 激励视频&插屏广告异常问题说明

3. SDK相关后台配置常见问题

3.1 配置没有生效（后台配置、测试模式、流量分组）

1、后台更改配置没有生效？

• 后台配置会在几秒到几分钟内生效，但是SDK本地会有半小时缓存，如果需要立马测试，请清除应用数据、重装或者将时间调后一小时
• 清除应用数据、重装等还是没有生效的情况，可能是后台配置还没有生效，请多等待几分钟后，重新清除应用数据或者重装后再重试

2、测试模式没有生效？

• 请检查Taku后台配置的设备id是否正确，IDFA、IDFV需从我们SDK的log获取
• 参考上面第一点

3、流量分组没有生效？

• 参考第一点
• 如果是配置了自定义规则的情况，请检查代码中是否已经正确传入自定义规则，可在代码中打印出key、value进行排查
• 如果是配置了设备id的情况，请检查Taku后台配置的设备id是否正确，IDFA、IDFV需从我们SDK的log获取

3.2 并行请求数、自动请求广告功能（Taku后台广告位-高级设置）

• 并行请求数：当广告频繁显示，播放后需要立即播放下一个广告时，并行请求数可以适当调整，一般为2〜3。 过多的并行请求将占用带宽并影响用户体验。 在展示广告时，将根据广告源的排序优先展示有缓存的广告。
• 自动请求广告：关闭广告后，Taku SDK会针对此广告位自动调用一次load方法，加载的结果不会回调给外部，且加载失败后不会进行重试。 建议开发人员自己实现此逻辑，未实现此逻辑的开发者可打开此功能。

3.3 针对某些用户、设备、地区等下发不同的广告源

• 参考流量分组说明

3.4 集成优量汇广告造成的后台音乐被中断的情况处理。

可以在展示广告之前调用优量汇广告平台的API，确保播放广告的时候，后台音乐不会被中断，代码如下：

#import <GDTMobSDK/GDTSDKConfig.h>

[GDTSDKConfig enableDefaultAudioSessionSetting:YES];