菜单

回调信息说明

1. AdInfo

可通过设置回调监听来获取参数AdInfo，进而获取当前广告的信息

方法 说明
int getNetworkFirmId() 获取 广告平台对应的ID，用于区分广告平台，参考 Network Firm Id
String getNetworkName() 获取 广告平台名称(v6.3.10+支持)
String getNetworkPlacementId() 获取 广告平台的广告位ID
String getAdsourceId() 获取 广告源ID. 可在开发者后台或TopOn Open API 通过广告源ID查询具体的Network信息
int getAdsourceIndex() 获取 当前广告源在WaterFall中的排序 （从0开始，0优先级最高）
double getEcpm() 获取TopOn预估eCPM。即每次广告展示的预估eCPM：常规广告源是TopOn后台对应广告源填写的排序价格，竞价广告源是实时竞价返回的价格。eCPM的货币单位可通过currency获取，通常为元（CNY）或美元（USD），精度可通过precision获取。
eCPM含义：每千次广告展示收益。假设广告源A的eCPM=1美元，则展示一次广告源A之后，展示收益为0.001美元
String getEcpmPrecision() 获取eCPM精度
"publisher_defined"：开发者在TopOn后台为广告源定义的eCPM （交叉推广的eCPM也属于该类型)
"estimated": 在TopOn后台开启广告源的自动价格功能后，TopOn根据历史数据计算出的eCPM
"exact"：实时竞价的eCPM (Meta广告平台除外)
"ecpm_api"： 针对Meta广告源生效，根据Meta的ReportAPI数据预估的历史eCPM API
String getCurrency() 获取 TopOn收益货币单位。根据返回的货币单位，确定当前eCPM或收益的价格，通常为元（CNY）或美元（USD）。
例如："USD"，则返回的价格为“美元”，getEcpm()和getPublisherRevenue()两个方法返回的价格单位均为“美元”。
int isHeaderBiddingAdsource() 是否为头部竞价的广告源，1：是，0：否
String getShowId() 获取 每次展示广告时生成的独立ID
double getPublisherRevenue() 获取 TopOn广告位展示收益。即每次广告展示后，预估可获得的收益。单位可通过currency获取，通常为元（CNY）或美元（USD），精度可通过 precision 获取
String getCountry() 获取 国家代码， 例如：”CN"
String getPlacementId() 获取 TopOn广告位ID
String getFormat() 获取 广告类型，包括："Native"、"RewardedVideo"、"Banner""Interstitial"、"Splash"
String getAdNetworkType() 获取 Network类型
"Network"：第三方广告平台
"Cross_Promotion"：交互推广
"Adx"：TopOn Adx
int getEcpmLevel() 获取 广告源的eCPM层级(对应开发者后台聚合管理页面的优先级），头部竞价广告源默认为0
int getSegmentId() 获取 流量分组ID
String getScenarioId() 获取 广告场景ID
String getScenarioRewardName() 获取 广告场景的激励名称，仅Rewarded Video支持
int getScenarioRewardNumber() 获取 广告场景的激励数量，仅Rewarded Video支持
String getSubChannel() 获取子渠道信息
String getChannel() 获取 渠道信息
String getCustomRule() 获取 Placement+App维度的自定义规则的Json字符串
String getABTestId() 获取 AB测试ID。具体AB测试ID可以从AB测试页面查询
Map getExtInfoMap() 获取 广告的自定义信息，针对Adx、OnlineAPI、直投广告、交叉推广以及自定义广告平台，Adx、OnlineAPI、直投广告、交叉推广相关Key参考下文2.NETWORK_CUSTOM_KEY 获取
Map getLocalExtra() 获取加载广告前传入的本地参数 以插屏广告为例：返回的是setLocalExtra(Map map)方法的参数
int getPlacementType() 获取广告位类型 1：真实广告位 2：共享广告位
String getSharedPlacementId() 获取共享广告位id，仅展示共享广告位缓存时返回
double getBidFloor() 返回TopOn后台配置竞价广告源竞价底价
int getDismissType() 获取关闭类型，仅激励视频、插屏广告、开屏广告支持 具体枚举值见ATAdConst.DISMISS_TYPE
int getAdSourceAdType() 获取当前广告源广告类型 (v6.2.90+支持)
0：Native
1：Rewarded
2：Banner
3：Interstitial
4：Splash
当激励视频广告位使用激励视频广告源时，返回1；
当激励视频广告位使用插屏广告源时，返回3，
使用开屏广告源时，返回4；
String getAdSourceCustomExt() 获取在TopOn后台广告源配置的自定义参数（v6.2.90+支持）
String getShowCustomExt() (v6.3.10+) 获取展示时传入的自定义参数，对应setShowConfig()传入的参数
String getEncEcpmInfo() (v6.3.65+) 获取加密后的ecpm信息
int getSecretId() (v6.3.65+)获取解密ecpm信息的私钥ID，可以通过在TopOn后台-帐号管理-Key找到相应的私钥去解密
String toString() 获取 所有回调信息的Json字符串，所有key值如下：
"id"：对应getShowId()
"publisher_revenue"：对应getPublisherRevenue()
"currency"：对应 getCurrency()
"country"：对应 getCountry()
"adunit_id"：对应 getPlacementId()
"adunit_format"：对应 getAdFormat()
"precision"：对应 getEcpmPrecision()
"network_type"：对应 getAdNetworkType()
"network_placement_id"：对应 getNetworkPlacementId()
"ecpm_level"：对应 getEcpmLevel()
"segment_id"：对应 getSegmentId()
"scenario_id"：对应 getScenarioId()
"scenario_reward_name"：对应 getScenarioRewardName()
"scenario_reward_number"：对应 getScenarioRewardNumber()
"channel"：对应 getChannel()
"sub_channel"：对应 getSubChannel()
"custom_rule"：对应 getCustomRule()
"network_firm_id"：对应 getNetworkFirmId()
"adsource_id"：对应 getAdsourceId()
"adsource_index"：对应 getAdsourceIndex()
"adsource_price"：对应 getEcpm()
"adsource_isheaderbidding"：对应 isHeaderBiddingAdsource()
"abtest_id"：对应getABTestId()
"ext_info"：对应 getExtInfoMap()
"reward_custom_data"：对应AdConst.KEY.USER_CUSTOM_DATA
"user_load_extra_data"：对应 getLocalExtra()
"placement_type"：对应 getPlacementType()
"shared_placement_id"：对应 getSharedPlacementId()
"bid_floor"：对应 getBidFloor()
"dismiss_type"：对应 getDismissType()
"ad_source_type": 对应getAdSourceAdType()
"ad_source_custom_ext": 对应getAdSourceCustomExt()

2. NETWORK_CUSTOM_KEY

NETWORK_CUSTOM_KEY 说明
OFFER_ID Adx、OnlineAPI、直投广告、交叉推广 Offer的广告 ID
CREATIVE_ID Adx、OnlineAPI、直投广告 Offer的素材 ID
IS_DEEPLINK_OFFER 判断Adx、OnlineAPI、直投广告、交叉推广 Offer的单子类型是否为Deeplink或JumpURL的单子 0：否 1：是

3. AdMob展示收益

❗ 特别说明
Admob 2025年7月17号政策的调整，影响TopOn SDK跑Admob Bidding广告单元，在广告展示时不能返回Admob SDK的展示收益 ，请使用 adInfo#getPublisherRevenue() 和 adInfo#getEcpm() 获取广告收益价值

上一个
视频流广告
下一个
政策合规
最近修改: 2025-11-11Powered by