Changelog

Android SDK release history

[4.1.2] - 2026-05-28

Added

• Native-in-Banner Rendering - Native ad demand from supported adapters, including Meta, Moloco, and Vungle, can now serve into standard banner and MREC slots through the existing banner public API.

Changed

• Server-Driven Always-Reward Mode - Rewarded ad adapters now honor a shouldAlwaysRewardUser flag configured per-line-item in the dashboard, so the SDK fires the reward callback even for ad networks that don’t always deliver a reward signal of their own. No publisher integration change required to benefit.

[4.1.1] - 2026-05-26

Added

• Digital Turbine Adapter Support - Added SDK support for the Digital Turbine Android adapter. Adapter artifacts continue to be released independently.
• Expanded Network Mappings - Added SDK network mappings for BidMachine, Chartboost, Digital Turbine, LoopMe, MobileFuse, Pangle, PubMatic, and Yandex so compatible adapters can be released independently as they become available.

Changed

• Digital Turbine Adapter Metadata - Updated Digital Turbine adapter metadata and error reporting compatibility for CloudX SDK 4.1.1.
• Google Waterfall Adapter - Updated Google Waterfall support to Google Mobile Ads SDK 25.1.0 and added fallback banner/MREC impression reporting when AdMob impression-level revenue callbacks are unavailable.

[4.1.0] - 2026-05-22

Added

• Trusted Arbiter - Added support for comparing CloudX bids with supported third-party bids from Unity LevelPlay and PubMatic, and selecting the winning platform through CloudX arbitration.
• Ad Value Accessors - Added CloudXAd.adValues for SDK-provided ad metadata.
• Expanded Network Support - Added SDK support for Google Waterfall, Moloco, and Verve adapters. Adapter artifacts continue to be released independently.
• MRAID 3.0 Ad View Rendering - Added CloudX renderer support for MRAID 3.0 banner and MREC creatives.

[4.0.0] - 2026-04-27

Breaking Changes

• Adapter Version Compatibility - Adapters now declare their minimum CloudX SDK version. The SDK skips incompatible adapters during initialization.

Added

• Independent Adapter Versions - CloudX adapters are now released independently from the core SDK, allowing compatible adapter updates to ship on their own release schedule.

Changed

• Publisher Release Builds - Improved release-build compatibility by preserving the CloudX runtime classes required for SDK initialization and adapter loading.

Fixed

• Release Build Initialization - Fixed an issue that could prevent SDK initialization in minified publisher builds.

[3.2.0] - 2026-04-24

Added

• Magnite Adapter - Added Magnite adapter support for banner, interstitial, and rewarded ads.
• Per-Request Bid Floor Overrides - Added APIs for per-request bid floor overrides so publishers can send request-scoped floor controls through the SDK bid pipeline.

Changed

• Improved banner and MREC lifecycle handling across adapters for more consistent rendering, refresh, and cleanup behavior.

Fixed

• Improved SDK resilience when optional adapter or network SDK dependencies are missing at runtime.
• Fixed Vungle banner load errors so invalid banner load states are surfaced through SDK error callbacks.

[3.1.0] - 2026-04-17

Added

• Native Ads - Added native ad support with CloudX.createNativeAdLoader(), CloudXNativeAdLoader, CloudXNativeAd, CloudXNativeAdListener, and CloudXNativeLoaderConfiguration, backed by the Meta adapter.

Changed

• Improved adapter initialization, privacy forwarding, and ad load/show reliability across supported networks.
• Reduced startup and initialization work on the main thread to improve app launch stability and lower ANR risk.
• Unity 2022 Meta Compatibility - adapter-meta now brings in Meta Audience Network 6.20.0 transitively by default for Unity 2022 compatibility. If your integration uses native ads, explicitly add Meta Audience Network 6.21.0 or newer in your app:
  dependencies {
      implementation("io.cloudx:adapter-meta:3.1.0")
      implementation("com.facebook.android:audience-network-sdk:6.21.0")
  }
  

Fixed

• Improved SDK resilience for missing network SDK dependencies and adapter load failures.

[3.0.0] - 2026-04-06

Breaking Changes

• CloudX.initialize() now requires an Android Context, and the public ad creation APIs now require Context as well: createBanner(), createMREC(), createInterstitial(), and createRewarded().

Changed

• Removed automatic process-start initialization; apps now provide Context explicitly through SDK initialization and ad creation APIs.
• Reduced SDK work before CloudX.initialize() is called, lowering main-thread startup overhead and ANR risk.

[2.2.7] - 2026-04-02

Fixed

• Reduced startup ANR risk for apps that include the SDK before calling CloudX.initialize().

[2.2.6] - 2026-04-01

Changed

• Improved ad lifecycle, revenue, and crash reporting reliability across SDK and network-adapter events.
• Improved banner, interstitial, and rewarded event attribution so placement and custom data are tracked consistently.

Fixed

• Improved error reporting for bid response parsing, adapter initialization, and ad load failure paths.

[2.2.5] - 2026-03-30

Added

• Added CloudXErrorCode.LOAD_NOT_ALLOWED_WHILE_SHOWING for fullscreen load() calls made while the same ad instance is actively showing.
• Added fullscreen adapter readiness checks across interstitial and rewarded adapters.

Changed

• Improved fullscreen ad readiness handling so expired or invalidated network ads are no longer reported as ready.
• Improved fullscreen ad reuse behavior to avoid serving stale cached ads.

Fixed

• Fixed fullscreen load() being accepted during an active show; it now fails immediately with onAdLoadFailed(..., LOAD_NOT_ALLOWED_WHILE_SHOWING).
• Fixed stale fullscreen ads being reported as ready after the network SDK had already invalidated or expired the underlying ad object.
• Fixed Mintegral GDPR consent propagation for CMP-managed integrations.

[2.2.4] - 2026-03-26

Added

• Server-Driven Location Sharing - Added server-controlled location sharing with publisher opt-out support and reduced coordinate precision.
• Added server-controlled remote log collection to help diagnose publisher integration issues.
• Added content-language targeting support in bid requests.
• Added more granular no-fill reasons in SDK error messages.

Changed

• Improved SDK diagnostic and crash reporting reliability for ad lifecycle events.

Fixed

• Fixed release-build rules so CloudX adapters are preserved correctly in minified apps.
• Fixed Mintegral adapter crash on Android API 23.

[2.2.3] - 2026-03-20

Added

• Added server-controlled diagnostic log collection for integration support.

Changed

• Renamed the Unity adapter artifact to adapter-unityads and aligned Unity Ads naming across SDK setup and documentation.

Fixed

• Fixed Unity Ads network name casing to match server bidder configuration.

[2.2.2] - 2026-03-17

Added

• Improved SDK initialization diagnostics by reporting adapter metadata.

Fixed

• Fixed InMobi bid token retrieval by ensuring token collection runs on the main thread.

[2.2.1] - 2026-03-11

Changed

• Hardened the Mintegral adapter against null values and ad load exceptions across supported ad formats.
• Bumped Mintegral SDK from 17.0.61 to 17.0.91.

Fixed

• Fixed adapter bid extras collection so an exception from one adapter no longer prevents extras from subsequent adapters being included.

[2.2.0] - 2026-03-10

Added

• Impression-Level Revenue Data - Added impression-level revenue tracking with CloudX auction correlation via AppLovin integration.
• Ad Click Tracking - Added click notification support when users tap ads.
• Manual Privacy API - Added CloudX.setHasUserConsent() and CloudX.setDoNotSell() with adapter privacy forwarding.
• Kotlin Suspend Initialization - Added a suspend CloudX.initialize(context, config) overload for Kotlin callers.
• Device-Level Reporting - Added Android ID based device-level reporting for DAU/MAU analytics when available.
• Adapter Error Diagnostics - Added adapter error reporting across banner, interstitial, and rewarded ads.
• Network SDK Crash Reporting - Added crash reporting for crashes originating from supported ad network SDKs.
• Creative Type Support - Added creative type support in the CloudX renderer.

Changed

• Moved the CloudX renderer into the core SDK, so publishers no longer need a separate CloudX renderer adapter module.
• Removed appcompat and webkit transitive dependencies from the SDK to reduce dependency surface area and APK size.
• Improved reporting delivery reliability by retaining events for retry on transient send failures.
• Bumped Vungle SDK from 7.6.1 to 7.7.1.
• Bumped InMobi SDK from 11.1.0 to 11.1.1, including an upstream BroadcastReceiver leak fix.

Fixed

• Fixed location data handling for geo-based targeting and reporting.
• Fixed incorrect INVALID_APP_KEY errors for non-config HTTP responses.
• Improved retry classification for transient network and server errors.

[2.0.1] - 2026-03-04

Changed

• Improved Unity 2022.3 compatibility by removing database runtime dependencies from SDK event persistence.
• Downgraded Meta Audience Network SDK from 6.21.0 to 6.20.0 to avoid Unity 2022.3 build incompatibilities.

Fixed

• Fixed a concurrency issue that could occur during impression tracking.
• Fixed Meta rewarded ad handling for apps using singleTask launch mode.

[2.0.0] - 2026-02-04

This release replaces placement names with Ad Unit IDs from the CloudX dashboard. Update your createBanner(), createMREC(), createInterstitial(), and createRewarded() calls to use the ad unit ID instead of a placement name.

Added

• Rewarded Ads - Added rewarded ads with CloudX.createRewarded(), CloudXRewardedAd, CloudXRewardedListener, and CloudXReward.
• InMobi Adapter - Added InMobi adapter support for banner, MREC, interstitial, and rewarded ads.
• Vungle Rewarded Ads - Added rewarded ad support to the Vungle adapter.
• Added CloudX.isInitialized() to check SDK initialization state.
• Added CloudX.getVersion() to get the SDK version string.
• Added setPlacement() and setCustomData() on CloudXAdView for tracking.
• Added show(activity, placement, customData) overloads on fullscreen ads for tracking.
• Added CloudXSdkConfiguration in the onInitialized() callback.
• Added CloudXAd.networkPlacement for network-specific placement IDs.
• Added new error codes: NETWORK_NO_CONNECTION, AD_ALREADY_SHOWING, DONT_KEEP_ACTIVITIES_ENABLED, AD_NOT_READY, and INVALID_APP_KEY.

Breaking Changes

• Bumped minSdk from 21 to 23.
• Replaced CloudXInitializationParams with CloudXInitializationConfiguration.
• Renamed placementName parameters to adUnitId in createBanner(), createMREC(), createInterstitial(), and createRewarded().
• Renamed CloudXAd.placementId to adUnitId.
• Removed CloudXAd.placementName.
• Renamed CloudXAd.bidderName to networkName.
• Renamed CloudXErrorCode.INVALID_PLACEMENT to INVALID_AD_UNIT.
• Changed onAdLoadFailed(placementName, cloudXError) to onAdLoadFailed(adUnitId, cloudXError).
• Changed onAdDisplayFailed(cloudXError) to onAdDisplayFailed(cloudXAd, cloudXError).
• Changed onInitialized() to onInitialized(configuration: CloudXSdkConfiguration).
• Removed the testMode initialization parameter; test mode is now server-controlled.
• Changed show() to show(activity) for interstitial and rewarded ads.

Changed

• Updated Meta Audience Network SDK from 6.17.0 to 6.21.0.

Fixed

• Fixed ad reload behavior in onAdHidden and onAdDisplayFailed callbacks.
• Ensured all load() and show() callbacks are delivered on the UI thread.

[0.12.1] - 2025-12-23

Fixed

• Fixed an ANR risk in the Meta adapter caused by bid token collection on the main thread.

[0.12.0] - 2025-12-14

Breaking Changes

• Removed CloudXError.effectiveMessage; use message directly instead.
• Removed setLoggingEnabled(); use setMinLogLevel(CloudXLogLevel.NONE) to disable logging.
• Removed CloudXPrivacy; privacy is now handled automatically through standard privacy signals.

Changed

• Enhanced GDPR support with GPP Section 2 parsing and vendor consent checking.
• Simplified TCF purpose checks to only require purposes 1 and 2.
• Added CCPA support via GPP with legacy US Privacy fallback.
• Removed COPPA handling.
• Added CloudXLogLevel.NONE for disabling logs.

Fixed

• Fixed geo API failure handling during initialization.

[0.11.1] - 2025-12-23

Fixed

• Fixed an ANR risk in the Meta adapter caused by bid token collection on the main thread.

[0.11.0] - 2025-12-09

Changed

• Migrated the SDK HTTP client from Ktor 3.0.3 to OkHttp 4.12.0.
• Added destroyed-state guards across ad formats.

[0.10.0] - 2025-12-03

Added

• Vungle Adapter - Added Vungle adapter support for banner and interstitial ads.

Changed

• Simplified the log tag to CloudX for easier logcat filtering.
• Added public API entry logging for easier integration debugging.
• SDK initialization now fails early with a clear error when no adapters are found.

Fixed

• Fixed banner refresh stopping after load failure.

[0.9.0] - 2025-11-26

Added

• Added ad revenue tracking via CloudXAdRevenueListener.onAdRevenuePaid().

Changed

• Upgraded Ktor from 2.3.8 to 3.0.3 for improved compatibility with apps using Ktor 3.x.

Fixed

• Fixed memory leaks in ad lifecycle management.
• Improved SDK stability.

[0.6.0] - 2025-11-03

Added

• Added testMode support to CloudXInitializationParams for requesting test ads during development.

[0.4.0] - 2025-10-27

Added

• Initial alpha release of CloudX Android SDK.
• Added banner and MREC ad support.
• Added interstitial ad support.
• Added real-time bidding with CloudX mediation.
• Added CloudX and Meta Audience Network adapter support.
• Added privacy compliance support for GDPR, CCPA, US Privacy, TCF, and GPP signals.
• Added session depth tracking for bid optimization.
• Added ad lifecycle callbacks and error handling.
• Added debug logging with configurable log levels.