跳到主要内容

Android 回调信息说明

一、TPAdInfo的信息回调说明​

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

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

// 广告展示成功
TradplusRewardVideo.Instance().OnRewardVideoImpression += OnImpression;
...
void OnImpression(string adunit, Dictionary<string, object> adInfo)
{
	Debug.Log("RewardVideoUI OnImpression adunit:" + adunit + "; adInfo: " + Json.Serialize(adInfo));
}

返回信息如下，开发者可以获取到对应的内容：

W/Unity: RewardVideoUI OnImpression adunit:702208A872E622C1729FC621025D4B1D; adInfo: {"adNetworkId":"2","adSourceId":"ca-app-pub-3940256099942544/5224354917","adSourceName":"admob","adSourcePlacementId":"10636","adUnitId":"702208A872E622C1729FC621025D4B1D","adViewHeight":0,"adViewWidth":0,"amount":100,"bucketId":"1654","channel":"tp_channel","configBean":{"placementId":"ca-app-pub-3940256099942544/5224354917"},"configString":"{\"placementId\":\"ca-app-pub-3940256099942544/5224354917\"}","currencyName":"Reward1","ecpm":"600.0","ecpmLevel":"4","ecpmPrecision":"publisher_defined","ecpmcny":"3881.94","format":"rewarded-video","height":0,"isBiddingNetwork":false,"isoCode":"CN","loadTime":4296,"networkType":"interstitial-video","requestId":"beb60983-44a3-4f23-85a1-b9ff7b18df1a","rewardName":"Reward1","rewardNumber":100,"rewardVerifyMap":{},"sceneId":"567","segmentId":"0","subChannel":"tp_sub_channel","tpAdUnitId":"702208A872E622C1729FC621025D4B1D","waterfallIndex":3,"width":0}

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

  • 为方便开发者进行展示数据统计，SDK提供了全局展示回调API
  • 支持版本：Unity插件版本 v1.0.4+，iOS v8.5.0+, Android v8.8.0.1+
  • Android Only：开发者同步需要调用每个类型的监听，才能收到GlobalImpressionListener监听，例如：激励视频设置

TradplusRewardVideo.Instance().OnRewardVideoImpression += OnImpression;

TradplusAds.Instance().AddGlobalAdImpression(OnGlobalAdImpression);

void OnGlobalAdImpression(Dictionary<string, object> adInfo)
{
	//开发者可以通过此回调获取到所有广告位的展示回调
}

设置自定义参数​

  • 展示广告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);
方法
类型说明
tpAdUnitIdStringTradPlus后台创建的广告位ID。
true_adunit_idStringV12.4.0.1新增。共享广告位特有的广告信息，用于记录广告最终展示在哪个广告位上。
adSourceNameString三方广告网络名称。例如，谷歌广告返回“Admob”。
adNetworkIdString三方广告网络对应的编号，用于区分不同广告网络。请参考下述的三方广告网络编号表。
adSourceIdString三方广告位ID。
ecpmStringEcpm美金。（默认）
ecpmcnyStringEcpm人民币。
ecpmPrecisionStringV7.0.0.0新增。获取eCPM精度。
"publisher_defined"：开发者在TradPlus后台为广告源定义的eCPM；
"estimated": 开发者在后台开启广告源的自动价格功能后，TradPlus根据历史数据预估的eCPM（交叉推广的eCPM也属于该类型）；
"exact": bidding实时价格，当返回exact时，开发者需要通过获取ecpmExact拿到bidding的实时价格
ecpmExactStringV7.0.0.0新增。Bidding的实时价格。当ecpmPrecision返回exact时，请使用ecpmExact作为广告价格，会比使用ecpm更加精准。
V8.0.0.1废弃。开发者可直接通过ecpm获取。
ecpmExactCnyStringV7.1.0.0新增。Bidding的人民币实时价格。当ecpmPrecision返回exact时，请使用ecpmExact作为广告价格，会比使用ecpm更加精准。
V8.0.0.1废弃。开发者可直接通过ecpmcny获取。
ecpmLevelStringV7.0.0.0新增。获取广告源在开发者后台中介管理页面的顺序（优先级）。
bidding广告源默认为0。
非bidding广告源，手动排序区从1开始递增。
loadTimelong加载时长。
rewardNameString仅激励视频支持。TradPlus后台配置的奖励项目。
rewardNumberint仅激励视频支持。TradPlus后台配置的奖励数量。
isoCodeString国家码。
heightint高。横幅广告可获取设置的对应广告位的高度。
widthint宽。横幅广告可获取设置的对应广告位的宽度。
rewardVerifyMapMap仅Tencent激励视频支持。腾讯优量汇激励视频服务器奖励验证，需要在奖励回调中设置对应的user_id。
isBiddingNetworkboolean判断是否是开启Bidding的广告网络。
waterfallIndexint获取当前广告在waterfall中的排序。
requestIdString请求标识，每次调用load开始会生成一个id，到最终展示完成，可以追踪广告加载的完整生命周期
subChannelString获取子渠道信息。
channelString获取渠道信息。
sceneIdString广告场景ID。了解更多，请看广告场景的调用时机和用途说明。
configBeanConfigResponse.WaterfallBean.ConfigBean获取WatllFall策略下发的三方对象。
networkTypeStringV7.6.0.1新增。获取对应的广告类型。
"interstitial"插屏广告、"rewarded-video"激励视频、"banner"横幅广告、"Native Banner"原生横幅、"Native DrawVideo"Draw信息流、"Native Splash"原生拼接开屏
bucketIdStringV7.6.0.1新增。AB测试分组ID。
segmentIdStringV7.6.0.1新增。流量分组ID。
isBottombooleanV8.8.0.1新增。是否为备用广告。
placementAdTypeintV9.0.0.1新增。
V8.7.0.1横幅和开屏广告支持原生广告混用，V9.0.0.1插屏广告支持开屏广告混用，开发者可以通过此字段获取混用广告类型。
广告源广告类型：1、原生；2、插屏；3、开屏；4、Banner；5、激励；6、积分墙
impPaidDataMapV9.8.0.1新增。Admob返回的展示级收益数据，包含字段如下：
paid_valueMicros: ECPM；
paid_currencycode: 币种；
paid_precision: 精度
需要在admob后台-设置-账户-展示机会层级的广告收入 启用
说明：因Admob 2025年7月17日官方政策调整，Admob SDK停止分享展示级别收益，请使用TPAdInfo.ecpm 获取广告展示收入数据
impressionIdStringV9.9.0.1新增。标识每次广告展示的唯一标识。
bannerWintv10.6.0.1新增 Banner在后台配置的尺寸宽度
bannerHintv10.6.0.1新增 Banner在后台配置的尺寸高度
creativeIdStringv15.0.0.1 新增 InmoBi＆MTG 素材ID

二、三方广告网络编号表​

NetworkId广告平台
1audience-network （Facebook）
2Admob
4AdColony
5UnityAds
6Tapjoy
7LiftOff（Vungle）
9AppLovin
10IronSource
15Chartboost
16Tencent Ads （腾讯优量汇）
17Pangle(cn) （穿山甲国内）
18Mintegral
19Pangle （穿山甲海外）
20Kuaishou Ads
21Sigmob
23Inmobi
24fyber
25YouDao （有道）
27Cross Promotion （交叉推广）
28Start.io
30Helium
31Maio
32Criteo
33MyTarget
34Ogury
36appnext
37kidoz
38Smaato
40TP-ExChange （TPX）
41HuaWei
43Baidu
45A4G
46Mimo (米盟)
47SuperAwesome
48Google Ad Manager
50Yandex
53Verve
55zMaticoo
56Reklamup
57Bigo
63TapTap
64PremiumAds
67GreedyGame
68AlgoriX
69BeesAds
70Amazon
71Mango X
72Octopus
72Tanx
74Taurusx
75海外快手
76Columbus（海外小米）
77Yso
78Vivo
79Oppo
80Honor（荣耀）