测试模式
简介#
完成对TradPlus的集成后，开发者需要进行测试。为了方便开发者验证集成效果，TradPlus提供了测试模式。开发者在TradPlus后台配置测试模式后，可以直接测试。
一. 前提条件#
开发者须根据以下情况开启测试模式1.1 测试机器必须为真机，不推荐使用安卓模拟器测试#
广告平台基本不针对模拟器进行适配。例如：使用模拟器测试海外广告源，经常会因模拟器缺少某些库导致报错，该情况无法解决。
1.2 海外源需要能流畅访问谷歌的网络条件#
- (1)海外源在国内流量很少，即使用测试模式也很少会拉取到广告。
- (2)海外Bidding等广告源，必须要切换网络到海外，否则会因IP导致拉取不到下发策略，例如会出现：错误码返回“12，no config waterfall下发配置为空”的情况。
- (3)网络条件不好，也会导致请求超时。
1.3 设置TradPlus TestDevice#
| 平台 | 代码 | 说明 |
|---|---|---|
| Android原生 | TestDeviceUtil.getInstance().setNeedTestDevice(true); | |
| Android原生 | TestDeviceUtil.getInstance().setNeedTestDevice(true,testmodeId); | V7.8.0.1开始支持，参数2为设备ID。 可参考下文《获取GAID》，可直接将Logcat输出的“Gaid is”填入. |
| UnityAndroid | TradPlusAndroid.SetNeedTestDevice(true); | |
| UnityAndroid | TradPlusAndroid.SetNeedTestDevice(true,testmodeId); | 同上 |
- 开发在初始化TP SDK前调用此API。正式上线前，开发者要多次确认已经注释或删除TestDevice API。
1.4 获取GAID（添加设备ID是GAID）#
- (1)必须要在初始化成功后load广告才能拿到下发配置好的策略（TradPlus SDK在初始化结束后才能拿到GAID）。
- (2)TradPlus后台也支持使用OAID或者TpUserId。OAID需要开发者自行获取并设置,TpUserId每次清除缓存后会重新生成。
- (3)开发者可通过设置TradPlus TestDevice API，简单运行项目后，LogCat过滤“TradPlusLog”可获取测试机的GAID、TPUserID。（V7.7.0.1 及以上版本支持）
如下Publisher Gaid is后为测试机的GAID、Publisher TpUserId is后为测试机TpUserId：
1.5 正确初始化TradPlus#
(1)开发者需要确保初始化TradPlus SDK时，填入的是正确的APPID。例如：如果测试模式选择的APPID和初始化的APPID不一致，那么配置的测试ID会无法正常下发。
(2)必须要在初始化后才能拿到GAID、OAID等参数。
二.后台配置测试模式#
2.1 进入测试模式设置页面#
在 高级设置 ——> 测试模式 中，进入广告位的测试模式设置页面
2.2 添加测试设备#
- 添加测试设备时，填写设备ID、设备名称、应用和广告网络
- 设备ID支持以下内容：Android支持GAID、OAID （V7.7.0.1 及以上版本支持获取GAID，请看上文获取《GAID》部分）
- 注意事项：
- 添加或者修改测试模式后5分钟后生效，测试完成后请关闭设备的测试模式
- 由于TP SDK下发策略存在缓存，为验证效果，建议添加测试模式后将系统时间增加1小时进行测试或者清除应用缓存
- **当`onAdFailed`或者`oneLayerLoadFailed`出现“包名不配置的”报错信息时，需要开发者替换包名：com.QuickLoad.MergeCannonDefense**
举例： 如下图：配置广告网络Facebook的测试模式,并且对应的添加所需广告类型
三. 确认是否成功开启测试模式#
- 简单运行项目后，LogCat过滤“TradPlusLog”来确认，如果有“----- TradPlus TestMode Is On ----- ”表明已经成功开启，否则将不会有Log打印（V7.7.0.1 及以上版本支持）
- 如果“添加测试设备”这步操作正确，但还是没有成功开启测试模式，可以卸载APP重新安装，拉取最新配置。
- 开发需注意测试完成后关闭测试模式，否则会一直下发测试模式中配置的广告
四.广告源测试注意事项#
4.1 Meta(FaceBook）#
Meta测试情况需要满足较多条件，想要了解更多请跳转到官方说明查看Audience Network 集成检查表和广告请求错误代码，以下简单描述注意事项 ：
- (1)测试设备上安装并登录 Facebook 应用程序；
- (2)检查是否已满足上文《配置测试模式的前提条件》，例如：真机、海外网络、设置TestDevice等
4.2 Google AdMob#
- 将您的 AdMob 应用 ID 添加到应用的 AndroidManifest.xml 文件中。应用 ID可以在 AdMob 界面中找到。正式上线前替换成您自己账户APP ID，下文代码仅供测试使用。如有疑问，请看官方说明Set up your app in your AdMob account
- AdMob 20.3.0 或更低版本，并且以 Android S 为目标平台的应用，则必须在 AndroidManifest.xml 文件中添加 com.google.android.gms.permission.AD_ID 权限
- AdMob 20.4.0 或更高版本，AdMob SDK已自动声明权限
4.3 说明#
- 海外广告源，有些源即使开启测试模式，也要切换VPN以便可以填充更多资源多，否则也会经常NO_FILL。
- 注意说明的提醒，部分源仅大陆就能拉取到测试的广告素材；如果多次拉取失败，请根据说明切换VPN进行测试。
| 广告平台 | 说明 |
|---|---|
| Meta bidding | 欧美，才会下发配置 |
| Admob | 大陆 ，欧美会更容易填充 |
| Google Ad Manager | 大陆 ，欧美会更容易填充 |
| AdColony | 大陆 ，欧美会更容易填充 |
| UnityAds | 大陆 |
| Tapjoy | 新加坡、美国 |
| Vungle | 大陆 |
| Vungle bidding | 欧美，才会下发配置；美国、德国容易填充 |
| Applovin | 大陆 ，美国会更容易填充 |
| IronSource | 大陆 |
| Chartboost | 大陆 ，美国会更容易填充 |
| Mintegral | 大陆 |
| Mintegral 海外bidding | 欧美，才会下发配置 |
| Mintegral 国内bidding | 大陆 |
| InMobi | 美国、新加坡 |
| Fyber | 新加坡 |
| StartApp | 大陆 ，美国会更容易填充 |
| Maio | 日韩、新加坡会更容易填充 |
| Criteo | 大陆，俄罗斯或美国会更容易填充 |
| Mytarget | 俄罗斯 、新加坡 |
| Mytarget 海外bidding | 俄罗斯 、新加坡，才会下发配置 |
| Ogury | 大陆 ，欧美会更容易填充 |
| Appnext | 大陆 ，欧美会更容易填充 |
| Kidzo | 大陆 ，美国会更容易填充 |
| Smaato | 大陆 ，美国会更容易填充 |
| Pangle海外 | 日韩 |
| Pangle海外 Bidding | 日韩，才会下发配置 |
| 华为海外 | 日本，需使用华为测试机 |
| 华为国内 | 大陆，需使用华为测试机 |
| GDT | 大陆 |
| GDT Bidding | 大陆，需要改包名“com.QuickLoad.MergeCannonDefense” |
| Toutiao国内 | 大陆 |
| Klevin游可赢 | 大陆 |
| Sigmob | 大陆 |
| Sigmob Bidding | 大陆 |
| Youdao | 大陆 |
| Kuaishou | 大陆 |
| Baidu | 大陆 |