Changelog - CloudX Documentation

[4.1.4] - 2026-06-18

Added

Pangle Adapter Readiness - Added the SDK-side metadata needed for the independently released Pangle Android adapter. Publishers can integrate Pangle demand with io.cloudx:adapter-pangle:8.1.0.3.0 on CloudX Android SDK 4.1.4 or newer.
CloudX Fullscreen HTML Rendering - Added SDK support for CloudX-served MRAID fullscreen creatives in interstitial and rewarded placements, including OMID viewability measurement for CloudX HTML ads.

Changed

SDK Startup Performance - Reduced SDK initialization and ad-request stalls caused by device signal collection.
MRAID Fullscreen Reliability - Improved fullscreen CloudX HTML ads with load watchdogs, a loading indicator, larger close hit targets, mraid.unload() support, more reliable hide callbacks, and safer reward handling when rewarded ads are closed early.
Native Ad Rendering - Improved native image handling for local file-backed assets and prevented stale async image loads from overwriting reused native ad views.
Telemetry Timing Accuracy - SDK telemetry durations now use monotonic app-uptime timing for more reliable diagnostics.

[4.1.3] - 2026-05-31

Changed

Resilient Adapter Initialization - A slow ad network adapter no longer blocks SDK initialization. Each adapter is given a soft initialization timeout, after which the SDK finishes initializing while that adapter continues to start up in the background. Adapters that are not yet ready are held out of auctions until they finish, preventing premature bids that could otherwise fail to fill.

[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.

​[4.1.4] - 2026-06-18

​Added

​Changed

​[4.1.3] - 2026-05-31

​Changed

​[4.1.2] - 2026-05-28

​Added

​Changed

​[4.1.1] - 2026-05-26

​Added

​Changed

​[4.1.0] - 2026-05-22

​Added

​[4.0.0] - 2026-04-27

​Breaking Changes

​Added

​Changed

​Fixed

​[3.2.0] - 2026-04-24

​Added

​Changed

​Fixed

​[3.1.0] - 2026-04-17

​Added

​Changed

​Fixed

​[3.0.0] - 2026-04-06

​Breaking Changes

​Changed

​[2.2.7] - 2026-04-02

​Fixed

​[2.2.6] - 2026-04-01

​Changed

​Fixed

​[2.2.5] - 2026-03-30

​Added

​Changed

​Fixed

​[2.2.4] - 2026-03-26

​Added

​Changed

​Fixed

​[2.2.3] - 2026-03-20

​Added

​Changed

​Fixed

​[2.2.2] - 2026-03-17

​Added

​Fixed

​[2.2.1] - 2026-03-11

​Changed

​Fixed

​[2.2.0] - 2026-03-10

​Added

​Changed

​Fixed

​[2.0.1] - 2026-03-04

​Changed

​Fixed

​[2.0.0] - 2026-02-04

​Added

​Breaking Changes

​Changed

​Fixed

​[0.12.1] - 2025-12-23

​Fixed

​[0.12.0] - 2025-12-14

​Breaking Changes

​Changed

​Fixed

​[0.11.1] - 2025-12-23

​Fixed

​[0.11.0] - 2025-12-09

​Changed

​[0.10.0] - 2025-12-03

​Added

​Changed

​Fixed

​[0.9.0] - 2025-11-26

​Added

[4.1.4] - 2026-06-18

Added

Changed

[4.1.3] - 2026-05-31

Changed

[4.1.2] - 2026-05-28

Added

Changed

[4.1.1] - 2026-05-26

Added

Changed

[4.1.0] - 2026-05-22

Added

[4.0.0] - 2026-04-27

Breaking Changes

Added

Changed

Fixed

[3.2.0] - 2026-04-24

Added

Changed

Fixed

[3.1.0] - 2026-04-17

Added

Changed

Fixed

[3.0.0] - 2026-04-06

Breaking Changes

Changed

[2.2.7] - 2026-04-02

Fixed

[2.2.6] - 2026-04-01

Changed

Fixed

[2.2.5] - 2026-03-30

Added

Changed

Fixed

[2.2.4] - 2026-03-26

Added

Changed

Fixed

[2.2.3] - 2026-03-20

Added

Changed

Fixed

[2.2.2] - 2026-03-17

Added

Fixed

[2.2.1] - 2026-03-11

Changed

Fixed

[2.2.0] - 2026-03-10

Added

Changed

Fixed

[2.0.1] - 2026-03-04

Changed

Fixed

[2.0.0] - 2026-02-04

Added

Breaking Changes

Changed

Fixed

[0.12.1] - 2025-12-23

Fixed

[0.12.0] - 2025-12-14

Breaking Changes

Changed

Fixed

[0.11.1] - 2025-12-23

Fixed

[0.11.0] - 2025-12-09

Changed

[0.10.0] - 2025-12-03

Added

Changed

Fixed

[0.9.0] - 2025-11-26

Added