回调信息说明

回调信息说明

AdInfo的信息回调说明

开发者可通过设置回调监听，就可通过参数adInfo获取当前广告的信息。

以激励视频类型为例，代码如下：

- (void)viewDidLoad

{

[super viewDidLoad];

self.rewardedVideoAd = [[TradPlusAdRewarded alloc] init];

//设置代理

self.rewardedVideoAd.delegate = self;

}

#pragma mark - TradPlusADRewardedDelegate

- (void)tpRewardedAdImpression:(NSDictionary *)adInfo

{

//通过AdInfo对象可以获取到以下信息

}

设置自定义参数

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

//以激励视频为例：

//展示前设置

self.rewardedVideoAd.customAdInfo = @{@"act":@"Show",@"time":@(time)};

[self.rewardedVideoAd showAdWithSceneId:@"scene_id"];

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

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

#import <TradPlusAds/TradPlus.h>

[TradPlus sharedInstance].impressionDelegate = self;

#pragma mark - TradPlusAdImpressionDelegate

- (void)tradPlusAdImpression:(NSDictionary *)adInfo

{

//开发者可以通过此回调获取到所有广告位的展示回调

}

各接口返回的回调信息字段说明

Key	说明
adType	V7.1.0 新增 广告类型。 native : 标准原生 native-banner : 原生横幅 native-splash ：原生开屏 native-draw：原生draw信息流 banner：横幅 splash ：开屏 interstitial ：插屏 rewarded-video：激励视频 offerwall:积分墙
segment_id	V7.1.0 新增 流量分组ID
bucket_id	V7.1.0 新增 A/B测试组ID
adunit_id	TradPlus后台创建的广告位ID。
true_adunit_id	V12.1.0 新增共享广告位特有的广告信息，用于记录广告最终展示在哪个广告位上。
adsource_placement_id	广告源ID
adNetworkId(v7.8.0+)	三方广告网络对应的编号，用于区分不同广告网络。请参考下述的三方广告网络编号表
adNetworkName(v7.8.0+)	三方广告网络名称
adSourceId(v11.70+)	三方广告位ID，11.7.0之前版本大部份广告源可通过 placementid 字段获取（MyTarget 字段为 slot_id）
country_code	国家码
ecpm	ecpm美金(⚠️ecpm相关为float类型，下同)千次展示广告的收入
ecpm_cny	ecpm人民币
ecpm_precision	V6.5.0 新增。获取eCPM精度。 "publisher_defined"：开发者在TradPlus后台为广告源定义的eCPM； "estimated": 开发者在后台开启广告源的自动价格功能后，TradPlus根据历史数据预估的eCPM（交叉推广的eCPM也属于该类型）； "exact": bidding实时价格，当返回exact时，开发者需要通过获取 ecpm_exact 和 ecpm_cny 拿到bidding的实时价格
ecpm_exact	V6.5.0 新增。Bidding的实时价格（美金）。当ecpm_precision返回exact时，请使用 ecpm_exact 和 ecpm_exact_cny 作为广告价格，会比使用 ecpm 和 ecpm_cny 更加精准。 v7.8.0废弃。开发者可直接通过ecpm获取。
ecpm_exact_cny	V6.6.0 新增。Bidding的实时价格（人民币）。当ecpm_precision返回exact时，请使用 ecpm_exact 和 ecpm_exact_cny 作为广告价格，会比使用ecpm 和 ecpm_cny 更加精准 v7.8.0废弃。开发者可直接通过ecpm_cny获取。
ecpm_level	V6.5.0 新增。获取广告源在开发者后台中介管理页面的顺序（优先级）。 bidding广告源默认为0。 非bidding广告源，手动排序区从1开始递增。
is_adapter_template_render	是否为模版类型
native_ad_type	v6.9.0+,原生广告类型。默认 0（未知），当原生广告加载完成后返回具体类型。 0 - 未知 1 -自渲染 2 - 模版 3 - 视频贴片 4 - draw信息流
is_bid	是否为Bidding的广告源
is_c2s_bid	V7.6.0 新增 是否为C2SBidding的广告源
is_auto_load	V7.6.0 新增 是否是自动加载
load_time	V7.6.0 新增 加载时长 毫秒
reward_info	三方返回的奖励信息数据（激励视频），包括穿山甲和快手的进阶奖励（如果有）
reward_name	TradPlus后台配置的奖励项目。（激励视频）
reward_number	TradPlus后台配置的奖励数量。（激励视频）
request_id	请求标识，每次调用load开始会生成一个id，到最终展示完成，可以追踪广告加载的完整生命周期
waterfall_index	当前广告在waterfall中的位置
scene_id	广告场景ID。了解更多，请看广告场景的调用时机和用途说明。
customAdInfo	v8.3.20+ 开发者在广告展示前设置对自定义数据。开发者可通过各广告加载类对应API进行设置。自定义数据会在广告展示后的相关回调中返回
isNative	v8.4.0+ 是否为原生广告。v8.4.0+横幅和开屏广告支持原生广告混用，开发者可以通过此字段判断广告是否为原生广告
isBottom	v8.5.0+ 是否为备用广告
placement_ad_type	v8.7.0+ 广告源广告类型。 v8.4.0+ 横幅和开屏广告支持原生广告混用，v8.7.0+ 插屏广告支持开屏广告混用，开发者可以通过此字段获取混用广告类型。 1 原生 2 插屏 3 开屏 4 Banner 5 激励 6 积分墙
impPaidData	Admob返回的展示级收益数据（v9.5.0+） 注：数据中包括以下字段 paid_valueMicros: value paid_currencycode: 币种 paid_precision: 精度 需要在admob后台-设置-账户-展示机会层级的广告收入 启用
impressionId	v9.6.0新增 标识每次广告展示的唯一标识
video_protocol	v10.0.0新增 视频协议类型 1:vast, 2:vamp
banner_w	v10.3.0新增 Banner在后台配置的尺寸宽度
banner_h	v10.3.0新增 Banner在后台配置的尺寸高度

三方广告网络编号表

NetworkId	SourceName
1	Audience-network （Meta）
2	Admob
3	Mopub
4	AdColony
5	UnityAds
6	Tapjoy
7	Liftoff
9	AppLovin
10	IronSource
15	Chartboost
16	Tencent Ads （腾讯优量汇）
17	Pangle(cn) （穿山甲国内）
18	Mintegral
19	Pangle （穿山甲海外）
20	Kuaishou Ads
21	Sigmob
23	Inmobi
24	Fyber
25	YouDao （有道）
27	Cross Promotion （交叉推广）
28	Start.io
30	Helium
31	Maio
32	Criteo
33	MyTarget
34	Ogury
37	Kidoz
38	Smaato
40	ADX
43	Baidu
44	Klevin（游可赢）
45	A4G
47	SuperAwesome
48	GoogleAdManager
50	Yandex
53	Verve
55	ZMaticoo
56	ReklamUp
57	Bigo
58	Beizi
60	ONEMOB
64	PremiumAds
67	GreedyGame
69	BeesAds
70	Amazon
71	Mango X
72	Sailoff
73	Tanx
74	TaurusX
75	KwaiAds
76	Columbus