回调信息说明
回调信息说明
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类型，下同)单位：美金。每千次展示广告的收入，如需获取单次收入可除以1000。 |
| ecpm_cny | ecpm人民币，单位：元。每千次展示广告的收入，如需获取单次收入可除以1000。 |
| ecpm_precision | V6.5.0 新增。获取eCPM精度。 "publisher_defined"：开发者在TradPlus后台为广告源定义的eCPM； "estimated": 开发者在后台开启广告源的自动价格功能后，TradPlus根据历史数据预估的eCPM（交叉推广的eCPM也属于该类型）； "exact": bidding实时价格， |
v7.8.0废弃。开发者可直接通过ecpm获取。 | |
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 | 注：数据中包括以下字段 paid_valueMicros: value paid_currencycode: 币种 paid_precision: 精度 需要在admob后台-设置-账户-展示机会层级的广告收入 启用 说明：因Admob 2025年7月17日官方政策调整，Admob SDK停止分享展示级别收益，请使用TPAdInfo.ecpm 获取广告展示收入数据 |
| 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在后台配置的尺寸高度 |
| creativeId | v14.6.0新增 三方素材的creativeId，仅（InMobi，Mintegral支持） |
三方广告网络编号表
| 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 |
| 77 | YSO |