回调信息说明

一、TPAdInfo的信息回调说明#

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

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

tpReward.setAdListener(new RewardAdListener() {
    @Override // 广告展示
    public void onAdImpression(TPAdInfo tpAdInfo) {
        // 通过TPAdInfo对象可以获取到以下信息
    }

设置自定义参数#

展示广告show之前调用，TPAdInfo中返回
V8.6.0.1新增API，所有类型均支持，开发者通过广告对象调用

Map<String, Object> showData = new HashMap<>();
showData.put("data", System.currentTimeMillis() + "");
tpNative.setCustomShowData(showData);

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

为方便开发者进行展示数据统计，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。
true_adunit_id	String	V12.4.0.1新增。共享广告位特有的广告信息，用于记录广告最终展示在哪个广告位上。
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实时价格，~~当返回exact时，开发者需要通过获取ecpmExact拿到bidding的实时价格~~
~~ecpmExact~~	String	V7.0.0.0新增。Bidding的实时价格。当ecpmPrecision返回exact时，请使用ecpmExact作为广告价格，会比使用ecpm更加精准。 V8.0.0.1废弃。开发者可直接通过ecpm获取。
~~ecpmExactCny~~	String	V7.1.0.0新增。Bidding的人民币实时价格。当ecpmPrecision返回exact时，请使用ecpmExact作为广告价格，会比使用ecpm更加精准。 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是没有特殊类型
impPaidData	Map	V9.8.0.1新增。Admob返回的展示级收益数据，包含字段如下： paid_valueMicros: ECPM； paid_currencycode: 币种； paid_precision: 精度需要在admob后台-设置-账户-展示机会层级的广告收入启用
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
72	Sailoff
73	Tanx
74	TaurusX
75	KwaiAds
76	Columbus