{"data":{"id":"365447","string_id":"adNSe1Df","status":"1","parent_id":"387208","slug":"F8bFhlSy","order":"7","name":"AD Formats","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","add_time":"1741749128","update_time":"1759113813","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":"365448","string_id":"A3q4gweT","status":"1","parent_id":"365447","slug":"A3q4gweT","order":"0","name":"Rewarded Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1741749129","update_time":"1759113813","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"365448","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\n## **1. Loading a Rewarded Ad**\n\n```objective-c\n@interface RewardedVC () \n\n@property (nonatomic, strong) MCRewardedAd *rewardedAd;\n@property (nonatomic, assign) NSInteger retryAttempt;\n\n@end\n\n@implementation RewardedVC\n\n#define RewardedPlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define RewardedSceneID @\"\"\n\n#pragma mark - Load Ad\n- (void)loadAd { \n if (!self.rewardedAd) {\n self.rewardedAd = [[MCRewardedAd alloc] initWithPlacementId:RewardedPlacementID];\n }\n self.rewardedAd.delegate = self;\n self.rewardedAd.revenueDelegate = self;\n\n [self.rewardedAd loadAd];\n}\n \n#pragma mark - MCRewardedAdDelegate\n\/\/ Ad load success\n- (void)didLoadAd:(MCAdInfo *)ad {\n \/\/ Reset retry attempt\n self.retryAttempt = 0;\n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadAdWithError:(MCError *)error {\n\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 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.rewardedAd loadAd];\n });\n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *)ad {\n \/\/ pre-load\n [self.rewardedAd loadAd];\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad { \n \/\/ pre-load\n [self.rewardedAd loadAd];\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 \/\/ pre-load\n [self.rewardedAd loadAd];\n}\n\n\/\/ Reward triggered\n- (void)didRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward {\n \n}\n\n- (void)didAdVideoStarted:(MCAdInfo *)ad { }\n\n- (void)didAdVideoCompleted:(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 Rewarded Ad**\n\n```objective-c\nif ([self.rewardedAd isReady]) {\n [self.rewardedAd showAdWithViewController:self withExtra:@{kMCAPIPlacementScenarioIDKey:@\"your scene id\"}];\n} else {\n [self.rewardedAd loadAd];\n}\n```\n\n---\n\n## **3. Resource Release**\n\n```objective-c\n[self.rewardedAd destroyAd];\n```\n\n---\n\n## **4. Customized Parameter Configuration**\n\n```objective-c\n- (void)loadAd {\n MCRewardedAd *rewardeAd = [[MCRewardedAd alloc] initWithPlacementId:self.placementID];\n rewardeAd.delegate = self;\n rewardeAd.revenueDelegate = self;\n \n [rewardeAd setLoadExtraParameter:@{\n @\"userID\": @\"test_userId\",\n @\"userData\": @\"test_userData\"\n }];\n \n [rewardeAd setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [rewardeAd loadAd];\n self.rewardedAd = rewardeAd;\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 Rewarded Ad\n@interface RewardedVC () \n\n@property (nonatomic, strong) MCRewardedAd *rewardedAd;\n@property (nonatomic, assign) NSInteger retryAttempt;\n\n@end\n\n@implementation RewardedVC\n\n#define RewardedPlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define RewardedSceneID @\"\"\n\n#pragma mark - Load Ad\n- (void)loadAd { \n if (!self.rewardedAd) {\n self.rewardedAd = [[MCRewardedAd alloc] initWithPlacementId:RewardedPlacementID];\n }\n self.rewardedAd.delegate = self;\n self.rewardedAd.revenueDelegate = self;\n\n [self.rewardedAd loadAd];\n}\n \n#pragma mark - MCRewardedAdDelegate\n\/\/ Ad load success\n- (void)didLoadAd:(MCAdInfo *)ad {\n \/\/ Reset retry attempt\n self.retryAttempt = 0;\n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadAdWithError:(MCError *)error {\n\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 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.rewardedAd loadAd];\n });\n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *)ad {\n \/\/ pre-load\n [self.rewardedAd loadAd];\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad { \n \/\/ pre-load\n [self.rewardedAd loadAd];\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 \/\/ pre-load\n [self.rewardedAd loadAd];\n}\n\n\/\/ Reward triggered\n- (void)didRewardUserForAd:(MCAdInfo *)ad withReward:(MCReward *)reward {\n \n}\n\n- (void)didAdVideoStarted:(MCAdInfo *)ad { }\n\n- (void)didAdVideoCompleted:(MCAdInfo *)ad { }\n\n#pragma mark - MCAdRevenueDelegate\n\/\/ Revenue tracking\n- (void)didPayRevenueForAd:(MCAdInfo *)ad {\n \n}\n\n\n2. Showing a Rewarded Ad\nif ([self.rewardedAd isReady]) {\n [self.rewardedAd showAdWithViewController:self withExtra:@{kMCAPIPlacementScenarioIDKey:@\"your scene id\"}];\n} else {\n [self.rewardedAd loadAd];\n}\n\n\n3. Resource Release\n[self.rewardedAd destroyAd];\n\n\n4. Customized Parameter Configuration\n- (void)loadAd {\n MCRewardedAd *rewardeAd = [[MCRewardedAd alloc] initWithPlacementId:self.placementID];\n rewardeAd.delegate = self;\n rewardeAd.revenueDelegate = self;\n \n [rewardeAd setLoadExtraParameter:@{\n @\"userID\": @\"test_userId\",\n @\"userData\": @\"test_userData\"\n }];\n \n [rewardeAd setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [rewardeAd loadAd];\n self.rewardedAd = rewardeAd;\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":"1741749129","update_time":"1753089424"},"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 Rewarded Ad\n@interface Rewarde"},{"id":"365449","string_id":"w0xzGFGe","status":"1","parent_id":"365447","slug":"w0xzGFGe","order":"0","name":"Interstitial Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1741749129","update_time":"1759113813","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"365449","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\n## **1. Loading an Interstitial Ad** \n\n```objective-c\n#import \n\n@interface InterstitialVC () \n\n@property (nonatomic, strong) MCInterstitialAd *interstitialAd;\n@property (nonatomic, assign) NSInteger retryAttempt;\n\n@end\n\n@implementation InterstitialVC\n\n#define InterstitialPlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define InterstitialSceneID @\"\"\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.interstitialAd) {\n self.interstitialAd = [[MCInterstitialAd alloc] initWithPlacementId:InterstitialPlacementID];\n }\n self.interstitialAd.delegate = self;\n self.interstitialAd.revenueDelegate = self;\n \n [self.interstitialAd loadAd];\n}\n\n#pragma mark - MCAdDelegate\n\/\/ Ad load success\n- (void)didLoadAd:(MCAdInfo *)ad {\n \/\/ Reset retry attempt\n self.retryAttempt = 0;\n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadAdWithError:(MCError *)error {\n\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 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.interstitialAd loadAd];\n });\n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *)ad {\n \/\/ pre-load\n [self.interstitialAd loadAd];\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad { \n \/\/ pre-load\n [self.interstitialAd loadAd];\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 \/\/ pre-load\n [self.interstitialAd loadAd];\n}\n\n- (void)didAdVideoStarted:(MCAdInfo *)ad { }\n\n- (void)didAdVideoCompleted:(MCAdInfo *)ad { }\n\n#pragma mark - MCAdRevenueDelegate\n\/\/ Revenue tracking\n- (void)didPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n```\n\n---\n\n## **2. Showing an Interstitial Ad** \n\n```objective-c \nif ([self.interstitialAd isReady]) {\n [self.interstitialAd showAdWithViewController:self withExtra:@{kMCAPIPlacementScenarioIDKey:@\"your scene id\"}];\n} else {\n [self.interstitialAd loadAd];\n}\n```\n\n---\n\n## **3. Resource Release** \n\n```objective-c \n[self.interstitialAd destroyAd]; \n```\n\n---\n\n## **4. Customized Parameter Configuration**\n\n```objective-c \n- (void)loadAd {\n MCInterstitialAd *interstitialAd = [[MCInterstitialAd alloc] initWithPlacementId:self.placementID];\n interstitialAd.delegate = self;\n interstitialAd.revenueDelegate = self;\n \n [interstitialAd setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n \n [interstitialAd setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [interstitialAd loadAd];\n self.interstitialAd = interstitialAd;\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 an Interstitial Ad\n#import \n\n@interface InterstitialVC () \n\n@property (nonatomic, strong) MCInterstitialAd *interstitialAd;\n@property (nonatomic, assign) NSInteger retryAttempt;\n\n@end\n\n@implementation InterstitialVC\n\n#define InterstitialPlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define InterstitialSceneID @\"\"\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.interstitialAd) {\n self.interstitialAd = [[MCInterstitialAd alloc] initWithPlacementId:InterstitialPlacementID];\n }\n self.interstitialAd.delegate = self;\n self.interstitialAd.revenueDelegate = self;\n \n [self.interstitialAd loadAd];\n}\n\n#pragma mark - MCAdDelegate\n\/\/ Ad load success\n- (void)didLoadAd:(MCAdInfo *)ad {\n \/\/ Reset retry attempt\n self.retryAttempt = 0;\n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadAdWithError:(MCError *)error {\n\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 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.interstitialAd loadAd];\n });\n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *)ad {\n \/\/ pre-load\n [self.interstitialAd loadAd];\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad { \n \/\/ pre-load\n [self.interstitialAd loadAd];\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 \/\/ pre-load\n [self.interstitialAd loadAd];\n}\n\n- (void)didAdVideoStarted:(MCAdInfo *)ad { }\n\n- (void)didAdVideoCompleted:(MCAdInfo *)ad { }\n\n#pragma mark - MCAdRevenueDelegate\n\/\/ Revenue tracking\n- (void)didPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\n2. Showing an Interstitial Ad\nif ([self.interstitialAd isReady]) {\n [self.interstitialAd showAdWithViewController:self withExtra:@{kMCAPIPlacementScenarioIDKey:@\"your scene id\"}];\n} else {\n [self.interstitialAd loadAd];\n}\n\n\n3. Resource Release\n[self.interstitialAd destroyAd]; \n\n\n4. Customized Parameter Configuration\n- (void)loadAd {\n MCInterstitialAd *interstitialAd = [[MCInterstitialAd alloc] initWithPlacementId:self.placementID];\n interstitialAd.delegate = self;\n interstitialAd.revenueDelegate = self;\n \n [interstitialAd setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n \n [interstitialAd setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [interstitialAd loadAd];\n self.interstitialAd = interstitialAd;\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":"1741749129","update_time":"1753089441"},"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 an Interstitial Ad\n#import **\ud83d\udca1Tips** \n>\n> - To optimize loading efficiency, implement [Preset Strategy](https:\/\/help.hyperbid.com\/docs\/SDK-Preset-Strategy-LaYK) \n> - Configure **ad load timeout** (recommended 6s - 10s) based on business requirements \n> - Timeout duration applies only to ad loading phase, not including display time \n> - \u26a0\ufe0f Excessively short timeouts may degrade ad performance \n> - \u26a0\ufe0f When **Price Priority Mode** is enabled in [HyperBid Tools Dashboard > Application > Edit Mediation Unit > Advanced Settings](https:\/\/portal.hyperbid.com\/m\/application), its callback timeout overrides `fetchTimeout`\n> - \ud83c\udfaf Supports custom bottom logo view\n\n---\n\n## **1. Loading an App Open Ad** \n\n```objective-c\n@interface SplashVC () \n\n@property (nonatomic, strong) MCAppOpenAd *appOpenAd; \n\n@end\n\n@implementation SplashVC\n\n#define SplashPlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define SplashSceneID @\"\"\n\n\/\/fetchTimeout, unit: seconds\n#define Splash_Timeout 8\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.appOpenAd) {\n self.appOpenAd = [[MCAppOpenAd alloc] initWithPlacementId:SplashPlacementID containerView:containerView];\n }\n self.appOpenAd.delegate = self;\n self.appOpenAd.revenueDelegate = self;\n \n [self.appOpenAd setLoadAdTimeout:Splash_Timeout];\n [self.appOpenAd loadAd];\n}\n\n#pragma mark - MCAdDelegate\n\/\/ Ad load success\n- (void)didLoadAd:(MCAdInfo *)ad {\n \n}\n\n\/\/ Loading timeout\n- (void)didLoadAdTimeout {\n \n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadAdWithError:(MCError *)error {\n \n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad { \n \/\/ soft launch pre-load\n \/\/ [self.appOpenAd loadAd];\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 \/\/ soft launch pre-load\n \/\/ [self.appOpenAd loadAd];\n}\n\n- (void)didAdVideoStarted:(MCAdInfo *)ad { }\n\n- (void)didAdVideoCompleted:(MCAdInfo *)ad { }\n\n#pragma mark - MCAdRevenueDelegate\n\/\/ Revenue tracking\n- (void)didPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n```\n\n---\n\n## **2. Showing an App Open Ad** \n\n```objective-c\nif ([self.appOpenAd isReady]) {\n [self.appOpenAd showAdWithWindow:[UIApplication sharedApplication].keyWindow viewController:self withExtra:@{kMCAPIPlacementScenarioIDKey:@\"your scene id\"}];\n} else {\n [self.appOpenAd loadAd];\n}\n```\n\n---\n\n## **3. Resource Release** \n\n```objective-c\n[self.appOpenAd destroyAd]; \n```\n\n---\n\n## **4. Customized Parameter Configuration** \n\n```objective-c \n- (void)loadAd {\n MCAppOpenAd *appOpenAd = [[MCAppOpenAd alloc] initWithPlacementId:self.placementID];\n appOpenAd.delegate = self;\n appOpenAd.revenueDelegate = self;\n \n [appOpenAd setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n \n [appOpenAd setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [appOpenAd loadAd];\n self.appOpenAd = appOpenAd;\n}\n\n- (void)didLoadAd:(MCAdInfo *)ad {\n \/\/ Retrieve customized parameters\n NSString *originDataJsonString = ad.originData;\n} \n```","pure_content":"\ud83d\udca1Tips\n\nTo optimize loading efficiency, implement Preset Strategy\n\nConfigure ad load timeout (recommended 6s - 10s) based on business requirements\nTimeout duration applies only to ad loading phase, not including display time\n\u26a0\ufe0f Excessively short timeouts may degrade ad performance\n\u26a0\ufe0f When Price Priority Mode is enabled in HyperBid Tools Dashboard > Application > Edit Mediation Unit > Advanced Settings, its callback timeout overrides fetchTimeout\n\n\ud83c\udfaf Supports custom bottom logo view\n\n\n\n1. Loading an App Open Ad\n@interface SplashVC () \n\n@property (nonatomic, strong) MCAppOpenAd *appOpenAd; \n\n@end\n\n@implementation SplashVC\n\n#define SplashPlacementID @\"your mediation unit id\"\n\n\/\/Scene ID\n#define SplashSceneID @\"\"\n\n\/\/fetchTimeout, unit: seconds\n#define Splash_Timeout 8\n\n#pragma mark - Load Ad\n- (void)loadAd {\n if (!self.appOpenAd) {\n self.appOpenAd = [[MCAppOpenAd alloc] initWithPlacementId:SplashPlacementID containerView:containerView];\n }\n self.appOpenAd.delegate = self;\n self.appOpenAd.revenueDelegate = self;\n \n [self.appOpenAd setLoadAdTimeout:Splash_Timeout];\n [self.appOpenAd loadAd];\n}\n\n#pragma mark - MCAdDelegate\n\/\/ Ad load success\n- (void)didLoadAd:(MCAdInfo *)ad {\n \n}\n\n\/\/ Loading timeout\n- (void)didLoadAdTimeout {\n \n}\n\n\/\/ Ad load failure\n- (void)didFailToLoadAdWithError:(MCError *)error {\n \n}\n\n\/\/ Ad display success\n- (void)didDisplayAd:(MCAdInfo *)ad {\n\n}\n\n\/\/ Ad closed\n- (void)didHideAd:(MCAdInfo *)ad { \n \/\/ soft launch pre-load\n \/\/ [self.appOpenAd loadAd];\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 \/\/ soft launch pre-load\n \/\/ [self.appOpenAd loadAd];\n}\n\n- (void)didAdVideoStarted:(MCAdInfo *)ad { }\n\n- (void)didAdVideoCompleted:(MCAdInfo *)ad { }\n\n#pragma mark - MCAdRevenueDelegate\n\/\/ Revenue tracking\n- (void)didPayRevenueForAd:(MCAdInfo *)ad {\n\n}\n\n\n2. Showing an App Open Ad\nif ([self.appOpenAd isReady]) {\n [self.appOpenAd showAdWithWindow:[UIApplication sharedApplication].keyWindow viewController:self withExtra:@{kMCAPIPlacementScenarioIDKey:@\"your scene id\"}];\n} else {\n [self.appOpenAd loadAd];\n}\n\n\n3. Resource Release\n[self.appOpenAd destroyAd]; \n\n\n4. Customized Parameter Configuration\n- (void)loadAd {\n MCAppOpenAd *appOpenAd = [[MCAppOpenAd alloc] initWithPlacementId:self.placementID];\n appOpenAd.delegate = self;\n appOpenAd.revenueDelegate = self;\n \n [appOpenAd setLoadExtraParameter:@{\n @\"userData\": @\"test_userData\"\n }];\n \n [appOpenAd setExtraParameter:@{\n @\"test_extra_key\": @\"test_extra_value\"\n }];\n \n [appOpenAd loadAd];\n self.appOpenAd = appOpenAd;\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":"1741749129","update_time":"1750935041"},"pure_content":"\ud83d\udca1Tips\n\nTo optimize loading efficiency, implement Preset Strategy\n\nConfigure ad load timeout (recommended 6s - 10s) based on business requirements\nTimeout duration applies only to ad loading phase, no"},{"id":"365451","string_id":"s7CFBAn6","status":"1","parent_id":"365447","slug":"Native-Ad-K1PU","order":"0","name":"Native Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1741749129","update_time":"1759113813","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}