如何使用测试模式(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	大陆，欧美会更容易填充
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	大陆