Android 回调信息说明
一、TPAdInfo的信息回调说明
开发者可通过设置回调监听，就可通过参数TPAdInfo获取当前广告的信息。
以激励视频类型为例，代码如下：
V8501及以下
private void OnRewardedVideoAdImpression(string tpAdInfo)
{
Debug.Log("onRewardedVideoAdImpression: " + tpAdInfo);
}
返回信息如下，开发者直接转json就可以获取到对应的内容：
I/Unity: onRewardedVideoAdImpression : {"adNetworkId":"2","adSourceId":"ca-app-pub-3940256099942544/1033173712","adSourceName":"admob","adUnitId":"788E1FCB278B0D7E97282231154458B7","adViewHeight":0,"adViewWidth":0,"amount":0,"bucketId":"1516"......}
V8501新版本Unity
// 广告展示成功
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);
| 方法 | 类型 | 说明 |
|---|---|---|
| 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实时价格， |
| 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、积分墙 |
| impPaidData | Map | V9.8.0.1新增。Admob返回的展示级收益数据，包含字段如下： paid_valueMicros: ECPM； paid_currencycode: 币种； paid_precision: 精度 |
| impressionId | String | V9.9.0.1新增。标识每次广告展示的唯一标识。 |
| bannerW | int | v10.6.0.1新增 Banner在后台配置的尺寸宽度 |
| bannerH | int | v10.6.0.1新增 Banner在后台配置的尺寸高度 |
二、三方广告网络编号表
| 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 |
| 77 | YSO |