{"data":{"id":"365463","string_id":"kDxTrH4M","status":"1","parent_id":"387208","slug":"AD-Formats-Android","order":"7","name":"AD Formats","type":"1","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"","seo_keyword":"","seo_desc":"","author":"","add_time":"1741749135","update_time":"1759228294","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":"365464","string_id":"NxIeGYYg","status":"1","parent_id":"365463","slug":"Rewarded-Ads-Android","order":"0","name":"Rewarded Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"Rewarded Ads","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1741749135","update_time":"1759228318","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"365464","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```java \nMCRewardedAd mRewardVideoAd = new MCRewardedAd(activity, \"your mediation unit id\"); \nmRewardVideoAd.setListener(new MCRewardedAdListener() { \n @Override \n public void onUserRewarded(MCAdInfo mcAdInfo, MCReward mcReward) { \n \/\/ Reward triggered callback \n } \n\n @Override \n public void onUserRewardFailed(MCAdInfo mcAdInfo) { \n \/\/ Reward failure callback \n } \n\n @Override\n public void onRewardedVideoStarted(MCAdInfo mcAdInfo) { } \n\n @Override\n public void onRewardedVideoCompleted(MCAdInfo mcAdInfo) { } \n \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Ad load success callback \n \/\/ Reset retry attempt\n retryAttempt = 0\uff1b\n } \n\n @Override \n public void onAdDisplayed(MCAdInfo mcAdInfo) { \n \/\/ Ad display success callback \n \/\/ pre-load\n mRewardVideoAd.loadAd(); \n } \n\n @Override \n public void onAdHidden(MCAdInfo mcAdInfo) { \n \/\/ Ad closed callback \n \/\/ pre-load\n mRewardVideoAd.loadAd(); \n } \n\n @Override \n public void onAdClicked(MCAdInfo mcAdInfo) { \n \/\/ Ad click callback \n } \n\n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \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 (retryAttempt >= 3) return;\n retryAttempt++;\n\t\tlong delayMillis = TimeUnit.SECONDS.toMillis((long) Math.pow(2, Math.min(3, retryAttempt)));\n\t\tnew Handler().postDelayed(new Runnable() {\n \t\t@Override\n \t\tpublic void run() {\n \t\tmRewardVideoAd.loadAd();\n \t\t}\n\t\t}, delayMillis);\n } \n\n @Override \n public void onAdDisplayFailed(MCAdInfo mcAdInfo, MCError mcError) { \n \/\/ Ad display failure callback \n \/\/ pre-load\n mRewardVideoAd.loadAd(); \n } \n}); \n\nmRewardVideoAd.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n \nmRewardVideoAd.loadAd(); \n```\n\n---\n\n## **2. Showing a Rewarded Ad**\n\n```java \nif (mRewardVideoAd.isAdReady()) { \n mRewardVideoAd.showAd(activity, null); \n} else { \n mRewardVideoAd.load(); \n} \n```\n\n---\n\n## **3. Resource Release**\n\n```java \nif (mRewardVideoAd != null) { \n mRewardVideoAd.destroy(); \n} \n```\n\n---\n\n## **4. Customized Parameter Configuration**\n\n```java \nMCRewardedAd mRewardVideoAd = new MCRewardedAd(activity, \"your mediation unit id\"); \nString userid = \"test_userid_001\"; \nString userdata = \"test_userdata_001\"; \nMap localMap = new HashMap<>(); \nlocalMap.put(MCAdConst.KEY.USER_ID, userid);\nlocalMap.put(MCAdConst.KEY.USER_CUSTOM_DATA, userdata); \nmRewardVideoAd.setLoadExtraParameter(localMap); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nmRewardVideoAd.setExtraParameter(extraParameter); \n\nmRewardVideoAd.setListener(new MCRewardedAdListener() { \n ... \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Retrieve customized parameters \n mcAdInfo.getOriginJsonString(); \n } \n ... \n}); \n\nmRewardVideoAd.loadAd(); \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\nMCRewardedAd mRewardVideoAd = new MCRewardedAd(activity, \"your mediation unit id\"); \nmRewardVideoAd.setListener(new MCRewardedAdListener() { \n @Override \n public void onUserRewarded(MCAdInfo mcAdInfo, MCReward mcReward) { \n \/\/ Reward triggered callback \n } \n\n @Override \n public void onUserRewardFailed(MCAdInfo mcAdInfo) { \n \/\/ Reward failure callback \n } \n\n @Override\n public void onRewardedVideoStarted(MCAdInfo mcAdInfo) { } \n\n @Override\n public void onRewardedVideoCompleted(MCAdInfo mcAdInfo) { } \n \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Ad load success callback \n \/\/ Reset retry attempt\n retryAttempt = 0\uff1b\n } \n\n @Override \n public void onAdDisplayed(MCAdInfo mcAdInfo) { \n \/\/ Ad display success callback \n \/\/ pre-load\n mRewardVideoAd.loadAd(); \n } \n\n @Override \n public void onAdHidden(MCAdInfo mcAdInfo) { \n \/\/ Ad closed callback \n \/\/ pre-load\n mRewardVideoAd.loadAd(); \n } \n\n @Override \n public void onAdClicked(MCAdInfo mcAdInfo) { \n \/\/ Ad click callback \n } \n\n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \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 (retryAttempt >= 3) return;\n retryAttempt++;\n\t\tlong delayMillis = TimeUnit.SECONDS.toMillis((long) Math.pow(2, Math.min(3, retryAttempt)));\n\t\tnew Handler().postDelayed(new Runnable() {\n \t\t@Override\n \t\tpublic void run() {\n \t\tmRewardVideoAd.loadAd();\n \t\t}\n\t\t}, delayMillis);\n } \n\n @Override \n public void onAdDisplayFailed(MCAdInfo mcAdInfo, MCError mcError) { \n \/\/ Ad display failure callback \n \/\/ pre-load\n mRewardVideoAd.loadAd(); \n } \n}); \n\nmRewardVideoAd.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n \nmRewardVideoAd.loadAd(); \n\n\n2. Showing a Rewarded Ad\nif (mRewardVideoAd.isAdReady()) { \n mRewardVideoAd.showAd(activity, null); \n} else { \n mRewardVideoAd.load(); \n} \n\n\n3. Resource Release\nif (mRewardVideoAd != null) { \n mRewardVideoAd.destroy(); \n} \n\n\n4. Customized Parameter Configuration\nMCRewardedAd mRewardVideoAd = new MCRewardedAd(activity, \"your mediation unit id\"); \nString userid = \"test_userid_001\"; \nString userdata = \"test_userdata_001\"; \nMap localMap = new HashMap<>(); \nlocalMap.put(MCAdConst.KEY.USER_ID, userid);\nlocalMap.put(MCAdConst.KEY.USER_CUSTOM_DATA, userdata); \nmRewardVideoAd.setLoadExtraParameter(localMap); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nmRewardVideoAd.setExtraParameter(extraParameter); \n\nmRewardVideoAd.setListener(new MCRewardedAdListener() { \n ... \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Retrieve customized parameters \n mcAdInfo.getOriginJsonString(); \n } \n ... \n}); \n\nmRewardVideoAd.loadAd();","is_draft":"0","editor_type":"2","file_path":"","add_time":"1741749135","update_time":"1753089315"},"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\nMCRewardedAd mRewa"},{"id":"365465","string_id":"nu1FuoEf","status":"1","parent_id":"365463","slug":"Interstitial-Ads--Android","order":"0","name":"Interstitial Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"Interstitial Ads","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1741749135","update_time":"1759228765","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"365465","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```java \nMCInterstitialAd mInterstitialAd = new MCInterstitialAd(activity, \"your mediation unit id\"); \nmInterstitialAd.setListener(new MCAdListener() { \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Ad load success callback \n \/\/ Reset retry attempt\n retryAttempt = 0\uff1b\n } \n\n @Override \n public void onAdDisplayed(MCAdInfo mcAdInfo) { \n \/\/ Ad display success callback \n \/\/ pre-load\n mInterstitialAd.loadAd();\n } \n\n @Override \n public void onAdHidden(MCAdInfo mcAdInfo) { \n \/\/ Ad closed callback \n \/\/ pre-load\n mInterstitialAd.loadAd();\n } \n\n @Override \n public void onAdClicked(MCAdInfo mcAdInfo) { \n \/\/ Ad click callback \n } \n\n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \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 (retryAttempt >= 3) return;\n\t\tretryAttempt++;\n\t\tlong delayMillis = TimeUnit.SECONDS.toMillis((long) Math.pow(2, Math.min(3, retryAttempt)));\n\t\tnew Handler().postDelayed(new Runnable() {\n \t\t@Override\n \t\tpublic void run() {\n \t\tmInterstitialAd.loadAd();\n \t\t}\n\t\t}, delayMillis);\n } \n\n @Override \n public void onAdDisplayFailed(MCAdInfo mcAdInfo, MCError mcError) { \n \/\/ Ad display failure callback \n mInterstitialAd.loadAd();\n } \n}); \n\nmInterstitialAd.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n\nmInterstitialAd.loadAd(); \n```\n\n---\n\n## **2. Showing an Interstitial Ad** \n\n```java \nif (mInterstitialAd.isReady()) { \n mInterstitialAd.showAd(activity, null); \n} else {\n mInterstitialAd.loadAd();\n} \n```\n\n---\n\n## **3. Resource Release** \n\n```java \nif (mInterstitialAd != null) { \n mInterstitialAd.destroy(); \n} \n```\n\n---\n\n## **4. Customized Parameter Configuration**\n\n```java \nmInterstitialAd = new MCInterstitialAd(activity, \"your mediation unit id\"); \nmInterstitialAd.setListener(new MCAdListener() { \n ... \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Retrieve custom parameters \n mcAdInfo.getOriginJsonString(); \n } \n ... \n}); \n\nMap loadExtraParameter = new HashMap<>(); \nloadExtraParameter.put(\"test_load_extra_key\", \"test_load_extra_value\"); \nmInterstitialAd.setLoadExtraParameter(loadExtraParameter); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nmInterstitialAd.setExtraParameter(extraParameter); \n\nmInterstitialAd.loadAd(); \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\nMCInterstitialAd mInterstitialAd = new MCInterstitialAd(activity, \"your mediation unit id\"); \nmInterstitialAd.setListener(new MCAdListener() { \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Ad load success callback \n \/\/ Reset retry attempt\n retryAttempt = 0\uff1b\n } \n\n @Override \n public void onAdDisplayed(MCAdInfo mcAdInfo) { \n \/\/ Ad display success callback \n \/\/ pre-load\n mInterstitialAd.loadAd();\n } \n\n @Override \n public void onAdHidden(MCAdInfo mcAdInfo) { \n \/\/ Ad closed callback \n \/\/ pre-load\n mInterstitialAd.loadAd();\n } \n\n @Override \n public void onAdClicked(MCAdInfo mcAdInfo) { \n \/\/ Ad click callback \n } \n\n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \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 (retryAttempt >= 3) return;\n\t\tretryAttempt++;\n\t\tlong delayMillis = TimeUnit.SECONDS.toMillis((long) Math.pow(2, Math.min(3, retryAttempt)));\n\t\tnew Handler().postDelayed(new Runnable() {\n \t\t@Override\n \t\tpublic void run() {\n \t\tmInterstitialAd.loadAd();\n \t\t}\n\t\t}, delayMillis);\n } \n\n @Override \n public void onAdDisplayFailed(MCAdInfo mcAdInfo, MCError mcError) { \n \/\/ Ad display failure callback \n mInterstitialAd.loadAd();\n } \n}); \n\nmInterstitialAd.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n\nmInterstitialAd.loadAd(); \n\n\n2. Showing an Interstitial Ad\nif (mInterstitialAd.isReady()) { \n mInterstitialAd.showAd(activity, null); \n} else {\n mInterstitialAd.loadAd();\n} \n\n\n3. Resource Release\nif (mInterstitialAd != null) { \n mInterstitialAd.destroy(); \n} \n\n\n4. Customized Parameter Configuration\nmInterstitialAd = new MCInterstitialAd(activity, \"your mediation unit id\"); \nmInterstitialAd.setListener(new MCAdListener() { \n ... \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Retrieve custom parameters \n mcAdInfo.getOriginJsonString(); \n } \n ... \n}); \n\nMap loadExtraParameter = new HashMap<>(); \nloadExtraParameter.put(\"test_load_extra_key\", \"test_load_extra_value\"); \nmInterstitialAd.setLoadExtraParameter(loadExtraParameter); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nmInterstitialAd.setExtraParameter(extraParameter); \n\nmInterstitialAd.loadAd();","is_draft":"0","editor_type":"2","file_path":"","add_time":"1741749135","update_time":"1753089331"},"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\nMCInterstitia"},{"id":"365466","string_id":"hQDYlgTX","status":"1","parent_id":"365463","slug":"Splash-Ads--Android","order":"0","name":"App Open Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"App Open Ads","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1741749136","update_time":"1759228713","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"365466","content":"> **\ud83d\udca1Tips** \n> - To optimize loading efficiency, implement [Preset Strategy](https:\/\/help.hyperbid.com\/docs\/SDK-Preset-Strategy) \n> - Configure **ad load timeout** (recommended 6000ms - 10000ms) 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\n---\n\n## **1. Loading an App Open Ad** \n\n```java \n\/** \n * @param fetchTimeout Loading timeout in milliseconds \n *\/ \nMCAppOpenAd mSplashAd = new MCAppOpenAd(activity, \"your mediation unit id\", fetchTimeout); \nmSplashAd.setListener(new MCAppOpenAdListener() { \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Ad load success callback \n } \n \n @Override \n public void onAdLoadTimeout() { \n \/\/ Loading timeout callback \n } \n\n @Override \n public void onAdDisplayed(MCAdInfo mcAdInfo) { \n \/\/ Ad display success callback \n } \n\n @Override \n public void onAdHidden(MCAdInfo mcAdInfo) { \n \/\/ Ad closed callback (recommend removing view here) \n if (mSplashAdContainer != null) { \n mSplashAdContainer.removeAllViews(); \n } \n \/\/ soft launch pre-load\n \/\/ mSplashAd.loadAd();\n } \n\n @Override \n public void onAdClicked(MCAdInfo mcAdInfo) { \n \/\/ Ad click callback \n } \n\n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \n } \n\n @Override \n public void onAdDisplayFailed(MCAdInfo mcAdInfo, MCError mcError) { \n \/\/ Ad display failure callback \n \/\/ soft launch pre-load\n \/\/ mSplashAd.loadAd();\n } \n}); \n\nmSplashAd.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n\nmSplashAd.loadAd(); \n```\n\n---\n\n## **2. Showing an App Open Ad** \n\n```java \nif (mSplashAd.isReady()) { \n \/\/ mSplashAdContainer: Parent container for ad display \n mSplashAd.showAd(activity, mSplashAdContainer, null); \n} else {\n mSplashAd.loadAd();\n }\n```\n\n---\n\n## **3. Resource Release** \n\n```java \nif (mSplashAd != null) { \n mSplashAd.destroy(); \n} \n```\n\n---\n\n## **4. Customized Parameter Configuration** \n\n```java \nMCAppOpenAd mSplashAd = new MCAppOpenAd(activity, \"your mediation unit id\"); \nmSplashAd.setListener(new MCAdListener() { \n ... \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Retrieve custom parameters \n mcAdInfo.getOriginJsonString(); \n } \n ... \n}); \n\nMap loadExtraParameter = new HashMap<>(); \nloadExtraParameter.put(\"test_load_extra_key\", \"test_load_extra_value\"); \nmSplashAd.setLoadExtraParameter(loadExtraParameter); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nmSplashAd.setExtraParameter(extraParameter); \n\nmSplashAd.loadAd(); \n```","pure_content":"\ud83d\udca1Tips\n\nTo optimize loading efficiency, implement Preset Strategy\n\nConfigure ad load timeout (recommended 6000ms - 10000ms) 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\n\n\n1. Loading an App Open Ad\n\/** \n * @param fetchTimeout Loading timeout in milliseconds \n *\/ \nMCAppOpenAd mSplashAd = new MCAppOpenAd(activity, \"your mediation unit id\", fetchTimeout); \nmSplashAd.setListener(new MCAppOpenAdListener() { \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Ad load success callback \n } \n \n @Override \n public void onAdLoadTimeout() { \n \/\/ Loading timeout callback \n } \n\n @Override \n public void onAdDisplayed(MCAdInfo mcAdInfo) { \n \/\/ Ad display success callback \n } \n\n @Override \n public void onAdHidden(MCAdInfo mcAdInfo) { \n \/\/ Ad closed callback (recommend removing view here) \n if (mSplashAdContainer != null) { \n mSplashAdContainer.removeAllViews(); \n } \n \/\/ soft launch pre-load\n \/\/ mSplashAd.loadAd();\n } \n\n @Override \n public void onAdClicked(MCAdInfo mcAdInfo) { \n \/\/ Ad click callback \n } \n\n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \n } \n\n @Override \n public void onAdDisplayFailed(MCAdInfo mcAdInfo, MCError mcError) { \n \/\/ Ad display failure callback \n \/\/ soft launch pre-load\n \/\/ mSplashAd.loadAd();\n } \n}); \n\nmSplashAd.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n\nmSplashAd.loadAd(); \n\n\n2. Showing an App Open Ad\nif (mSplashAd.isReady()) { \n \/\/ mSplashAdContainer: Parent container for ad display \n mSplashAd.showAd(activity, mSplashAdContainer, null); \n} else {\n mSplashAd.loadAd();\n }\n\n\n3. Resource Release\nif (mSplashAd != null) { \n mSplashAd.destroy(); \n} \n\n\n4. Customized Parameter Configuration\nMCAppOpenAd mSplashAd = new MCAppOpenAd(activity, \"your mediation unit id\"); \nmSplashAd.setListener(new MCAdListener() { \n ... \n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Retrieve custom parameters \n mcAdInfo.getOriginJsonString(); \n } \n ... \n}); \n\nMap loadExtraParameter = new HashMap<>(); \nloadExtraParameter.put(\"test_load_extra_key\", \"test_load_extra_value\"); \nmSplashAd.setLoadExtraParameter(loadExtraParameter); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nmSplashAd.setExtraParameter(extraParameter); \n\nmSplashAd.loadAd();","is_draft":"0","editor_type":"2","file_path":"","add_time":"1741749136","update_time":"1750473878"},"pure_content":"\ud83d\udca1Tips\n\nTo optimize loading efficiency, implement Preset Strategy\n\nConfigure ad load timeout (recommended 6000ms - 10000ms) based on business requirements\nTimeout duration applies only to ad loading p"},{"id":"365467","string_id":"IRrpmBcK","status":"1","parent_id":"365463","slug":"Banner-Ads--Android","order":"0","name":"Banner Ads","type":"2","cover":"","cover_alt":"","desc":"","website":"","contact":"","seo_title":"Banner Ads","seo_keyword":"","seo_desc":"","share_switch":"0","share_code":"","author":"","add_time":"1741749136","update_time":"1759228732","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"365467","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> - \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 & Showing a Banner Ad** \n\n```java \nMCAdView mBannerView = new MCAdView(activity, \"your mediation unit id\"); \nmBannerView.setListener(new MCAdViewAdListener() { \n @Override \n public void onAdExpanded(MCAdInfo adInfo) { \n \/\/ Triggered when collapsible banner expands (if supported by ad network) \n } \n\n @Override \n public void onAdCollapsed(MCAdInfo adInfo) { \n \/\/ Triggered when collapsible banner collapses (if supported by ad network) \n } \n\n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Ad load success callback \n } \n\n @Override \n public void onAdDisplayed(MCAdInfo mcAdInfo) { \n \/\/ Ad display success callback \n } \n\n @Override \n public void onAdHidden(MCAdInfo mcAdInfo) { \n \/\/ Ad closed callback \n } \n\n @Override \n public void onAdClicked(MCAdInfo mcAdInfo) { \n \/\/ Ad click callback \n } \n\n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \n } \n\n @Override \n public void onAdDisplayFailed(MCAdInfo mcAdInfo, MCError mcError) { \n \/\/ Ad display failure callback \n } \n}); \n\nmBannerView.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n\n\/\/ Maintain container visibility for proper ad rendering \nmBannerView.setVisibility(View.VISIBLE); \n\n\/\/ Configure banner dimensions for example\uff1a320x50\nMap loadExtraParameter = new HashMap<>();\nloadExtraParameter.put(MCAdConst.KEY.AD_WIDTH, MCSDKUtil.dpToPx(context, 320));\nloadExtraParameter.put(MCAdConst.KEY.AD_HEIGHT, MCSDKUtil.dpToPx(context, 50));\nmBannerView.setLoadExtraParameter(loadExtraParameter); \n\n\/\/ Add to view hierarchy \nif (mBannerViewContainer != null && mBannerView != null) { \n mBannerViewContainer.addView(mBannerView, \n new FrameLayout.LayoutParams( \n FrameLayout.LayoutParams.MATCH_PARENT, \n mBannerViewContainer.getLayoutParams().height \n ) \n ); \n} \n\nmBannerView.loadAd(); \n```\n\n---\n\n## **2. Resource Release** \n\n```java \nif (mBannerViewContainer != null) { \n mBannerViewContainer.removeAllViews(); \n} \nif (mBannerView != null) { \n mBannerView.destroy(); \n} \n```\n\n---\n\n## **3. Customized Parameter Configuration** \n\n```java \nmBannerView = new MCAdView(activity, \"your mediation unit id\"); \nmBannerView.setListener(new MCAdViewAdListener() { \n ... \n @Override \n public void onAdLoaded(MCAdInfo adInfo) { \n \/\/ Retrieve custom parameters \n adInfo.getOriginJsonString(); \n } \n ... \n}); \n\nMap loadExtraParameter = new HashMap<>(); \nloadExtraParameter.put(\"test_load_extra_key\", \"test_load_extra_value\"); \nloadExtraParameter.put(\"adaptive_banner_width\", 400); \nmBannerView.setLoadExtraParameter(loadExtraParameter); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nextraParameter.put(\"adaptive_banner\", \"true\"); \nmBannerView.setExtraParameter(extraParameter); \n\nmBannerView.loadAd(); \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 & Showing a Banner Ad\nMCAdView mBannerView = new MCAdView(activity, \"your mediation unit id\"); \nmBannerView.setListener(new MCAdViewAdListener() { \n @Override \n public void onAdExpanded(MCAdInfo adInfo) { \n \/\/ Triggered when collapsible banner expands (if supported by ad network) \n } \n\n @Override \n public void onAdCollapsed(MCAdInfo adInfo) { \n \/\/ Triggered when collapsible banner collapses (if supported by ad network) \n } \n\n @Override \n public void onAdLoaded(MCAdInfo mcAdInfo) { \n \/\/ Ad load success callback \n } \n\n @Override \n public void onAdDisplayed(MCAdInfo mcAdInfo) { \n \/\/ Ad display success callback \n } \n\n @Override \n public void onAdHidden(MCAdInfo mcAdInfo) { \n \/\/ Ad closed callback \n } \n\n @Override \n public void onAdClicked(MCAdInfo mcAdInfo) { \n \/\/ Ad click callback \n } \n\n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \n } \n\n @Override \n public void onAdDisplayFailed(MCAdInfo mcAdInfo, MCError mcError) { \n \/\/ Ad display failure callback \n } \n}); \n\nmBannerView.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n\n\/\/ Maintain container visibility for proper ad rendering \nmBannerView.setVisibility(View.VISIBLE); \n\n\/\/ Configure banner dimensions for example\uff1a320x50\nMap loadExtraParameter = new HashMap<>();\nloadExtraParameter.put(MCAdConst.KEY.AD_WIDTH, MCSDKUtil.dpToPx(context, 320));\nloadExtraParameter.put(MCAdConst.KEY.AD_HEIGHT, MCSDKUtil.dpToPx(context, 50));\nmBannerView.setLoadExtraParameter(loadExtraParameter); \n\n\/\/ Add to view hierarchy \nif (mBannerViewContainer != null && mBannerView != null) { \n mBannerViewContainer.addView(mBannerView, \n new FrameLayout.LayoutParams( \n FrameLayout.LayoutParams.MATCH_PARENT, \n mBannerViewContainer.getLayoutParams().height \n ) \n ); \n} \n\nmBannerView.loadAd(); \n\n\n2. Resource Release\nif (mBannerViewContainer != null) { \n mBannerViewContainer.removeAllViews(); \n} \nif (mBannerView != null) { \n mBannerView.destroy(); \n} \n\n\n3. Customized Parameter Configuration\nmBannerView = new MCAdView(activity, \"your mediation unit id\"); \nmBannerView.setListener(new MCAdViewAdListener() { \n ... \n @Override \n public void onAdLoaded(MCAdInfo adInfo) { \n \/\/ Retrieve custom parameters \n adInfo.getOriginJsonString(); \n } \n ... \n}); \n\nMap loadExtraParameter = new HashMap<>(); \nloadExtraParameter.put(\"test_load_extra_key\", \"test_load_extra_value\"); \nloadExtraParameter.put(\"adaptive_banner_width\", 400); \nmBannerView.setLoadExtraParameter(loadExtraParameter); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nextraParameter.put(\"adaptive_banner\", \"true\"); \nmBannerView.setExtraParameter(extraParameter); \n\nmBannerView.loadAd();","is_draft":"0","editor_type":"2","file_path":"","add_time":"1741749136","update_time":"1750474053"},"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"},{"id":"365468","string_id":"Eqknm8F6","status":"1","parent_id":"365463","slug":"Native-Ads-Android","order":"0","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":"","add_time":"1741749136","update_time":"1759228747","corp_auth_id":"0","verify_code_auth_id":"0","editor_type":"2","file_type":"","auth_id":"[\"-1\"]","content":{"content_id":"365468","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```java \n\/\/ Recommended global variables \nprivate MCAdInfo mMCAdInfo; \nprivate MCNativeAdView mMCNativeAdView; \nprivate MCNativeAd mMCNativeAd; \n\nMCNativeAdLoader mNativeAdLoader = new MCNativeAdLoader(activity, \"your mediation unit id\"); \nmNativeAdLoader.setNativeAdListener(new MCNativeAdListener() { \n @Override \n public void onAdLoaded(MCNativeAdView nativeAdView, MCAdInfo adInfo) { \n \/\/ Ad load success callback \n if (mMCNativeAd != null) { \n mNativeAdLoader.destroy(mMCNativeAd); \n } \n mMCAdInfo = adInfo; \n mMCNativeAd = adInfo.getNativeAd(); \n mMCNativeAdView = nativeAdView; \n \/\/ Reset retry attempt\n retryAttempt = 0\uff1b\n } \n \n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \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 (retryAttempt >= 3) return;\n retryAttempt++;\n long delayMillis = TimeUnit.SECONDS.toMillis((long) Math.pow(2, Math.min(3, retryAttempt)));\n new Handler().postDelayed(new Runnable() {\n @Override\n public void run() {\n mNativeAdLoader.loadAd();\n }\n }, delayMillis);\n } \n\n @Override \n public void onAdDisplayed(MCAdInfo adInfo) { \n \/\/ Ad display success callback \n } \n\n @Override \n public void onAdHidden(MCAdInfo adInfo) { \n \/\/ Ad closed callback \n } \n\n @Override \n public void onAdClicked(MCAdInfo adInfo) { \n \/\/ Ad click callback \n } \n}); \n\nmNativeAdLoader.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n\nmNativeAdLoader.loadAd();\n```\n\n---\n\n## **2. Showing a Native Ad** \n\n```java \n\/\/ Parent container for NativeAdView \nFrameLayout mNativeAdViewContainer = findViewById(R.id.adview_container); \nmNativeAdViewContainer.removeAllViews(); \n\nif (mMCNativeAd != null) { \n if (mMCNativeAd.isTemplateNativeAd()) { \n \/\/ Template rendering \n mNativeAdViewContainer.addView(mMCNativeAdView); \n } else { \n \/\/ Self-rendering \n mMCNativeAdView = createNativeAdView(); \n mNativeAdViewContainer.addView(mMCNativeAdView); \n mNativeAdLoader.render(mMCNativeAdView, mMCAdInfo); \n } \n} else { \n \/\/ No cached ads available, reload recommended \n mNativeAdLoader.loadAd(); \n} \n\nprivate MCNativeAdView createNativeAdView() { \n \/\/ Custom XML components must match the following identifiers \n MCNativeAdViewBinder binder = new MCNativeAdViewBinder.Builder(R.layout.native_custom_ad_view) \n .setTitleTextViewId(R.id.title_text_view) \/\/TextView \n .setBodyTextViewId(R.id.body_text_view) \/\/TextView \n .setStarRatingContentViewGroupId(R.id.star_rating_view) \/\/ViewGroup \n .setAdvertiserTextViewId(R.id.advertiser_text_view) \/\/TextView \n .setIconImageViewId(R.id.icon_image_view) \/\/ImageView \n .setMediaContentViewGroupId(R.id.media_view_container) \/\/ViewGroup \n .setOptionsContentViewGroupId(R.id.options_view) \/\/ViewGroup \n .setCallToActionButtonId(R.id.cta_button) \/\/Button \n \/\/ .setWarningViewId(R.id.body_warn_view) (Only Yandex need) \/\/TextView\n \/\/ .setSponserViewId(R.id.body_spon_view) (Only Yandex need) \/\/TextView\n .build(); \n return new MCNativeAdView(binder, activity); \n} \n```\n\n

\ud83d\udccc native_custom_ad_view.xml<\/summary>\n\n```xml\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n<\/androidx.constraintlayout.widget.ConstraintLayout>\n```\n<\/details>\n\n---\n\n## **3. Resource Release** \n\n```java \nif (mNativeAdLoader != null) { \n mNativeAdLoader.destroy(); \n if (mMCNativeAd != null) { \n mNativeAdLoader.destroy(mMCNativeAd); \n } \n} \n```\n\n---\n\n## **4. Customized Parameter Configuration** \n\n```java \nMCNativeAdLoader mNativeAdLoader = new MCNativeAdLoader(activity, \"your mediation unit id\"); \nMap loadExtraParameter = new HashMap<>(); \nloadExtraParameter.put(\"test_load_extra_key\", \"test_load_extra_value\"); \nmNativeAdLoader.setLoadExtraParameter(loadExtraParameter); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nmNativeAdLoader.setExtraParameter(extraParameter); \n\nmNativeAdLoader.setNativeAdListener(new MCNativeAdListener() { \n ... \n @Override \n public void onAdLoaded(MCNativeAdView mcNativeAdView, MCAdInfo adInfo) { \n \/\/ Retrieve custom parameters \n adInfo.getOriginJsonString(); \n } \n ... \n}); \n\nmNativeAdLoader.loadAd(); \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\/\/ Recommended global variables \nprivate MCAdInfo mMCAdInfo; \nprivate MCNativeAdView mMCNativeAdView; \nprivate MCNativeAd mMCNativeAd; \n\nMCNativeAdLoader mNativeAdLoader = new MCNativeAdLoader(activity, \"your mediation unit id\"); \nmNativeAdLoader.setNativeAdListener(new MCNativeAdListener() { \n @Override \n public void onAdLoaded(MCNativeAdView nativeAdView, MCAdInfo adInfo) { \n \/\/ Ad load success callback \n if (mMCNativeAd != null) { \n mNativeAdLoader.destroy(mMCNativeAd); \n } \n mMCAdInfo = adInfo; \n mMCNativeAd = adInfo.getNativeAd(); \n mMCNativeAdView = nativeAdView; \n \/\/ Reset retry attempt\n retryAttempt = 0\uff1b\n } \n \n @Override \n public void onAdLoadFailed(MCError mcError) { \n \/\/ Ad load failure callback \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 (retryAttempt >= 3) return;\n retryAttempt++;\n long delayMillis = TimeUnit.SECONDS.toMillis((long) Math.pow(2, Math.min(3, retryAttempt)));\n new Handler().postDelayed(new Runnable() {\n @Override\n public void run() {\n mNativeAdLoader.loadAd();\n }\n }, delayMillis);\n } \n\n @Override \n public void onAdDisplayed(MCAdInfo adInfo) { \n \/\/ Ad display success callback \n } \n\n @Override \n public void onAdHidden(MCAdInfo adInfo) { \n \/\/ Ad closed callback \n } \n\n @Override \n public void onAdClicked(MCAdInfo adInfo) { \n \/\/ Ad click callback \n } \n}); \n\nmNativeAdLoader.setRevenueListener(new MCAdRevenueListener() { \n @Override \n public void onAdRevenuePaid(MCAdInfo adInfo) { \n \/\/ Revenue tracking callback \n } \n}); \n\nmNativeAdLoader.loadAd();\n\n\n2. Showing a Native Ad\n\/\/ Parent container for NativeAdView \nFrameLayout mNativeAdViewContainer = findViewById(R.id.adview_container); \nmNativeAdViewContainer.removeAllViews(); \n\nif (mMCNativeAd != null) { \n if (mMCNativeAd.isTemplateNativeAd()) { \n \/\/ Template rendering \n mNativeAdViewContainer.addView(mMCNativeAdView); \n } else { \n \/\/ Self-rendering \n mMCNativeAdView = createNativeAdView(); \n mNativeAdViewContainer.addView(mMCNativeAdView); \n mNativeAdLoader.render(mMCNativeAdView, mMCAdInfo); \n } \n} else { \n \/\/ No cached ads available, reload recommended \n mNativeAdLoader.loadAd(); \n} \n\nprivate MCNativeAdView createNativeAdView() { \n \/\/ Custom XML components must match the following identifiers \n MCNativeAdViewBinder binder = new MCNativeAdViewBinder.Builder(R.layout.native_custom_ad_view) \n .setTitleTextViewId(R.id.title_text_view) \/\/TextView \n .setBodyTextViewId(R.id.body_text_view) \/\/TextView \n .setStarRatingContentViewGroupId(R.id.star_rating_view) \/\/ViewGroup \n .setAdvertiserTextViewId(R.id.advertiser_text_view) \/\/TextView \n .setIconImageViewId(R.id.icon_image_view) \/\/ImageView \n .setMediaContentViewGroupId(R.id.media_view_container) \/\/ViewGroup \n .setOptionsContentViewGroupId(R.id.options_view) \/\/ViewGroup \n .setCallToActionButtonId(R.id.cta_button) \/\/Button \n \/\/ .setWarningViewId(R.id.body_warn_view) (Only Yandex need) \/\/TextView\n \/\/ .setSponserViewId(R.id.body_spon_view) (Only Yandex need) \/\/TextView\n .build(); \n return new MCNativeAdView(binder, activity); \n} \n\n\n\ud83d\udccc native_custom_ad_view.xml\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n<\/androidx.constraintlayout.widget.ConstraintLayout>\n\n\n\n3. Resource Release\nif (mNativeAdLoader != null) { \n mNativeAdLoader.destroy(); \n if (mMCNativeAd != null) { \n mNativeAdLoader.destroy(mMCNativeAd); \n } \n} \n\n\n4. Customized Parameter Configuration\nMCNativeAdLoader mNativeAdLoader = new MCNativeAdLoader(activity, \"your mediation unit id\"); \nMap loadExtraParameter = new HashMap<>(); \nloadExtraParameter.put(\"test_load_extra_key\", \"test_load_extra_value\"); \nmNativeAdLoader.setLoadExtraParameter(loadExtraParameter); \n\nMap extraParameter = new HashMap<>(); \nextraParameter.put(\"test_extra_key\", \"test_extra_value\"); \nmNativeAdLoader.setExtraParameter(extraParameter); \n\nmNativeAdLoader.setNativeAdListener(new MCNativeAdListener() { \n ... \n @Override \n public void onAdLoaded(MCNativeAdView mcNativeAdView, MCAdInfo adInfo) { \n \/\/ Retrieve custom parameters \n adInfo.getOriginJsonString(); \n } \n ... \n}); \n\nmNativeAdLoader.loadAd();","is_draft":"0","editor_type":"2","file_path":"","add_time":"1741749136","update_time":"1752212379"},"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\/\/ Recommended globa"}],"content":{"icon":"","desc":"","content_id":"365463","add_time":"1741749135","update_time":"1759228294","content":"","is_traffic_less":"0","file_type":""},"hot_list":[],"user_read_num":"0","is_auth":"0"},"msg":"Success","code":200}