Skip to main content

如何使用测试模式

简介#

在完成对TradPlus的集成后,开发者需要对所聚合的广告平台和广告类型进行测试。为了方便开发者验证集成效果,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”填入.
UnityAndroidTradPlusAndroid.SetNeedTestDevice(true);
UnityAndroidTradPlusAndroid.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:

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

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 及以上版本支持)

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大陆 ,欧美会更容易填充
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大陆