如何使用测试模式(Android)
简介
完成对TradPlus的集成后，开发者需要进行测试。为了方便开发者验证集成效果，TradPlus提供了测试模式。开发者在TradPlus后台配置测试模式后，直接测试。
一、前提条件
1.1 测试机为真机
广告平台不针对模拟器进行适配。例如：使用模拟器测试海外广告源，经常会因模拟器缺少某些库导致报错，该情况无法解决。
1.2 海外源需要能流畅访问谷歌的网络条件
- (1)海外源在国内流量很少，即使用测试模式也很难拉取到广告。
- (2)海外Bidding等广告源，必须要切换网络到海外，否则会因IP导致拉取不到下发策略，例如会出现：错误码返回“12，no config waterfall下发配置为空”的情况。
- (3)网络条件不好，也会导致请求超时。
1.3 获取设备ID
- (1)要在初始化成功后发起广告请求，才能拿到下发的配置，代码示例如下：
- (2)初始化TP SDK时，正确填入应用ID。应用ID错误会导致匹配不上。
Android平台
TradPlusSdk.setTradPlusInitListener(new TradPlusSdk.TradPlusInitListener() {
@Override
public void onInitSuccess() {
// 初始化成功，发起广告请求，才能拿到GAID等参数
}
});
TradPlusSdk.initSdk(context, "您在TradPlus平台创建的应用ID");
Unity平台
void Start()
{
TradplusAds.Instance().OnInitFinish += OnInitFinish;
//初始化SDK
TradplusAds.Instance().InitSDK("您在TradPlus平台创建 的应用ID");
}
void OnInitFinish(bool success)
{
// 初始化成功，发起广告请求，才能拿到GAID等参数
}
- (3)初始化成功后，Logcat过滤TradPlusLog，获取测试机的GAID、TpUserId：
2022-03-22 14:15:57.197 2437-2437/? I/TradPlusLog: Is eu.false
2022-03-22 14:15:57.197 2437-2437/? I/TradPlusLog: Is ca.false
2022-03-22 14:15:57.200 2437-2437/? I/TradPlusLog: SDK Initialized.
2022-03-22 14:15:59.201 2437-2437/? I/TradPlusLog: Publisher Gaid is 3e6d946a-6adb-4e3f-9e57-10ca1ad1abe1
2022-03-22 14:15:59.202 2437-2437/? I/TradPlusLog: Publisher TpUserId is UID-923ce357-373a-40f5-922f-16fe5915faaa
二、配置测试模式
2.1 进入设置页面
在 高级设置 ——> 测试模式 中，进入广告位的测试模式设置页面
2.2 添加测试设备
- 添加测试设备时，填写设备ID、设备名称、应用和广告网络
- 设备ID支持以下内容：Android支持GAID、OAID
2.3 切换到测试模式
- 添加测试设备后，重启应用
- 初始化SDK，收到初始化成功回调后，发起广告请求，切到测试模式（如果没有拉取成功，可以在请求一次）
三、确认是否成功开启测试模式
- LogCat过滤“TradPlusLog”来确认，如果有“----- TradPlus TestMode Is On ----- ”表明已经成功开启，否则将不会有Log打印（V7.7.0.1 及以上版本支持）
- 开发需注意测试完成后关闭测试模式，否则会一直下发测试模式中配置的广告
2022-03-22 15:01:37.209 7366-7753/? I/TradPlusLog: ----- TradPlus TestMode Is On -----
2022-03-22 15:01:37.209 7366-7753/? I/TradPlusLog: ----- Test Adsource PlacementId :TESTBANNER2-2508082 ----- // 广告平台的PlacementID
2022-03-22 15:01:37.209 7366-7753/? I/TradPlusLog: ----- Test ChannlName :vungle ----- //广告平台
四、广告源测试注意事项
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已自动声明权限
<manifest>
<application>
<!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
<meta-data
android:name="com.google.android.gms.ads.APPLICATION_ID"
android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
<!-- For Android S devices & GMA SDK version 20.3.0 or lower -->
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
</application>
</manifest>
4.3 说明
- 海外广告源，有些源即使开启测试模式，也要切换VPN以便可以填充更多资源多，否则也会经常NO_FILL。
- 注意说明的提醒，部分源仅大陆就能拉取到测试的广告素材；如果多次拉取失败，请根据说明切换VPN进行测试。
| 广告平台 | 说明 |
|---|---|
| Meta bidding | 海外，下发配置 ，欧美更容易填充 |
| Admob | 大陆 ，欧美会更容易填充 |
| Bigo | 美国 ，俄罗斯 |
| Google Ad Manager | 大陆 ，欧美会更容易填充 |
| AdColony | 大陆 ，欧美会更容易填充 |
| UnityAds | 大陆 |
| Tapjoy | 新加坡、美国 |
| LiftOff | 大陆 |
| LiftOff bidding | 海外，下发配置 ，欧美更容易填充 |
| Applovin | 大陆 ，美国会更容易填充 |
| IronSource | 大陆 |
| Chartboost | 大陆 ，美国会更容易填充 |
| Mintegral | 大陆 |
| Mintegral 海外bidding | 欧美，才会下发配置 |
| Mintegral 国内bidding | 大陆 |
| InMobi | 美国、新加坡 |
| DT Exchange | 新加坡 |
| 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 | 大陆 |