Rewarded Ads

💡Tips

Automatically manages parallel loading across multiple placements, caching, and eCPM-optimized display — developers only need load → isReady → show

load() must be called only after MCSDK.init() completes, otherwise loading silently fails

SDK auto-refills after ad close, no manual reload needed; isReady() returning false also triggers automatic background refill

1. Loading an Ad

java Copy

// 1. Set callbacks
MCRewardAdManager.getInstance().setListener(new MCRewardAdManagerListener() {
    @Override
    public void onAdLoaded(MCAdInfo adInfo) {
        // At least one ad is ready (triggered at most once per loading round)
    }

    @Override
    public void onAdLoadFailed(MCError error) {
        // All placements failed to load (mutually exclusive with onAdLoaded)
    }

    @Override
    public void onAdLoadFinished() {
        // All placements in this round have finished loading (fires regardless of success or failure)
    }

    @Override
    public void onAdDisplayed(MCAdInfo adInfo) {
        // Ad displayed successfully
    }

    @Override
    public void onAdHidden(MCAdInfo adInfo) {
        // Ad closed (SDK auto-refills, no manual load needed)
    }

    @Override
    public void onAdClicked(MCAdInfo adInfo) {
        // Ad clicked
    }

    @Override
    public void onAdDisplayFailed(MCAdInfo adInfo, MCError error) {
        // Display failed
    }

    @Override
    public void onAdRevenuePaid(MCAdInfo adInfo) {
        // Ad revenue callback (for revenue attribution)
    }

    // --- Rewarded-specific callbacks ---
    @Override
    public void onUserRewarded(MCAdInfo adInfo, MCReward reward) {
        // User completed reward — grant reward here
    }

    @Override
    public void onUserRewardFailed(MCAdInfo adInfo) {
        // Reward grant failed
    }

    @Override
    public void onRewardedVideoStarted(MCAdInfo adInfo) {
        // Video playback started
    }

    @Override
    public void onRewardedVideoCompleted(MCAdInfo adInfo) {
        // Video playback completed
    }
});

// 2. Load (SDK automatically manages multiple placements based on server configuration)
MCRewardAdManager.getInstance().load();

⚠️ Note

setListener() should be called before load(), otherwise the first loading callbacks may be missed

Duplicate load() calls during an ongoing loading cycle are automatically ignored — no manual deduplication needed

onUserRewarded is the only reliable timing for granting rewards — do not grant rewards in other callbacks

2. Showing an Ad

java Copy

if (MCRewardAdManager.getInstance().isReady()) {
    MCRewardAdManager.getInstance().show(activity);
}

💡 Note

show() automatically selects the highest eCPM ad from the cache pool — no manual comparison needed

After display, the cache for that placement is consumed and the SDK auto-refills

When isReady() returns false, the SDK automatically triggers background refill — you can periodically poll to check readiness

3. Resource Release

java Copy

MCRewardAdManager.getInstance().destroy();

⚠️ Note

Must call destroy() when Activity / Fragment is destroyed to release resources

After destruction, load() must be called again before further use

destroy() is safe to call repeatedly

4. Customized Parameter Configuration

java Copy

Map<String, Object> loadExtraParameter = new HashMap<>();
loadExtraParameter.put(MCAdConst.KEY.USER_ID, "test_userid_001");
loadExtraParameter.put(MCAdConst.KEY.USER_CUSTOM_DATA, "test_userdata_001");
MCRewardAdManager.getInstance().setLoadExtraParameter(loadExtraParameter);

Map<String, String> extraParameter = new HashMap<>();
extraParameter.put("key", "value");
MCRewardAdManager.getInstance().setExtraParameter(extraParameter);

// Custom parameters must be set before load()
MCRewardAdManager.getInstance().load();

💡 Note

Rewarded Ads support passing user identifiers and custom data via MCAdConst.KEY.USER_ID and MCAdConst.KEY.USER_CUSTOM_DATA for server-side reward verification.

Last modified: 2026-04-02Powered by

Outline