其他功能介绍

关闭SDK自动加载功能

激励，插屏和原生广告类型默认有自动加载功能，以下提供的是关闭方法。

Android原生

• 创建广告位对象前调用

Map<String, Object> settingParam = new HashMap<>();
String[] unitIds = {"广告位1","广告位2"};
settingParam.put("autoload_close",unitIds);
TradPlusSdk.setSettingDataParam(settingParam);

iOS原生

• 创建广告位对象前调用

[TradPlus sharedInstance].settingDataParam = @{@"autoload_close":@[@"广告位1"，@"广告位2"]};

Unity平台

• 请求广告前调用

Dictionary<string, object> settingMap = new Dictionary<string, object>();
string[] unitIds = {"广告位1","广告位2"};
settingMap.Add("autoload_close", unitIds);
TradplusAds.Instance().SetSettingDataParam(settingMap);

Flutter平台

• 请求广告前调用

Map settingMap = {"autoload_close": "广告位1","autoload_close":"广告位2"};
TPSDKManager.setSettingDataParam(settingMap);

鸿蒙平台

• 请求广告前调用

let localParams = new Map<string,Object>()
let array = new Array<string>("广告位1","广告位2","广告位3")
localParams.set("autoload_close", array)
TradPlus.setSettingDataParam(localParams);

Google Admob 支持沉浸式展示

• V13.1.0.1 + 开始支持
• 支持Admob激励、插屏、开屏类型
• 需要在请求广告前调用，以开屏举例：

Android示例代码：

int immersiveMode = 1；// 1 开启  默认关闭
Map<String, Object> mLocalExtras = new HashMap<>();
mLocalExtras.put("immersive_mode",immersiveMode);
TPSplash.setCustomParams(mLocalExtras);

TPSplash.loadAd(adContainer);

Unity示例代码：

int immersiveMode = 1；// 1 开启  默认关闭

TPSplashExtra extra = new TPSplashExtra();
Dictionary<string, object> localParams = new Dictionary<string, object>();
localParams.Add("immersive_mode", immersiveMode); 
extra.localParams = localParams;

//请求广告
TradplusSplash.Instance().LoadSplashAd("在TP平台创建的广告位ID", extra);

关闭和触发过期检测

• V6.9.1新增API , 广告位对象创建后调用，这两个方法对全局设置有效。
• 为防止游戏过程中补充过期广告会占用带宽，可以调用setAutoExpiration()，传false关闭每隔5分钟自动过期检测。
• 如果调用setAutoExpiration()关闭过期检测，那么在游戏即将展示广告前要调用checkAutoExpiration()来触发一次广告过期检测。

平台	方法	说明
Android	TradPlusSdk.setAutoExpiration(false)	关闭每隔5分钟自动过期检测。 默认true，将自动进行广告过期检测
Android	TradPlusSdk.checkAutoExpiration()	可主动触发过期检测(如有失效广告会触发加载）

是否访问国内服务器

• V7.0.40.1新增API， 初始化SDK前调用API
• 用于选择TradPlus国内服务器还是海外服务器的。一般不需要设置。除非有特殊需求，流量只能在国内走，才需要设置。

平台	方法	说明
Android	TradPlusSdk.setCnServer(true)	默认false，访问海外服务器； true，访问国内服务器

关闭翻转显示广告源信息

• V8.5.0.1支持，仅激励视频和插屏。
• 默认开启，关闭传false。
• 功能介绍：在广告展示时，快速翻转手机2次，在屏幕边缘出现TradPlus的logo，点击logo可看到展示广告源的相关信息，方便快速定位问题。

TPSensorManager.getInstance().setOpenSensor(false);

设置OAID

部分广告平台需要oaid才能更好变现。 SDK默认不获取OAID，如果要提高收入有如下两种方案设置OAID：

方案一:开发者获取传给TP

• 创建广告位对象前设置

TradPlusSdk.setDevOAID(context,"开发者自行获取的oaid");

方案二:TP来获取

• SDK是初始化结束后才会获取OAID,可能部分场景来不及获取
• V10.2.0.1+ 支持
• 后台配置，在 TradPlus后台中，选择 高级功能 > Oaid管理 ，点击 “添加配置”，选择需要开启的应用后点击保存

设置UID2

• Android V10.1.0.1+开始支持
• 在初始化TPSDK前设置
• 将获取的UID2Token传给TradPlus

UserDataInfo userDataInfo = new UserDataInfo();
userDataInfo.setAdvertisingToken(token);
TPSettingManager.getInstance().setUserDataInfo(userDataInfo);

如何获取 app set ID

官方地址 https://developer.android.com/identity/app-set-id#scope

• TradPlus V15.0.0.1+ 支持
• 接入 play-services-appset V16.1.0 版本

dependencies {
    implementation 'com.google.android.gms:play-services-appset:16.1.0'
}

TP获取

• Gradle 配置

dependencies {
   implementation 'com.tradplusad:tradplus-appset:1.0.1'
}

• 初始化SDK后调用,TP会获取AppsetId并回传给TradPlus SDK

DataManager.getInstance().getAppSetId(this);

开发者获取

• 获取后需要传给TradPlus

try {
    AppSetIdClient client = AppSet.getClient(context);
    Task<AppSetIdInfo> task = client.getAppSetIdInfo();
    task.addOnSuccessListener(new OnSuccessListener<AppSetIdInfo>() {
        @Override
        public void onSuccess(AppSetIdInfo info) {
              String id = info.getId();
              // 将获取的appsetId传给TP
              TradPlusSdk.setAppSetId(id);
        }
    });
}catch(Throwable throwable) {
}

设置指定平台展示上限

• V13.4.10.1 开始支持
• 该设置为应用级别的频次限制，时间为每天
• 创建广告位对象前设置

设置规则

ArrayList<TPPlatform> tpPlatforms = new ArrayList<>();
// Meta 平台 ，每天展示3次
tpPlatforms.add(new TPPlatform(TPPlatformId.META.getId(),3));
TradPlusSdk.setPlatformLimit(tpPlatforms);

清空

TradPlusSdk.setPlatformLimit(null);

屏蔽指定平台的请求

• V14.6.0.1 开始支持
• 请求广告前设置
• 广告平台的平台id，根据文档三方广告网络编号表 填入
• 多次设置setForbidNetworkIdList(List<String> networkIdList)、putFilter(List<TPFilter> tpFilter) 以最后一次设置为准

全局维度

• 指定平台不发起请求

List<String> networkIdList = new ArrayList<>();
// 传入需要屏蔽的指定广告平台的平台id
networkIdList.add("1");
TradPlusSdk.setForbidNetworkIdList(networkIdList);

自定义过滤规则

• 竞价类型不传默认全部过滤。竞价类型限制支持：
  • TPFilter.C2S ：客户端竞价；
  • TPFilter.S2S ：服务端竞价
  • TPFilter.NORMAL ：普通Waterfall
• 若只传竞价类型，不传平台ID，则不生效

代码示例

• 针对平台Meta（1）、Google Admob （2），限制服务端竞价和普通Waterfall的请求

TPFilter tpFilter = new TPFilter();

// 竞价类型限制
tpFilter.setFilterType(Arrays.asList(TPFilter.S2S,TPFilter.NORMAL));
// 平台限制
tpFilter.setForbidNetworkId(Arrays.asList("1","2"));

List<TPFilter> filterList =  new ArrayList<>();
filterList.add(tpFilter);

TradPlusSdk.putFilter(filterList);

• Meta（1）限制普通Waterfall、Google Admob （2）限制服务端竞价

TPFilter tpFilter = new TPFilter();
tpFilter.setFilterType(Arrays.asList(TPFilter.NORMAL));
tpFilter.setForbidNetworkId(Arrays.asList("1"));


TPFilter tpFilter2 = new TPFilter();
tpFilter2.setFilterType(Arrays.asList(TPFilter.S2S));
tpFilter2.setForbidNetworkId(Arrays.asList("2"));

TradPlusSdk.putFilter(Arrays.asList(tpFilter,tpFilter2));

获取广告TPAdInfo

• V14.9.0.1+ 支持
• 广告位ID必须真实有效，传null、空字符串或无效id，返回null
• 广告位ID无可用广告时候返回null
• 使用tpAdInfo需要先判空

TPAdInfo tpAdInfo = TradPlusSdk.getTPAdInfo("在TP平台创建的广告位ID");
if(tpAdInfo == null) return;
String adSourceName = tpAdInfo.adSourceName;
...

检查广告位是否正在加载

• V15.2.0.1 + 支持
• 广告正在加载中，调用loadAd，不会回调加载成功或者加载失败，会回调isLoading
• 可以通过该API检查该广告位是否在加载中

// true 表示正在加载中，false已经结束加载
boolean checkIsLoading = TradPlusSdk.checkIsLoading("在TP平台创建的广告位ID");