回调信息说明
一、TPAdInfo的信息回调说明
开发者可通过设置回调监听,就 可通过参数TPAdInfo获取当前广告的信息。
以激励视频类型为例,代码如下:
tpReward.setAdListener(new RewardAdListener() {
@Override // 广告展示
public void onAdImpression(TPAdInfo tpAdInfo) {
// 通过TPAdInfo对象可以获取到以下信息
}
设置自定义参数
- 展示广告show之前调用,TPAdInfo中返回
- V8.6.0.1新增API,所有类型均支持,开发者通过广告对象调用
Dictionary<string, string> customAdInfo = new Dictionary<string, string>();
customAdInfo.Add("act", "Load");
customAdInfo.Add("time", "" + DateTimeOffset.Now);
TradplusRewardVideo.Instance().SetCustomAdInfo(adUnitId, customAdInfo);
设置应用维度的全局的展示回调
- 为方便开发者进行展示数据统计,SDK提供了全局展示回调API
- V8.8.0.1起开始支持,所有类型广告被展示时均会回调
- V9.5.0.1之前,开发者同步需要调用setAdListener(每个类型的广告位级别的监听),才能收到GlobalImpressionListener监听。(广告位维度)
TradPlusSdk.setGlobalImpressionListener(new GlobalImpressionManager.GlobalImpressionListener() {
@Override
public void onImpressionSuccess(TPAdInfo tpAdInfo) {
Log.i("onImpressionSuccess", "tpAdInfo: " + tpAdInfo);
}
});
方法 | 类型 | 说明 |
---|---|---|
tpAdUnitId | String | TradPlus后台创建的广告位ID。 |
adSourceName | String | 三方广告网络名称。例如,谷歌广告返回“Admob”。 |
adNetworkId | String | 三方广告网络对应的编号,用于区分不同广告网络。请参考下述的三方广告网络编号表。 |
adSourceId | String | 三方广告位ID。 |
ecpm | String | Ecpm美金。(默认) 单位:美金。 |
ecpmcny | String | Ecpm人民币。 单位:元。 |
ecpmPrecision | String | V7.0.0.0新增。获取eCPM精度。 "publisher_defined":开发者在TradPlus后台为广告源定义的eCPM; "estimated": 开发者在后台开启广告源的自动价格功能后,TradPlus根据历史数据预估的eCPM(交叉推广的eCPM也属于该类型); "exact": bidding实时价格, |
String | V8.0.0.1废弃。开发者可直接通过ecpm获取。 | |
String | V8.0.0.1废弃。开发者可直接通过ecpmcny获取。 | |
ecpmLevel | String | V7.0.0.0新增。获取广告源在开发者后台中介管理页面的顺序(优先级)。 bidding广告源默认为0。 非bidding广告源,手动排序区从1开始递增。 |
loadTime | long | 加载时长。 |
rewardName | String | 仅激励视频支持。TradPlus后台配置的奖励项目。 |
rewardNumber | int | 仅激励视频支持。TradPlus后台配置的奖励数量。 |
isoCode | String | 国家码。 |
height | int | 高。横幅广告可获取设置的对应广告位的高度。 |
width | int | 宽。横幅广告可获取设置的对应广告位的宽度。 |
rewardVerifyMap | Map | 仅Tencent激励视频支持。腾讯优量汇激励视频服务器奖励验证,需要在奖励回调中设置对应的user_id 。 |
isBiddingNetwork | boolean | 判断是否是开启Bidding的广告网络。 |
waterfallIndex | int | 获取当前广告在waterfall中的排序。 |
requestId | String | 请求标识,每次调用load开始会生成一个id,到最终展示完成,可以追踪广告加载的完整生命周期 |
subChannel | String | 获取子渠道信息。 |
channel | String | 获取渠道信息。 |
sceneId | String | 广告场景ID。了解更多,请看广告场景的调用时机和用途说明。 |
configBean | ConfigResponse.WaterfallBean.ConfigBean | 获取WatllFall策略下发的三方对象。 |
networkType | String | V7.6.0.1新增。获取对应的广告类型。 "interstitial"插屏广告、"rewarded-video"激励视频、"banner"横幅广告、"Native Banner"原生横幅、"Native DrawVideo"Draw信息流、"Native Splash"原生拼接开屏 |
bucketId | String | V7.6.0.1新增。AB测试分组ID。 |
segmentId | String | V7.6.0.1新增。流量分组ID。 |
isBottom | boolean | V8.8.0.1新增。是否为备用广告。 |
placementAdType | int | V9.0.0.1新增。 V8.7.0.1横幅和开屏广告支持原生广告混用,V9.0.0.1插屏广告支持开屏广告混用,开发者可以通过此字段获取混用广告类型。 广告源广告类型:1、原生;2、插屏;3、开屏;4、Banner;5、激励;6、积分墙 0是没有特殊类型 |
format | String | 广告类型。列如:"rewarded-video":激励视频;"interstitial":插屏等 |
impPaidData | Map | V9.8.0.1新增。Admob返回的展示级收益数据,包 含字段如下: paid_valueMicros: ECPM; paid_currencycode: 币种; paid_precision: 精度 |
impressionId | String | V9.9.0.1新增。标识每次广告展示的唯一标识。 |
video_protocol | int | V10.3.0.1新增。仅插播支持 视频协议类型:1、vast; 2、vmap |
bannerW | int | v10.6.0.1新增 。Banner在后台配置的尺寸宽度 |
bannerH | int | v10.6.0.1新增 。Banner在后台配置的尺寸高度 |
如何使用configBean
- 以激励视频的
onAdLoaded
监听回调为例,如何获取MTG的unitId 和 placementId
tpReward.setAdListener(new RewardAdListener() {
@Override
public void onAdLoaded(TPAdInfo tpAdInfo) {
if("Mintegral".equals(tpAdInfo.adSourceName)) {
// 获取Mintegral的configBean
ConfigResponse.WaterfallBean.ConfigBean configBean = tpAdInfo.configBean;
if(configBean != null && configBean.getUnitId() != null && configBean.getPlacementId() != null) {
Log.i(TAG, "onAdLoaded: adSourceName :" + adSourceName + " unitId : " + configBean.getUnitId() + " placementId :" + configBean.getPlacementId());
}
}
}
二、三方广告网络编号表
NetworkId | SourceName |
---|---|
1 | audience-network (Facebook) |
2 | Admob |
3 | Mopub |
4 | AdColony |
5 | UnityAds |
6 | Tapjoy |
7 | Vungle |
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 |
36 | appnext |
37 | kidoz |
38 | Smaato |
40 | Adx |
41 | HuaWei |
43 | Baidu |
44 | klevin(游可赢) |
45 | A4G |
46 | Mimo (米盟) |
47 | SuperAwesome |
48 | Google Ad Manager |
50 | Yandex |
53 | Verve |
55 | zMaticoo |
56 | Reklamup |
57 | Bigo |
63 | TapTap |
64 | PremiumAds |
67 | GreedyGame |
68 | AlgoriX |
69 | BeesAds |
70 | Amazon |
71 | Mango X |