回调信息说明
回调信息说明
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实时价格, |
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在后台配置的尺寸高度 |