跳到主要内容

其他功能介绍

1.关闭和触发过期检测​

  • 广告位对象创建后调用，这两个方法对全局设置有效。
  • 为防止游戏过程中补充过期广告会占用带宽，可以调用isExpiredAdChecking，传NO关闭每隔5分钟自动过期检测。默认YES，将自动进行广告过期检测。
  • 如果关闭过期检测，可以调用expiredAdCheck来触发一次广告过期检测。
    // 关闭每隔5分钟自动过期检测
	///YES=允许定时检查 NO=关闭定时检查 默认为YES
    [TradPlus sharedInstance].isExpiredAdChecking = BOOL

    // 可主动触发过期检测(如有失效广告会触发加载)
    [TradPlus expiredAdCheck];

2.只使用TradPlus国内域名服务器​

  • V6.8新增API ,初始化SDK前调用API。
//此接口设置为Yes后SDK将只使用TradPlus国内域名服务器，默认为NO
 [TradPlus setCnServer:BOOL];

3.使用本地配置信息​

开发者可以通过此接口来传入本地配置，对应的广告位将在首次加载时优先使用此份本地配置来请求广告，具体步骤可参考SDK预置策略

#import <TradPlusAds/TradPlusAds.h>
// 单一国家
[TradPlus setLocalConfig:@"后台导出txt文件内容" placementId:@"广告位ID"];

// V14.5.0+支持多个国家，传入iso国家编码
[TradPlus setLocalConfig:@"后台导出txt文件内容" placementId:@"广告位ID" countryCode:iso];

4.设置自定义展示AdInfo​

开发者可以在展示广告前，各广告加载类的customAdInfo设置定义数据。SDK将在展示后的相关回调中返回。


//以激励视频为例：

//展示前设置
self.rewardedVideoAd.customAdInfo = @{@"act":@"Show",@"time":@(time)};
[self.rewardedVideoAd showAdWithSceneId:@"scene_id"];

5.设置应用维度的全局展示回调​

v8.5.0+为方便开发者进行展示数据统计，SDK提供了全局展示回调API

#import <TradPlusAds/TradPlus.h>

[TradPlus sharedInstance].impressionDelegate = self;

#pragma mark - TradPlusAdImpressionDelegate
- (void)tradPlusAdImpression:(NSDictionary *)adInfo
{
	//开发者可以通过此回调获取到所有广告位的展示回调
}

adInfo(NSDictionary) 中的相关字段可参照：回调信息说明

6.设置UID2 (v9.8.0+)​

  • 建议在初始化TPSDK前设置
  • 如果您已经自行获取了UID2Token的话，也可以按如下代码进行设置
	TradPlusUID2Info *UID2Info = [[TradPlusUID2Info alloc] init];
	UID2Info.UID2Token = @"您的UID2Token";
    [[TradPlus sharedInstance] setUID2Info:UID2Info];

7.设置指定广告平台展示上限(每天)​

  • v13.1.0开始支持

设置规则

#import <TradPlusAds/TradPlus.h>

TPPlatformLimit *limit = [[TPPlatformLimit alloc] init];
[limit setLimitWithPlatformID:TPPlatformID_Admob. num:1];
[limit setLimitWithPlatformID:TPPlatformID_Mintegral. num:2];

//传入limit.list设置规则
[TradPlus setPlatformLimit:limit.list];

清空规则

#import <TradPlusAds/TradPlus.h>
//传入空数组清空规则
[TradPlus setPlatformLimit:@[]];

直接传入规则数据

#import <TradPlusAds/TradPlus.h>
NSArray *array = @[@{@"platform":@(TPPlatformID_Admob),@"num":@(1)},@{@"platform":@(TPPlatformID_Mintegral),@"num":@(2)}];
[TradPlus setPlatformLimit:array];

8.屏蔽指定平台的请求​

  • v14.2.0开始支持
  • 设置后下次请求广告生效
  • 广告平台的平台id，根据文档三方广告网络编号表三方广告网络编号表 填入
  • 多次设置setForbidNetworkIdList、putFilter以最后一次设置为准

全局维度

  • 指定平台不发起请求
#import <TradPlusAds/TradPlus.h>
// 传入需要屏蔽的指定广告平台的平台id数组
[TradPlus setForbidNetworkIdList:@[@(NETWORK_FACEBOOK),@(NETWORK_ADMOB)]];

自定义过滤规则

  • 竞价类型不传默认全部过滤。竞价类型限制支持：
//屏蔽的广告类型
typedef enum : NSUInteger {
    TPNetworkS2S, //服务端竞价
    TPNetworkC2S, //客户端竞价
    TPNetworkNormal //普通Waterfall
} TPForbidNetworkType;
  • 若只传竞价类型，不传平台ID，则不生效

代码示例

针对平台Meta（1）限制客户端竞价、Google Admob （2）限制服务端竞价

    TradPlusFilter *filter1 = [[TradPlusFilter alloc]init];
    [filter1 setFilterNetworkIds:@[@(NETWORK_FACEBOOK)]];
    [filter1 setFilterBidTypes:@[@(TPNetworkC2S)]];
    
    TradPlusFilter *filter2 = [[TradPlusFilter alloc]init];
    [filter2 setFilterNetworkIds:@[@(NETWORK_ADMOB)]];
    [filter2 setFilterBidTypes:@[@(TPNetworkS2S)]];
    
    [TradPlus putFilter:@[filter1,filter2]];

9.查询广告位是否正在加载 (v14.8.0+)​

[TradPlus isAdLoadingWithPlacementId:@"您的广告位id"];