Moloco SDK Android
Moloco SDK allows you to load and render any ad (VAST, MRAID, Static HTML)
Release Notes
4.14.1 (November 2026)
Performance optimisations
4.14.0 (October 2026)
Improved ad load handling to give better error messaging on certain failures.
Performance optimisations and bug fixes.
4.13.0 (September 2026)
Improved diagnostics for ad load failures
Bug fixes and performance improvements
4.12.0 (August 2026)
Improved SDK crash and ANR diagnostics
4.11.1 (August 2026)
Bug fixes and performance improvements
4.11.0 (July 2026)
Improved Adaptive banner functionality
Reduces the memory and GPU cost of Adaptive banner video
Fixed black screen issues on last frame of video
4.10.1 (July 2026)
Fixed illegal state exception in the main process on the first Moloco.getBidToken call with java.lang.ExceptionInInitializerError caused by MissingMainDispatcherException.
4.10.0 (June 2026)
New Feature
Added Adaptive Banner support
4.9.0 (May 2026)
Bug fixes and performance improvements
4.8.1 (May 2026)
Downgraded coil-compose from 2.7.0 to 2.2.0 to resolve a Compose activity compatibility issue.
4.8.0 (April 2026)
Improved error handling for starting fullscreen ad activities with webview addressing a known Android 16 Beta issue.
4.7.0 (March 2026)
New Feature
Added video support for MREC ads
4.6.0 (Feb 2026)
Reduced battery consumption in some apps using full-screen intent permissions.
4.5.0 (Jan 2026)
Improved diagnostics for ad load failures
4.4.0 (Dec 2025)
Improvement to how rewards are granted to users.
ANR fix that was affecting multiple apps.
Fixed webview not available crash affecting certain OEM devices.
4.3.1 (Nov 2025)
Fixed a bug in Ad rendering.
4.3.0 (Nov 2025)
Fixed a critical bug in Ad rendering and Unity compatibility issue.
4.2.0 (Oct 2025)
Improved ad experience and Bug Fixes
4.1.1 (Oct 2025)
Fixed a critical bug in Ad rendering
4.1.0 (Sept 2025)
Ad rendering improvements and bug fixes
4.0.0 (August 2025)
This SDK version update has a breaking change
New SDK public API to take in mediation info as parameter for all APIs. Adapters will need to be updated to pass in the same parameter that's part of the init API
SDK is now tested with Kotlin 2.0 and newer version of AGP.
Bug fixes and minor improvements.
3.12.1 (August 2025)
Updated usage of Privacy API and Context to align with compliance standards and optimize performance.
Resolved layout parameter issues in Banner and LiveFeeds components to ensure consistent and reliable UI behavior.
3.12.0 (July 2025)
Improved ad experience, enhanced playback behavior, and fixed stability issues.
3.11.0 (June 2025)
Enhanced ad experience with better UI responsiveness, improved stability, and resilient SDK behavior.
3.10.0 (May 2025)
Fine-tuned audio/mute handling for better user experience during Native ad sessions.
3.9.0 (April 2025)
Fix MRAID audio controls
3.8.0 (March 2025)
Breaking change to the error code for ad creation. Now returns UNABLE_TO_CREATE_AD instead of INVALID_AD_UNIT_ID
Improvements to Video Player, where the video may have gotten stretched
NativeAds no longer crash when used inside a Dialog
3.7.2 (March 2025)
Critical bug fix for Android 5.x
3.7.1 (February 2025)
Performance improvements
3.7.0 (February 2025)
Migrated banner implementation from Jetpack Compose to standard Android Views, enhancing compatibility with traditional Activity-based screens. This change ensures better integration when the parent activity is a standard Activity rather than a ComponentActivity.
Performance improvements for fullscreen ads
Verified tablet support
Fixed ClassCastException in MolocoPrivacy
Fixed MRAID rewarded video crash
3.6.1 (January 2025)
Critical bug fix
3.6.0 (January 2025)
Native Ads and other UI improvements
Bug fixes, including crash resolutions
SDK size reduction
How to use
Make sure to initialize SDK first. To do so, you need to provide a com.moloco.sdk.publisher.MolocoInitParams which includes:
Context - Android Context
appKey - Identifier of the publisher app registered with Moloco
MediationInfo - To perform the appropriate initialization for the mediation partner
After a successful initialization, now you can create an ad instance of your choice:
Guidelines and samples for created ad instances in the previous step:
Retrieving Bid Token from the SDK:
The API can be called before SDK initialization but needs to be called before each bid request
call Moloco.getBidToken() before each bid request.
The API is safe to be called from any thread and preferably should be called from the non-UI thread
The bid token and error (optional) will be returned in the callback of MolocoBidTokenListener
The bid token can be used to make a bid request to the Moloco server. A few considerations when passing bid token:
bidToken is never null
bidToken might be an empty string when Moloco in non-bid-token mode; or when error returned in the callback is not null
error, when present, means: bidToken is an invalid one. Use error data for tracking/logging purposes
Important: bidToken should still be passed to the bid request regardless of error presence.
Setting the Privacy information in the SDK
Official adapters will need to update Moloco SDK with privacy information.
In order to use Privacy API, Moloco SDK must be initialized
Call MolocoPrivacy.setPrivacy() to set the privacy information. The API can be called from any thread
MolocoPrivacy.setPrivacy(
MolocoPrivacy.PrivacySettings(
isUserConsent = true,
isAgeRestrictedUser = false,
isDoNotSell = false
)
)