Integration Checklist

This comprehensive checklist is designed to help you systematically verify the integration of your application, ensuring a seamless and efficient ad SDK experience.

---

1. API Usage Verification

• When initializing your application, ensure the correct App Key and App ID are used, and verify that the aggregation unit IDs for each ad format match the dashboard configuration.
• After the SDK is initialized, all placements for each ad format should load and show as expected.

---

2. Ad Format Specific Checks

Rewarded Ads

• Properly initialize the MCRewardedAd instance and set the mediation unit id.
• Set all required ad-listener (MCRewardedAdDelegate).
• Properly call the ad loading function (loadAd).
• Check if the ad is ready before showing (isReady).
• Properly call the ad show function (showAdWithViewController:withExtra:).
• It is recommended to invoke the loadAd funtion within all the following delegates: didFailToLoadAdWithError, didFailToDisplayAd, didHideAd, didDisplayAd.
• ❗Warning: Direct ad reload retries are prohibited in didFailToLoadAdWithError; delayed operations must be implemented. Refer to the sample code for details.
• [Optional] Set ad revenue listener (revenueDelegate).
• Properly call the ad release function (destroyAd).

Interstitial Ads

• Properly initialize the MCInterstitialAd instance and set the mediation unit id.
• Set all required ad-listener (MCAdDelegate).
• Properly call the ad loading function (loadAd).
• Check if the ad is ready before showing (isReady).
• Properly call the ad show function (showAdWithViewController:withExtra:).
• It is recommended to invoke the loadAd funtion within all the following delegates: didFailToLoadAdWithError, didFailToDisplayAd, didHideAd, didDisplayAd.
• ❗Warning: Direct ad reload retries are prohibited in didFailToLoadAdWithError; delayed operations must be implemented. Refer to the sample code for details.
• [Optional] Set ad revenue listener (revenueDelegate).
• Properly call the ad release function (destroyAd).

App Open Ads

• Properly initialize the MCAppOpenAd instance and set the mediation unit id and containerView.
• Set all required ad-listener (MCAdDelegate).
• Properly call the ad loading function (loadAd).
• Check if the ad is ready before showing (isReady).
• Properly call the ad show function (showAdWithWindow:viewController:withExtra:).
• It is recommended to invoke the loadAd funtion within all the following delegates: didFailToDisplayAd, didHideAd.
• ❗Warning: Direct ad reload retries are prohibited in didFailToLoadAdWithError; delayed operations must be implemented. Refer to the sample code for details.
• [Optional] Set ad revenue listener (revenueDelegate).
• Properly call the ad release function (destroyAd).

Banner Ads

• Properly initialize and configure the MCBannerAdView instance and set the mediation unit id and adFormat.
• Set all required ad-listener (MCBannerAdViewAdDelegate).
• Set the correct banner size (bannerSize).
• Properly call the ad loading function (loadAd).
• Maintain container visibility for proper ad rendering.
• [Optional] Set ad revenue listener (revenueDelegate).
• Properly call the ad release function (destroyAd).
• Auto-refresh feature configuration: HyperBid Tools Dashboard > Application > Edit Mediation Unit > Advanced Settings

Native Ads

• Properly initialize the MCNativeAdLoader instance and set the mediation unit id.
• Set all required ad-listener (MCNativeAdDelegate).
• Properly call the ad loading function (loadAd).
• For self-rendering, set MCNativeAdView correctly via MCNativePrepareInfo.
• For template rendering, handle the show logic properly (rendererWithNativeAdView:selfRenderView:adInfo:).
• It is recommended to invoke the loadAd funtion within all the following delegates: didFailToLoadNativeAdWithError, didHideAd.
• ❗Warning: Direct ad reload retries are prohibited in didFailToLoadNativeAdWithError; delayed operations must be implemented. Refer to the sample code for details.
• [Optional] Set ad revenue listener (revenueDelegate).
• Properly call the ad release function (destroyAd).

---

3. General Checks

• Using mediation debuggers to check ad integration (showMediationDebugger:viewController:).
• Enable MCSDK log debug mode ([[MCAPI sharedInstance] setLogEnabled:YES]).

---

4. Compliance Verification

• The app-ads.txt file has been correctly uploaded.

---

5. Revenue Tracking

• For more details, please refer to Sample Code.

---