{"data":{"id":"365447","string_id":"adNSe1Df","status":"1","parent_id":"387208","slug":"F8bFhlSy","order":"9","name":"AD Formats","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","published_time":"1741749128","add_time":"1741749128","update_time":"1780650154","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"1","tags":[],"parent_name":"HyperBid Tools SDK","parent_type":"1","parent_slug":"Hyperbid-Tools-SDK","child":[{"id":"758440","string_id":"h6aH1Tvz","status":"1","parent_id":"365447","slug":"Interstitial-Ads-UhvX","order":"5","name":"Interstitial Ads","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1775184583","add_time":"1775184535","update_time":"1780650227","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"758440","content":"> **\ud83d\udca1Tips**\n>\n> - \ud83d\ude80 Smart Cache automatically manages multi-placement parallel loading and cache comparison \u2014 no need to manually manage multiple `MCInterstitialAd` instances\n> - \u26a0\ufe0f `MCInterstitialAdManager` is a normal instance class; recommended to hold as a property\n> - \ud83d\udd27 SDK auto-replenishes after display; simply check `isReady` \u2192 `showAd` again to reuse\n> - To take manual control of loading and caching, see [here](https:\/\/help.hyperbid.com\/docs\/Interstitial-Ads-iOS)\n\n---\n\n## 1. Load Ad\n\n```objective-c\n#import \n\n@interface SmartCacheInterstitialVC () \n\n@property (nonatomic, strong) MCInterstitialAdManager *interstitialManager;\n\n@end\n\n@implementation SmartCacheInterstitialVC\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.interstitialManager) {\n self.interstitialManager = [[MCInterstitialAdManager alloc] init];\n }\n \/\/ Set delegate before the first loadAd call\n self.interstitialManager.delegate = self;\n [self.interstitialManager loadAd];\n}\n\n#pragma mark - MCSmartCacheDelegate\n\/\/ At least one ad in cache pool is ready\n- (void)smartCacheDidLoadAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ All placements failed in first round (mutually exclusive with smartCacheDidLoadAd:)\n- (void)smartCacheDidFailToLoadAdWithError:(MCError *)error {\n\n}\n\n\/\/ Current round loading completed\n- (void)smartCacheDidAdLoadFinished {\n\n}\n\n\/\/ Ad displayed successfully\n- (void)smartCacheDidDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed; SDK auto-replenishes\n- (void)smartCacheDidHideAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad clicked\n- (void)smartCacheDidClickAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad display failed\n- (void)smartCacheDidFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n\n}\n\n\/\/ Revenue callback\n- (void)smartCacheDidPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Rewarded video exclusive callbacks \u2014 not triggered for interstitial; implement as empty\n- (void)smartCacheDidRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward { }\n- (void)smartCacheDidAdVideoStarted:(MCAdInfo *)ad { }\n- (void)smartCacheDidAdVideoCompleted:(MCAdInfo *)ad { }\n```\n\n---\n\n## 2. Show Ad\n\n```objective-c\nif ([self.interstitialManager isReady]) {\n \/\/ Pass the current top-level VC; can be nil for SDK default behavior\n [self.interstitialManager showAdWithViewController:self];\n}\n```\n\nTo pass a scene ID or other extra parameters:\n\n```objective-c\nif ([self.interstitialManager isReady]) {\n [self.interstitialManager showAdWithViewController:self\n withExtra:@{kMCAPIPlacementScenarioIDKey: @\"your scene id\"}];\n}\n```\n\n---\n\n## 3. Release Resources\n\n```objective-c\n[self.interstitialManager destroyAd];\n```\n\n> Call `destroyAd` when the page or module is destroyed to release cache pool resources and avoid memory leaks. After release, `loadAd` must be called again to continue using.\n\n---\n\n## 4. Custom Parameter Configuration\n\n```objective-c\n- (void)loadAd {\n if (!self.interstitialManager) {\n self.interstitialManager = [[MCInterstitialAdManager alloc] init];\n }\n self.interstitialManager.delegate = self;\n\n \/\/ Set load extra parameters; call before loadAd\n [self.interstitialManager setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n\n \/\/ Set mediation extra parameters; call before loadAd\n [self.interstitialManager setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n\n [self.interstitialManager loadAd];\n}\n```","pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Smart Cache automatically manages multi-placement parallel loading and cache comparison \u2014 no need to manually manage multiple MCInterstitialAd instances\n\u26a0\ufe0f MCInterstitialAdManager is a normal instance class; recommended to hold as a property\n\ud83d\udd27 SDK auto-replenishes after display; simply check isReady \u2192 showAd again to reuse\nTo take manual control of loading and caching, see here\n\n\n\n\n1. Load Ad\n#import \n\n@interface SmartCacheInterstitialVC () \n\n@property (nonatomic, strong) MCInterstitialAdManager *interstitialManager;\n\n@end\n\n@implementation SmartCacheInterstitialVC\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.interstitialManager) {\n self.interstitialManager = [[MCInterstitialAdManager alloc] init];\n }\n \/\/ Set delegate before the first loadAd call\n self.interstitialManager.delegate = self;\n [self.interstitialManager loadAd];\n}\n\n#pragma mark - MCSmartCacheDelegate\n\/\/ At least one ad in cache pool is ready\n- (void)smartCacheDidLoadAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ All placements failed in first round (mutually exclusive with smartCacheDidLoadAd:)\n- (void)smartCacheDidFailToLoadAdWithError:(MCError *)error {\n\n}\n\n\/\/ Current round loading completed\n- (void)smartCacheDidAdLoadFinished {\n\n}\n\n\/\/ Ad displayed successfully\n- (void)smartCacheDidDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed; SDK auto-replenishes\n- (void)smartCacheDidHideAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad clicked\n- (void)smartCacheDidClickAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad display failed\n- (void)smartCacheDidFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n\n}\n\n\/\/ Revenue callback\n- (void)smartCacheDidPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Rewarded video exclusive callbacks \u2014 not triggered for interstitial; implement as empty\n- (void)smartCacheDidRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward { }\n- (void)smartCacheDidAdVideoStarted:(MCAdInfo *)ad { }\n- (void)smartCacheDidAdVideoCompleted:(MCAdInfo *)ad { }\n\n\n2. Show Ad\nif ([self.interstitialManager isReady]) {\n \/\/ Pass the current top-level VC; can be nil for SDK default behavior\n [self.interstitialManager showAdWithViewController:self];\n}\n\nTo pass a scene ID or other extra parameters:\nif ([self.interstitialManager isReady]) {\n [self.interstitialManager showAdWithViewController:self\n withExtra:@{kMCAPIPlacementScenarioIDKey: @\"your scene id\"}];\n}\n\n\n3. Release Resources\n[self.interstitialManager destroyAd];\n\n\nCall destroyAd when the page or module is destroyed to release cache pool resources and avoid memory leaks. After release, loadAd must be called again to continue using.\n\n\n4. Custom Parameter Configuration\n- (void)loadAd {\n if (!self.interstitialManager) {\n self.interstitialManager = [[MCInterstitialAdManager alloc] init];\n }\n self.interstitialManager.delegate = self;\n\n \/\/ Set load extra parameters; call before loadAd\n [self.interstitialManager setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n\n \/\/ Set mediation extra parameters; call before loadAd\n [self.interstitialManager setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n\n [self.interstitialManager loadAd];\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1775184535","update_time":"1780650227"},"pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Smart Cache automatically manages multi-placement parallel loading and cache comparison \u2014 no need to manually manage multiple MCInterstitialAd instances\n\u26a0\ufe0f MCInterstitialAdManager is a norma"},{"id":"758441","string_id":"vqY6w7Ut","status":"1","parent_id":"365447","slug":"Rewarded-Video-Ads-OUqh","order":"4","name":"Rewarded Video Ads","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1775184583","add_time":"1775184548","update_time":"1780650272","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"758441","content":"> **\ud83d\udca1Tips**\n>\n> - \ud83d\ude80 Smart Cache automatically manages multi-placement parallel loading and cache comparison \u2014 no need to manually manage multiple `MCRewardedAd` instances\n> - \u26a0\ufe0f `MCRewardAdManager` is a normal instance class; recommended to hold as a property\n> - \ud83d\udd27 Use the `smartCacheDidRewardUserForAd:withReward:` callback to confirm reward distribution \u2014 this is the only reliable reward delivery trigger\n> - To take manual control of loading and caching, see [here](https:\/\/help.hyperbid.com\/docs\/Rewarded-Ads-iOS)\n\n---\n\n## 1. Load Ad\n\n```objective-c\n#import \n\n@interface SmartCacheRewardedVC () \n\n@property (nonatomic, strong) MCRewardAdManager *rewardManager;\n\n@end\n\n@implementation SmartCacheRewardedVC\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.rewardManager) {\n self.rewardManager = [[MCRewardAdManager alloc] init];\n }\n \/\/ Set delegate before the first loadAd call\n self.rewardManager.delegate = self;\n [self.rewardManager loadAd];\n}\n\n#pragma mark - MCSmartCacheDelegate\n\/\/ At least one ad in cache pool is ready\n- (void)smartCacheDidLoadAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ All placements failed in first round (mutually exclusive with smartCacheDidLoadAd:)\n- (void)smartCacheDidFailToLoadAdWithError:(MCError *)error {\n\n}\n\n\/\/ Current round loading completed\n- (void)smartCacheDidAdLoadFinished {\n\n}\n\n\/\/ Ad displayed successfully\n- (void)smartCacheDidDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed; SDK auto-replenishes\n- (void)smartCacheDidHideAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad clicked\n- (void)smartCacheDidClickAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad display failed\n- (void)smartCacheDidFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n\n}\n\n\/\/ Revenue callback\n- (void)smartCacheDidPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ User met reward conditions (the only reliable reward delivery trigger)\n- (void)smartCacheDidRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward {\n\n}\n\n\/\/ Video started playing\n- (void)smartCacheDidAdVideoStarted:(MCAdInfo *)ad {\n\n}\n\n\/\/ Video playback completed\n- (void)smartCacheDidAdVideoCompleted:(MCAdInfo *)ad {\n\n}\n```\n\n---\n\n## 2. Show Ad\n\n```objective-c\nif ([self.rewardManager isReady]) {\n [self.rewardManager showAdWithViewController:self];\n}\n```\n\nTo pass a scene ID or other extra parameters:\n\n```objective-c\nif ([self.rewardManager isReady]) {\n [self.rewardManager showAdWithViewController:self\n withExtra:@{kMCAPIPlacementScenarioIDKey: @\"your scene id\"}];\n}\n```\n\n---\n\n## 3. Reward Distribution\n\nUse the `MCSmartCacheDelegate` callback to confirm reward distribution:\n\n```objective-c\n\/\/ User met reward conditions\n- (void)smartCacheDidRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward {\n \/\/ Grant reward here\n}\n```\n\nRewarded video auxiliary callbacks:\n\n```objective-c\n\/\/ Video started playing\n- (void)smartCacheDidAdVideoStarted:(MCAdInfo *)ad { }\n\n\/\/ Video playback completed\n- (void)smartCacheDidAdVideoCompleted:(MCAdInfo *)ad { }\n```\n\n---\n\n## 4. Release Resources\n\n```objective-c\n[self.rewardManager destroyAd];\n```\n\n> Call `destroyAd` when the page or module is destroyed to release cache pool resources and avoid memory leaks. After release, `loadAd` must be called again to continue using.\n\n---\n\n## 5. Custom Parameter Configuration\n\n```objective-c\n- (void)loadAd {\n if (!self.rewardManager) {\n self.rewardManager = [[MCRewardAdManager alloc] init];\n }\n self.rewardManager.delegate = self;\n\n \/\/ Set load extra parameters; call before loadAd\n [self.rewardManager setLoadExtraParameter:@{\n @\"userID\": @\"test_userId\",\n @\"userData\": @\"test_userData\"\n }];\n\n \/\/ Set mediation extra parameters; call before loadAd\n [self.rewardManager setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n\n [self.rewardManager loadAd];\n}\n```","pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Smart Cache automatically manages multi-placement parallel loading and cache comparison \u2014 no need to manually manage multiple MCRewardedAd instances\n\u26a0\ufe0f MCRewardAdManager is a normal instance class; recommended to hold as a property\n\ud83d\udd27 Use the smartCacheDidRewardUserForAd:withReward: callback to confirm reward distribution \u2014 this is the only reliable reward delivery trigger\nTo take manual control of loading and caching, see here\n\n\n\n\n1. Load Ad\n#import \n\n@interface SmartCacheRewardedVC () \n\n@property (nonatomic, strong) MCRewardAdManager *rewardManager;\n\n@end\n\n@implementation SmartCacheRewardedVC\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.rewardManager) {\n self.rewardManager = [[MCRewardAdManager alloc] init];\n }\n \/\/ Set delegate before the first loadAd call\n self.rewardManager.delegate = self;\n [self.rewardManager loadAd];\n}\n\n#pragma mark - MCSmartCacheDelegate\n\/\/ At least one ad in cache pool is ready\n- (void)smartCacheDidLoadAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ All placements failed in first round (mutually exclusive with smartCacheDidLoadAd:)\n- (void)smartCacheDidFailToLoadAdWithError:(MCError *)error {\n\n}\n\n\/\/ Current round loading completed\n- (void)smartCacheDidAdLoadFinished {\n\n}\n\n\/\/ Ad displayed successfully\n- (void)smartCacheDidDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed; SDK auto-replenishes\n- (void)smartCacheDidHideAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad clicked\n- (void)smartCacheDidClickAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad display failed\n- (void)smartCacheDidFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n\n}\n\n\/\/ Revenue callback\n- (void)smartCacheDidPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ User met reward conditions (the only reliable reward delivery trigger)\n- (void)smartCacheDidRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward {\n\n}\n\n\/\/ Video started playing\n- (void)smartCacheDidAdVideoStarted:(MCAdInfo *)ad {\n\n}\n\n\/\/ Video playback completed\n- (void)smartCacheDidAdVideoCompleted:(MCAdInfo *)ad {\n\n}\n\n\n2. Show Ad\nif ([self.rewardManager isReady]) {\n [self.rewardManager showAdWithViewController:self];\n}\n\nTo pass a scene ID or other extra parameters:\nif ([self.rewardManager isReady]) {\n [self.rewardManager showAdWithViewController:self\n withExtra:@{kMCAPIPlacementScenarioIDKey: @\"your scene id\"}];\n}\n\n\n3. Reward Distribution\nUse the MCSmartCacheDelegate callback to confirm reward distribution:\n\/\/ User met reward conditions\n- (void)smartCacheDidRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward {\n \/\/ Grant reward here\n}\n\nRewarded video auxiliary callbacks:\n\/\/ Video started playing\n- (void)smartCacheDidAdVideoStarted:(MCAdInfo *)ad { }\n\n\/\/ Video playback completed\n- (void)smartCacheDidAdVideoCompleted:(MCAdInfo *)ad { }\n\n\n4. Release Resources\n[self.rewardManager destroyAd];\n\n\nCall destroyAd when the page or module is destroyed to release cache pool resources and avoid memory leaks. After release, loadAd must be called again to continue using.\n\n\n5. Custom Parameter Configuration\n- (void)loadAd {\n if (!self.rewardManager) {\n self.rewardManager = [[MCRewardAdManager alloc] init];\n }\n self.rewardManager.delegate = self;\n\n \/\/ Set load extra parameters; call before loadAd\n [self.rewardManager setLoadExtraParameter:@{\n @\"userID\": @\"test_userId\",\n @\"userData\": @\"test_userData\"\n }];\n\n \/\/ Set mediation extra parameters; call before loadAd\n [self.rewardManager setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n\n [self.rewardManager loadAd];\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1775184548","update_time":"1780650260"},"pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Smart Cache automatically manages multi-placement parallel loading and cache comparison \u2014 no need to manually manage multiple MCRewardedAd instances\n\u26a0\ufe0f MCRewardAdManager is a normal instance"},{"id":"758439","string_id":"4RKvwYad","status":"1","parent_id":"365447","slug":"App-Open-Ads-8jMh","order":"3","name":"App Open Ads","type":"2","cover":"","cover_alt":"","desc":null,"website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"Welch","published_time":"1775184583","add_time":"1775184511","update_time":"1780650278","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"758439","content":"> **\ud83d\udca1Tips**\n>\n> - \ud83d\ude80 Smart Cache automatically manages multi-placement parallel loading and cache comparison \u2014 no need to manually manage multiple `MCAppOpenAd` instances\n> - \u26a0\ufe0f `MCAppOpenAdManager` is a normal instance class; recommended to hold as a property; requires `UIWindow` and `UIViewController` for display\n> - \ud83d\udd27 Use `setAppOpenContainerView:` to set the container view and `setLoadAdTimeout:` to set load timeout\n> - To take manual control of loading and caching, see [here](https:\/\/help.hyperbid.com\/docs\/Splash-Ads-iOS)\n\n---\n\n## 1. Load Ad\n\n```objective-c\n#import \n\n@interface SmartCacheAppOpenVC () \n\n@property (nonatomic, strong) MCAppOpenAdManager *appOpenManager;\n\n@end\n\n@implementation SmartCacheAppOpenVC\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.appOpenManager) {\n self.appOpenManager = [[MCAppOpenAdManager alloc] init];\n }\n \/\/ Set delegate before the first loadAd call\n self.appOpenManager.delegate = self;\n\n \/\/ (Optional) Set container view\n \/\/ [self.appOpenManager setAppOpenContainerView:containerView];\n\n \/\/ (Optional) Set load timeout in seconds (recommended 5-10 seconds)\n \/\/ [self.appOpenManager setLoadAdTimeout:5.0];\n\n [self.appOpenManager loadAd];\n}\n\n#pragma mark - MCSmartCacheDelegate\n\/\/ At least one ad in cache pool is ready\n- (void)smartCacheDidLoadAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ All placements failed in first round (mutually exclusive with smartCacheDidLoadAd:)\n- (void)smartCacheDidFailToLoadAdWithError:(MCError *)error {\n\n}\n\n\/\/ Current round loading completed\n- (void)smartCacheDidAdLoadFinished {\n\n}\n\n\/\/ Ad displayed successfully\n- (void)smartCacheDidDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed; SDK auto-replenishes\n- (void)smartCacheDidHideAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad clicked\n- (void)smartCacheDidClickAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad display failed\n- (void)smartCacheDidFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n\n}\n\n\/\/ Revenue callback\n- (void)smartCacheDidPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Rewarded video exclusive callbacks \u2014 not triggered for App Open; implement as empty\n- (void)smartCacheDidRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward { }\n- (void)smartCacheDidAdVideoStarted:(MCAdInfo *)ad { }\n- (void)smartCacheDidAdVideoCompleted:(MCAdInfo *)ad { }\n```\n\n---\n\n## 2. Show Ad\n\n```objective-c\nif ([self.appOpenManager isReady]) {\n \/\/ window can be nil to use key window; viewController can be nil for top-level VC\n [self.appOpenManager showAdWithWindow:nil viewController:self];\n}\n```\n\nTo pass a scene ID or other extra parameters:\n\n```objective-c\nif ([self.appOpenManager isReady]) {\n [self.appOpenManager showAdWithWindow:nil\n viewController:self\n withExtra:@{kMCAPIPlacementScenarioIDKey: @\"your scene id\"}];\n}\n```\n\n---\n\n## 3. Release Resources\n\n```objective-c\n[self.appOpenManager destroyAd];\n```\n\n> Call `destroyAd` when the page or module is destroyed to release cache pool resources and avoid memory leaks. After release, `loadAd` must be called again to continue using.\n\n---\n\n## 4. Custom Parameter Configuration\n\n```objective-c\n- (void)loadAd {\n if (!self.appOpenManager) {\n self.appOpenManager = [[MCAppOpenAdManager alloc] init];\n }\n self.appOpenManager.delegate = self;\n\n \/\/ (Optional) Set container view\n \/\/ [self.appOpenManager setAppOpenContainerView:containerView];\n\n \/\/ (Optional) Set load timeout in seconds\n \/\/ [self.appOpenManager setLoadAdTimeout:5.0];\n\n \/\/ Set load extra parameters; call before loadAd\n [self.appOpenManager setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n\n \/\/ Set mediation extra parameters; call before loadAd\n [self.appOpenManager setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n\n [self.appOpenManager loadAd];\n}\n```\n\n### MCAppOpenAdManager-Specific API\n\n| Method | Description |\n|--------|-------------|\n| `setAppOpenContainerView:` | Set the App Open ad container view |\n| `setLoadAdTimeout:` | Set load timeout (`NSTimeInterval`, in seconds; recommended 5-10 seconds) |","pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Smart Cache automatically manages multi-placement parallel loading and cache comparison \u2014 no need to manually manage multiple MCAppOpenAd instances\n\u26a0\ufe0f MCAppOpenAdManager is a normal instance class; recommended to hold as a property; requires UIWindow and UIViewController for display\n\ud83d\udd27 Use setAppOpenContainerView: to set the container view and setLoadAdTimeout: to set load timeout\nTo take manual control of loading and caching, see here\n\n\n\n\n1. Load Ad\n#import \n\n@interface SmartCacheAppOpenVC () \n\n@property (nonatomic, strong) MCAppOpenAdManager *appOpenManager;\n\n@end\n\n@implementation SmartCacheAppOpenVC\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.appOpenManager) {\n self.appOpenManager = [[MCAppOpenAdManager alloc] init];\n }\n \/\/ Set delegate before the first loadAd call\n self.appOpenManager.delegate = self;\n\n \/\/ (Optional) Set container view\n \/\/ [self.appOpenManager setAppOpenContainerView:containerView];\n\n \/\/ (Optional) Set load timeout in seconds (recommended 5-10 seconds)\n \/\/ [self.appOpenManager setLoadAdTimeout:5.0];\n\n [self.appOpenManager loadAd];\n}\n\n#pragma mark - MCSmartCacheDelegate\n\/\/ At least one ad in cache pool is ready\n- (void)smartCacheDidLoadAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ All placements failed in first round (mutually exclusive with smartCacheDidLoadAd:)\n- (void)smartCacheDidFailToLoadAdWithError:(MCError *)error {\n\n}\n\n\/\/ Current round loading completed\n- (void)smartCacheDidAdLoadFinished {\n\n}\n\n\/\/ Ad displayed successfully\n- (void)smartCacheDidDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed; SDK auto-replenishes\n- (void)smartCacheDidHideAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad clicked\n- (void)smartCacheDidClickAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad display failed\n- (void)smartCacheDidFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n\n}\n\n\/\/ Revenue callback\n- (void)smartCacheDidPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Rewarded video exclusive callbacks \u2014 not triggered for App Open; implement as empty\n- (void)smartCacheDidRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward { }\n- (void)smartCacheDidAdVideoStarted:(MCAdInfo *)ad { }\n- (void)smartCacheDidAdVideoCompleted:(MCAdInfo *)ad { }\n\n\n2. Show Ad\nif ([self.appOpenManager isReady]) {\n \/\/ window can be nil to use key window; viewController can be nil for top-level VC\n [self.appOpenManager showAdWithWindow:nil viewController:self];\n}\n\nTo pass a scene ID or other extra parameters:\nif ([self.appOpenManager isReady]) {\n [self.appOpenManager showAdWithWindow:nil\n viewController:self\n withExtra:@{kMCAPIPlacementScenarioIDKey: @\"your scene id\"}];\n}\n\n\n3. Release Resources\n[self.appOpenManager destroyAd];\n\n\nCall destroyAd when the page or module is destroyed to release cache pool resources and avoid memory leaks. After release, loadAd must be called again to continue using.\n\n\n4. Custom Parameter Configuration\n- (void)loadAd {\n if (!self.appOpenManager) {\n self.appOpenManager = [[MCAppOpenAdManager alloc] init];\n }\n self.appOpenManager.delegate = self;\n\n \/\/ (Optional) Set container view\n \/\/ [self.appOpenManager setAppOpenContainerView:containerView];\n\n \/\/ (Optional) Set load timeout in seconds\n \/\/ [self.appOpenManager setLoadAdTimeout:5.0];\n\n \/\/ Set load extra parameters; call before loadAd\n [self.appOpenManager setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n\n \/\/ Set mediation extra parameters; call before loadAd\n [self.appOpenManager setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n\n [self.appOpenManager loadAd];\n}\n\nMCAppOpenAdManager-Specific API\n\n\n\n Method\n Description\n\n\n\n\n setAppOpenContainerView:\n Set the App Open ad container view\n\n\n setLoadAdTimeout:\n Set load timeout (NSTimeInterval, in seconds; recommended 5-10 seconds)","is_draft":"0","editor_type":"2","file_path":"","add_time":"1775184511","update_time":"1780650278"},"pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Smart Cache automatically manages multi-placement parallel loading and cache comparison \u2014 no need to manually manage multiple MCAppOpenAd instances\n\u26a0\ufe0f MCAppOpenAdManager is a normal instance"},{"id":"365451","string_id":"s7CFBAn6","status":"1","parent_id":"365447","slug":"Native-Ads-iOS","order":"2","name":"Native Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"Native Ads","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","published_time":"1741749129","add_time":"1741749129","update_time":"1780650185","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"365451","content":"> **\ud83d\udca1Tips** \n> - \ud83d\ude80 Use preloading mechanism to enhance UX \n> - \u26a0\ufe0f Handle lifecycle properly to prevent memory leaks \n> - \ud83d\udd27 Recommended to use standardized callback workflow \n\n---\n\n## 1. Loading a Native Ad\n\n```objective-c\n#import \n@interface SelfRenderVC () \n\n@property (nonatomic, strong) MCNativeAdLoader * nativeAdLoader;\n@property (nonatomic, strong) MCNativeAdView * nativeAdView;\n@property (nonatomic, strong) MCAdInfo * adInfo;\n@property (nonatomic, assign) NSInteger retryAttempt;\n\n@end\n\n@implementation SelfRenderVC\n\n#define Native_SelfRender_PlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define Native_SelfRender_SceneID @\"\"\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.nativeAdLoader) {\n MCNativeAdLoader *nativeAdLoader = [[MCNativeAdLoader alloc] initWithPlacementId:Native_SelfRender_PlacementID];\n self.nativeAdLoader = nativeAdLoader;\n }\n self.nativeAdLoader.delegate = self;\n self.nativeAdLoader.revenueDelegate = self;\n self.nativeAdLoader.placement = Native_SelfRender_SceneID;\n\n [self.nativeAdLoader loadAd];\n}\n\n#pragma mark - MCNativeAdDelegate\n\/\/ Ad load success\n- (void)didLoadNativeAd:(nullable MCNativeAdView *)nativeAdView forAd:(MCAdInfo *_Nonnull)ad {\n \/\/ For self-rendering, you need to create MCNativeAdView\n if (!ad.nativeAd.isTemplate) {\n CGFloat scale = 4.0\/3.0;\n CGFloat viewW = CGRectGetWidth([UIScreen mainScreen].bounds);\n CGFloat viewH = viewW\/scale;\n _nativeAdView = [[MCNativeAdView alloc] initWithFrame:CGRectMake(0, 0, viewW, viewH)];\n } else {\n _nativeAdView = nativeAdView;\n }\n \n _adInfo = ad;\n \n \/\/ Reset retry attempt\n self.retryAttempt = 0;\n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadNativeAdWithError:(MCError *_Nonnull)error { \n \/\/ We recommends that you retry with exponentially higher delays up to a maximum delay (in this case 8 seconds) or the maximum number of retries (in this case 3)\n if (self.retryAttempt >= 3) {\n return;\n }\n self.retryAttempt++;\n \n NSInteger delaySec = pow(2, MIN(3, self.retryAttempt));\n\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self.nativeAdLoader loadAd];\n });\n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *_Nonnull)ad {\n\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad {\n \/\/pre-load\n [self.nativeAdLoader loadAd];\n}\n\n\/\/ Ad display failure\n- (void)didFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n \/\/pre-load\n [self.nativeAdLoader loadAd];\n}\n\n\/\/ Ad click\n- (void)didClickNativeAd:(MCAdInfo *_Nonnull)ad {\n\n}\n\n#pragma mark - MCAdRevenueDelegate\n\/\/ Revenue tracking\n- (void)didPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n```\n\n---\n\n## 2. Showing a Native Ad\n\n> For self-rendering, please refer to[Demo-`SelfRenderVC.m`](https:\/\/github.com\/hyperbidteam\/HyperBid-iOS-Demo\/blob\/main\/HyperBidDemo\/Ad(%E5%B9%BF%E5%91%8A%E6%A0%B7%E5%BC%8F)\/Native(%E5%8E%9F%E7%94%9F%E5%B9%BF%E5%91%8A)\/SingleSelfRenderAd(%E5%8D%95%E4%B8%AA%E8%87%AA%E6%B8%B2%E6%9F%93%E5%B9%BF%E5%91%8A)\/SelfRenderVC.m) \n\n```objective-c\nBOOL isready = self.nativeAdView ? YES : NO;\n\nif (!isready) {\n return;\n}\n\nATNativeSelfRenderView *selfRenderView = [[ATNativeSelfRenderView alloc] initWithAdInfo:self.adInfo];\nselfRenderView.backgroundColor = randomColor;\nselfRenderView.frame = self.nativeAdView.frame;\nself.nativeSelfRenderView = selfRenderView;\n\nNSMutableArray *array = [@[selfRenderView.iconImageView,\n selfRenderView.titleLabel,\n selfRenderView.textLabel,\n selfRenderView.ctaLabel,\n selfRenderView.mainImageView] mutableCopy];\n[self.nativeAdView registerClickableViewArray:array];\n\nMCNativePrepareInfo *nativePrepareInfo = [MCNativePrepareInfo loadPrepareInfo:^(MCNativePrepareInfo * _Nonnull prepareInfo) {\n prepareInfo.textLabel = selfRenderView.textLabel;\n prepareInfo.advertiserLabel = selfRenderView.advertiserLabel;\n prepareInfo.titleLabel = selfRenderView.titleLabel;\n prepareInfo.ratingLabel = selfRenderView.ratingLabel;\n prepareInfo.iconImageView = selfRenderView.iconImageView;\n prepareInfo.mainImageView = selfRenderView.mainImageView;\n prepareInfo.dislikeButton = selfRenderView.dislikeButton;\n prepareInfo.ctaLabel = selfRenderView.ctaLabel;\n prepareInfo.domainLabel = selfRenderView.domainLabel;\n prepareInfo.warningLabel = selfRenderView.warningLabel;\n prepareInfo.mediaView = selfRenderView.mediaView;\n}];\n[self.nativeAdView prepareWithNativePrepareInfo:nativePrepareInfo];\n\n[self.nativeAdLoader rendererWithNativeAdView:self.nativeAdView selfRenderView:selfRenderView adInfo:self.adInfo];\n\nATNativeShowViewController *showVc = [[ATNativeShowViewController alloc] initWithAdView:self.nativeAdView];\n[self.navigationController pushViewController:showVc animated:YES];\nself.hasShowAD = YES;\n```\n\n> For template rendering, please refer to[Demo-`ExpressVC.m`](https:\/\/github.com\/hyperbidteam\/HyperBid-iOS-Demo\/blob\/main\/HyperBidDemo\/Ad(%E5%B9%BF%E5%91%8A%E6%A0%B7%E5%BC%8F)\/Native(%E5%8E%9F%E7%94%9F%E5%B9%BF%E5%91%8A)\/SingleExpressAd(%E5%8D%95%E4%B8%AA%E6%A8%A1%E7%89%88%E5%B9%BF%E5%91%8A)\/ExpressVC.m)\n\n```objective-c\nBOOL isready = self.nativeAdView ? YES : NO;\n\nif (!isready) {\n return;\n}\n\nATNativeShowViewController *showVc = [[ATNativeShowViewController alloc] initWithAdView:self.nativeAdView];\n[self.navigationController pushViewController:showVc animated:YES];\nself.hasShowAD = YES;\n```\n\n---\n\n## 3. Resource Release\n\n```objective-c\n- (void)destroy {\n if (_adInfo) {\n [self showLog:[NSString stringWithFormat:@\"destroy:%@\", _adInfo.mediationPlacementId]];\n [self.nativeAdLoader destroyAd];\n _nativeAdView = nil;\n _adInfo = nil;\n }\n}\n```\n\n---\n\n## 4. Customized Parameter Configuration\n\n```objective-c\n- (void)loadAd {\n MCNativeAdLoader *nativeAdLoader = [[MCNativeAdLoader alloc] initWithPlacementId:self.placementID];\n nativeAdLoader.delegate = self;\n nativeAdLoader.revenueDelegate = self;\n \n [nativeAdLoader setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n \n [nativeAdLoader setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [nativeAdLoader loadAd];\n self.nativeAdLoader = nativeAdLoader;\n}\n\n- (void)didLoadAd:(MCAdInfo *)ad {\n \/\/ Retrieve customized parameters\n NSString *originDataJsonString = ad.originData;\n}\n```","pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Use preloading mechanism to enhance UX\n\u26a0\ufe0f Handle lifecycle properly to prevent memory leaks\n\ud83d\udd27 Recommended to use standardized callback workflow\n\n\n\n1. Loading a Native Ad\n#import \n@interface SelfRenderVC () \n\n@property (nonatomic, strong) MCNativeAdLoader * nativeAdLoader;\n@property (nonatomic, strong) MCNativeAdView * nativeAdView;\n@property (nonatomic, strong) MCAdInfo * adInfo;\n@property (nonatomic, assign) NSInteger retryAttempt;\n\n@end\n\n@implementation SelfRenderVC\n\n#define Native_SelfRender_PlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define Native_SelfRender_SceneID @\"\"\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.nativeAdLoader) {\n MCNativeAdLoader *nativeAdLoader = [[MCNativeAdLoader alloc] initWithPlacementId:Native_SelfRender_PlacementID];\n self.nativeAdLoader = nativeAdLoader;\n }\n self.nativeAdLoader.delegate = self;\n self.nativeAdLoader.revenueDelegate = self;\n self.nativeAdLoader.placement = Native_SelfRender_SceneID;\n\n [self.nativeAdLoader loadAd];\n}\n\n#pragma mark - MCNativeAdDelegate\n\/\/ Ad load success\n- (void)didLoadNativeAd:(nullable MCNativeAdView *)nativeAdView forAd:(MCAdInfo *_Nonnull)ad {\n \/\/ For self-rendering, you need to create MCNativeAdView\n if (!ad.nativeAd.isTemplate) {\n CGFloat scale = 4.0\/3.0;\n CGFloat viewW = CGRectGetWidth([UIScreen mainScreen].bounds);\n CGFloat viewH = viewW\/scale;\n _nativeAdView = [[MCNativeAdView alloc] initWithFrame:CGRectMake(0, 0, viewW, viewH)];\n } else {\n _nativeAdView = nativeAdView;\n }\n \n _adInfo = ad;\n \n \/\/ Reset retry attempt\n self.retryAttempt = 0;\n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadNativeAdWithError:(MCError *_Nonnull)error { \n \/\/ We recommends that you retry with exponentially higher delays up to a maximum delay (in this case 8 seconds) or the maximum number of retries (in this case 3)\n if (self.retryAttempt >= 3) {\n return;\n }\n self.retryAttempt++;\n \n NSInteger delaySec = pow(2, MIN(3, self.retryAttempt));\n\n dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delaySec * NSEC_PER_SEC), dispatch_get_main_queue(), ^{\n [self.nativeAdLoader loadAd];\n });\n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *_Nonnull)ad {\n\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad {\n \/\/pre-load\n [self.nativeAdLoader loadAd];\n}\n\n\/\/ Ad display failure\n- (void)didFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n \/\/pre-load\n [self.nativeAdLoader loadAd];\n}\n\n\/\/ Ad click\n- (void)didClickNativeAd:(MCAdInfo *_Nonnull)ad {\n\n}\n\n#pragma mark - MCAdRevenueDelegate\n\/\/ Revenue tracking\n- (void)didPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\n2. Showing a Native Ad\n\nFor self-rendering, please refer toDemo-SelfRenderVC.m\n\nBOOL isready = self.nativeAdView ? YES : NO;\n\nif (!isready) {\n return;\n}\n\nATNativeSelfRenderView *selfRenderView = [[ATNativeSelfRenderView alloc] initWithAdInfo:self.adInfo];\nselfRenderView.backgroundColor = randomColor;\nselfRenderView.frame = self.nativeAdView.frame;\nself.nativeSelfRenderView = selfRenderView;\n\nNSMutableArray *array = [@[selfRenderView.iconImageView,\n selfRenderView.titleLabel,\n selfRenderView.textLabel,\n selfRenderView.ctaLabel,\n selfRenderView.mainImageView] mutableCopy];\n[self.nativeAdView registerClickableViewArray:array];\n\nMCNativePrepareInfo *nativePrepareInfo = [MCNativePrepareInfo loadPrepareInfo:^(MCNativePrepareInfo * _Nonnull prepareInfo) {\n prepareInfo.textLabel = selfRenderView.textLabel;\n prepareInfo.advertiserLabel = selfRenderView.advertiserLabel;\n prepareInfo.titleLabel = selfRenderView.titleLabel;\n prepareInfo.ratingLabel = selfRenderView.ratingLabel;\n prepareInfo.iconImageView = selfRenderView.iconImageView;\n prepareInfo.mainImageView = selfRenderView.mainImageView;\n prepareInfo.dislikeButton = selfRenderView.dislikeButton;\n prepareInfo.ctaLabel = selfRenderView.ctaLabel;\n prepareInfo.domainLabel = selfRenderView.domainLabel;\n prepareInfo.warningLabel = selfRenderView.warningLabel;\n prepareInfo.mediaView = selfRenderView.mediaView;\n}];\n[self.nativeAdView prepareWithNativePrepareInfo:nativePrepareInfo];\n\n[self.nativeAdLoader rendererWithNativeAdView:self.nativeAdView selfRenderView:selfRenderView adInfo:self.adInfo];\n\nATNativeShowViewController *showVc = [[ATNativeShowViewController alloc] initWithAdView:self.nativeAdView];\n[self.navigationController pushViewController:showVc animated:YES];\nself.hasShowAD = YES;\n\n\nFor template rendering, please refer toDemo-ExpressVC.m\n\nBOOL isready = self.nativeAdView ? YES : NO;\n\nif (!isready) {\n return;\n}\n\nATNativeShowViewController *showVc = [[ATNativeShowViewController alloc] initWithAdView:self.nativeAdView];\n[self.navigationController pushViewController:showVc animated:YES];\nself.hasShowAD = YES;\n\n\n3. Resource Release\n- (void)destroy {\n if (_adInfo) {\n [self showLog:[NSString stringWithFormat:@\"destroy:%@\", _adInfo.mediationPlacementId]];\n [self.nativeAdLoader destroyAd];\n _nativeAdView = nil;\n _adInfo = nil;\n }\n}\n\n\n4. Customized Parameter Configuration\n- (void)loadAd {\n MCNativeAdLoader *nativeAdLoader = [[MCNativeAdLoader alloc] initWithPlacementId:self.placementID];\n nativeAdLoader.delegate = self;\n nativeAdLoader.revenueDelegate = self;\n \n [nativeAdLoader setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n \n [nativeAdLoader setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [nativeAdLoader loadAd];\n self.nativeAdLoader = nativeAdLoader;\n}\n\n- (void)didLoadAd:(MCAdInfo *)ad {\n \/\/ Retrieve customized parameters\n NSString *originDataJsonString = ad.originData;\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1741749130","update_time":"1750935047"},"pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Use preloading mechanism to enhance UX\n\u26a0\ufe0f Handle lifecycle properly to prevent memory leaks\n\ud83d\udd27 Recommended to use standardized callback workflow\n\n\n\n1. Loading a Native Ad\n#import **\ud83d\udca1Tips** \n> - \ud83d\ude80 Use preloading mechanism to enhance UX \n> - \u26a0\ufe0f Handle lifecycle properly to prevent memory leaks \n> - \ud83d\udd27 Recommended to use standardized callback workflow \n> - \u2b50 **Auto-refresh feature** configuration: [HyperBid Tools Dashboard > Application > Edit Mediation Unit > Advanced Settings](https:\/\/portal.hyperbid.com\/m\/application) \n\n---\n\n## 1. Loading a Banner Ad\n\n```objective-c\n@interface BannerVC () \n\n@property (nonatomic, strong) UIView *adView;\n@property (nonatomic, strong) MCBannerAdView *bannerView;\n@property (nonatomic, assign) BOOL hasLoaded; \n\n@end\n\n@implementation BannerVC\n\n#define BannerPlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define BannerSceneID @\"\"\n\n\/\/Configure banner dimensions for example\uff1a320x50\n#define BannerSize CGSizeMake(320, 50)\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.bannerView) {\n _bannerView = [[MCBannerAdView alloc] initWithPlacementId:BannerPlacementID adFormat:[MCAdFormat banner]];\n }\n self.bannerView.delegate = self;\n self.bannerView.revenueDelegate = self;\n self.bannerView.bannerSize = BannerSize;\n self.bannerView.placement = BannerSceneID;\n \n [self.bannerView loadAd];\n}\n\n#pragma mark - MCBannerAdViewAdDelegate\n\/\/ Ad load success\n- (void)didLoadAd:(MCAdInfo *)ad {\n self.hasLoaded = YES; \n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadAdWithError:(MCError *)error {\n self.hasLoaded = NO; \n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad {\n [self removeAd];\n}\n\n\/\/ Ad click\n- (void)didClickAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad display failure\n- (void)didFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n\n}\n\n\/\/ Triggered when collapsible banner expands (if supported by ad network) \n- (void)didExpandAd:(MCAdInfo *)ad {\u00a0}\n\n\/\/ Triggered when collapsible banner collapses (if supported by ad network) \n- (void)didCollapseAd:(MCAdInfo *)ad { }\n\n#pragma mark - MCAdRevenueDelegate\n\/\/ Revenue tracking\n- (void)didPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n```\n\n---\n\n## 2. Showing a Banner Ad \n\n```objective-c\nBOOL isready = self.hasLoaded;\n\nif (isready && self.bannerView) {\n self.adView = [[UIView alloc]init];\n self.adView.backgroundColor = randomColor;\n [self.adView addSubview:self.bannerView];\n \n [self.view insertSubview:self.adView belowSubview:self.footView];\n \n [self.adView mas_makeConstraints:^(MASConstraintMaker *make) {\n make.height.equalTo(@(_adSize.height));\n make.width.equalTo(@(_adSize.width));\n make.top.equalTo(self.view).offset(100);\n }];\n \n [self.bannerView mas_makeConstraints:^(MASConstraintMaker *make) {\n make.edges.equalTo(self.adView);\n }];\n}\n```\n\n---\n\n## 3. Resource Release\n\n```objective-c\n\/\/ Remove BannerView\n- (void)removeAd {\n if (self.adView && self.adView.superview) {\n [self.adView removeFromSuperview];\n [self.bannerView destroyAd];\n _bannerView = nil;\n self.adView = nil;\n self.hasLoaded = NO;\n }\n}\n```\n\n---\n\n## 4. Customized Parameter Configuration\n\n```objective-c\n- (void)loadAd {\n MCBannerAdView *bannerView = [[MCBannerAdView alloc] initWithPlacementId:self.placementID];\n bannerView.delegate = self;\n bannerView.revenueDelegate = self;\n \n [bannerView setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n \n [bannerView setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [bannerView loadAd];\n self.bannerView = bannerView;\n}\n\n- (void)didLoadAd:(MCAdInfo *)ad {\n \/\/ Retrieve customized parameters\n NSString *originDataJsonString = ad.originData;\n} \n```","pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Use preloading mechanism to enhance UX\n\u26a0\ufe0f Handle lifecycle properly to prevent memory leaks\n\ud83d\udd27 Recommended to use standardized callback workflow\n\u2b50 Auto-refresh feature configuration: HyperBid Tools Dashboard > Application > Edit Mediation Unit > Advanced Settings\n\n\n\n\n1. Loading a Banner Ad\n@interface BannerVC () \n\n@property (nonatomic, strong) UIView *adView;\n@property (nonatomic, strong) MCBannerAdView *bannerView;\n@property (nonatomic, assign) BOOL hasLoaded; \n\n@end\n\n@implementation BannerVC\n\n#define BannerPlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define BannerSceneID @\"\"\n\n\/\/Configure banner dimensions for example\uff1a320x50\n#define BannerSize CGSizeMake(320, 50)\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.bannerView) {\n _bannerView = [[MCBannerAdView alloc] initWithPlacementId:BannerPlacementID adFormat:[MCAdFormat banner]];\n }\n self.bannerView.delegate = self;\n self.bannerView.revenueDelegate = self;\n self.bannerView.bannerSize = BannerSize;\n self.bannerView.placement = BannerSceneID;\n \n [self.bannerView loadAd];\n}\n\n#pragma mark - MCBannerAdViewAdDelegate\n\/\/ Ad load success\n- (void)didLoadAd:(MCAdInfo *)ad {\n self.hasLoaded = YES; \n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadAdWithError:(MCError *)error {\n self.hasLoaded = NO; \n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad {\n [self removeAd];\n}\n\n\/\/ Ad click\n- (void)didClickAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad display failure\n- (void)didFailToDisplayAd:(MCAdInfo *)ad withError:(MCError *)error {\n\n}\n\n\/\/ Triggered when collapsible banner expands (if supported by ad network) \n- (void)didExpandAd:(MCAdInfo *)ad {\u00a0}\n\n\/\/ Triggered when collapsible banner collapses (if supported by ad network) \n- (void)didCollapseAd:(MCAdInfo *)ad { }\n\n#pragma mark - MCAdRevenueDelegate\n\/\/ Revenue tracking\n- (void)didPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\n2. Showing a Banner Ad\nBOOL isready = self.hasLoaded;\n\nif (isready && self.bannerView) {\n self.adView = [[UIView alloc]init];\n self.adView.backgroundColor = randomColor;\n [self.adView addSubview:self.bannerView];\n \n [self.view insertSubview:self.adView belowSubview:self.footView];\n \n [self.adView mas_makeConstraints:^(MASConstraintMaker *make) {\n make.height.equalTo(@(_adSize.height));\n make.width.equalTo(@(_adSize.width));\n make.top.equalTo(self.view).offset(100);\n }];\n \n [self.bannerView mas_makeConstraints:^(MASConstraintMaker *make) {\n make.edges.equalTo(self.adView);\n }];\n}\n\n\n3. Resource Release\n\/\/ Remove BannerView\n- (void)removeAd {\n if (self.adView && self.adView.superview) {\n [self.adView removeFromSuperview];\n [self.bannerView destroyAd];\n _bannerView = nil;\n self.adView = nil;\n self.hasLoaded = NO;\n }\n}\n\n\n4. Customized Parameter Configuration\n- (void)loadAd {\n MCBannerAdView *bannerView = [[MCBannerAdView alloc] initWithPlacementId:self.placementID];\n bannerView.delegate = self;\n bannerView.revenueDelegate = self;\n \n [bannerView setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n \n [bannerView setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [bannerView loadAd];\n self.bannerView = bannerView;\n}\n\n- (void)didLoadAd:(MCAdInfo *)ad {\n \/\/ Retrieve customized parameters\n NSString *originDataJsonString = ad.originData;\n}","is_draft":"0","editor_type":"2","file_path":"","add_time":"1741749130","update_time":"1750935053"},"pure_content":"\ud83d\udca1Tips\n\n\ud83d\ude80 Use preloading mechanism to enhance UX\n\u26a0\ufe0f Handle lifecycle properly to prevent memory leaks\n\ud83d\udd27 Recommended to use standardized callback workflow\n\u2b50 Auto-refresh feature configuration: HyperBid"}],"content":{"icon":"","desc":"","content_id":"365447","add_time":"1741749128","update_time":"0","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}