Search...
Menu

Callback Information

Callback Information

@interface MCIAdInfo : NSObject

Property Return Type Description
mediationAdapter MCMediationAdapter * Mediation platform adapter (weak reference)
mediationPlacementId NSString * Mediation platform ad placement ID
networkPlacementId NSString * Ad network placement ID
scenarioId NSString * Scenario ID
format MCAdFormat * Ad format, values as follows:
typedef NS_ENUM(NSUInteger, MCAdFormatType) {
MCAdFormatTypeNative = 0, //Native
MCAdFormatTypeRewarded, //Rewarded
MCAdFormatTypeBanner, //Banner
MCAdFormatTypeInterstitial, //Interstitial
MCAdFormatTypeSplash, //Splash
};
revenue double Get revenue. The revenue for each ad impression: for regular ad sources, it's the sorting price filled in the TopOn dashboard for the corresponding ad source; for bidding ad sources, it's the real-time bidding price. The currency unit can be obtained through currency, usually CNY or USD, and precision can be obtained through revenuePrecision.
ecpm double eCPM (read-only)
revenuePrecision RevenuePrecisionEnum Revenue precision, values as follows:
typedef NSString * RevenuePrecisionEnum NS_STRING_ENUM;
extern RevenuePrecisionEnum const RuePsionPublisherDefined; //Price defined by developer in mediation dashboard for ad source
extern RevenuePrecisionEnum const RuePsionEstimated; //Estimated price
extern RevenuePrecisionEnum const RuePsionExact; //Exact price
extern RevenuePrecisionEnum const RuePsionEcpmApi; //eCPM API price
extern RevenuePrecisionEnum const RuePsionUndefined; //Unknown
country NSString * Country code, e.g.: "CN"
currency NSString * Currency unit. Determines the currency of current eCPM or revenue, usually CNY or USD.
For example: "USD" means the returned price is in "US Dollars", and revenue is also in "US Dollars".
networkName NSString * Ad network name
networkId NSNumber * Ad network ID
extraDic NSDictionary * Extra information extension, currently returns empty internally (can be null)
originData NSString * Original data
weight double Display weight
mediationId NSInteger Mediation platform ID, used to distinguish mediation platforms, values as follows:
typedef NS_ENUM(NSInteger, MCMediationIDType) {
MCMediationIDTypeTopon = 1, //TopOn mediation platform
MCMediationIDTypeMax = 2, //Max mediation platform
MCMediationIDTypeAdmob = 4 //AdMob mediation platform
};
mediationName NSString * Mediation platform name
requestId NSString * Request ID
networkTransId NSString * Platform transaction ID
biddingType MCAdBiddingType Bidding type, values as follows:
typedef NS_ENUM(NSInteger, MCAdBiddingType) {
MCAdBiddingTypeUnknown = -1, //Unknown
MCAdBiddingTypeNormal = 0, //Normal
MCAdBiddingTypeC2S = 1, //Client-to-server bidding
MCAdBiddingTypeS2S = 2 //Server-to-server bidding
};
mediationSecretId NSInteger Unique identifier for secret key, only supported by TopOn
mediationEncEcpmInfo NSString * Encrypted eCPM data, only supported by TopOn
networkPriceType MCAdNetworkPriceType Data source type for returned price, values as follows:
typedef NS_ENUM(NSInteger, MCAdNetworkPriceType) {
MCAdNetworkPriceTypeLoaded = 0, //Price returned from mediation platform load success callback, default
MCAdNetworkPriceTypeStrategy = 1, //Strategy-delivered sorting price
MCAdNetworkPriceTypeEstimate = 2, //SDK-calculated estimated bidding price
MCAdNetworkPriceTypeRealILRD = 3, //AdMob SDK callback impression-level revenue data
MCAdNetworkPriceTypeSDKAPI = 4 //Price passed by developer through SDK API
};
estimatePrice double SDK estimated price, only supported by AdMob mediation,and SDK verion >=3.5.10
strategyPrice double Strategy-delivered sorting price, only supported by AdMob mediation,and SDK verion >=3.5.10

Methods

Method Return Type Description
toDictionary NSDictionary * Convert MCIAdInfo object to dictionary format

NetworkId Mapping

The following table shows the mapping between networkId field and ad network names:

NetworkId Ad Network Name Notes
1 Facebook/Meta Facebook ad network
2 AdMob Google AdMob
3 InMobi InMobi ad network
5 AppLovin AppLovin ad network
6 Mintegral Mintegral ad network
8 GDT Tencent Ad Network
9 Chartboost Chartboost ad network
11 IronSource IronSource ad network
12 Unity Ads Unity ad network
13 Vungle/Liftoff Vungle ad network
14 AdColony AdColony ad network
15 CSJ Pangle ad network
22 Baidu Baidu ad network
23 Nend Nend ad network
24 Maio Maio ad network
25 Start.io Start.io ad network
28 KuaiShou Kuaishou ad network
29 SigMob SigMob ad network
32 MyTarget/VK MyTarget ad network
33 Google Ad Manager Google Ad Manager
34 Yandex Yandex ad network
35 MyOffer TopOn cross promotion
36 Ogury Ogury ad network
37 Fyber Fyber ad network
40 Helium Helium ad network
45 Kidoz Kidoz ad network
46 GroMore ByteDance mediation ads
48 A4G A4G ad network
50 Pangle Pangle ad network
51 Klevin Klevin ad network
58 Verve/PubNative Verve ad network
59 BigoAds Bigo ad network
65 BidMachine BidMachine ad network
66 TopOn ADX TopOn ad exchange
67 Direct Offer Direct ad placement
72 JingDong JD ad network
74 QuMeng QuMeng ad network
75 Amazon Amazon ad network
77 Kwai Network Kuaishou overseas ad network
78 TopOn ADX 2 TopOn ad exchange 2
82 TanX Alibaba TanX
84 Smaato Smaato ad network
85 HyprMX HyprMX ad network
86 LINE LINE ad network
88 MobileFuse MobileFuse ad network
89 PubMatic PubMatic ad network
90 YSONetwork YSONetwork ad network
91 Moloco Moloco ad network
92 P Mediation P Mediation ad network
Previous
Banner Ads
Next
How to Test
Last modified: 2025-07-11Powered by