Changelog - CloudX Documentation

May 28, 2026

Android

Android SDK 4.1.2

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.

May 27, 2026

iOSUnity

iOS SDK 3.4.1

Added

Digital Turbine Adapter — New CloudXDigitalTurbineAdapter (Banner, MREC, Interstitial, Rewarded, Native). Install: pod 'CloudXDigitalTurbineAdapter', '~> 3.4.1'. Backed by Fyber_Marketplace_SDK >= 8.4.0, < 9.0.

Fixed

Duplicate didLoadAd / didShowAd callbacks on banner refresh — When a partner adapter SDK fired its load or impression callback more than once for the same ad, the publisher delegate could receive duplicate callbacks. The first callback is now treated as canonical and subsequent re-fires from the same adapter are dropped, so the publisher surface emits exactly one load and one impression per ad.

Unity SDK 4.1.0

What’s New

Added CloudXSdk.Arbiter(bids, onCompleted) for running a trusted-arbiter auction from Unity
Added SetBannerExtraParameter(adUnitId, key, value), SetMRecExtraParameter(adUnitId, key, value), SetInterstitialExtraParameter(adUnitId, key, value), and SetRewardedExtraParameter(adUnitId, key, value) to pass network-specific parameters to each ad format

SDK Updates

Updated Android SDK from 4.0.0 to 4.1.1 — see Android SDK changelog for details
Updated iOS SDK from 3.2.0 to 3.4.1 — see iOS SDK changelog for details
Added Moloco and Verve adapter support for Android and iOS

May 26, 2026

Android

Android SDK 4.1.1

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.

May 25, 2026

React Native

React Native SDK 3.4.0

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 metadata - Added CloudXAdInfo.adValues for SDK-provided loaded-ad metadata used by features such as Trusted Arbiter.
Additional adapter coverage - Updated setup guidance for the latest supported iOS and Android adapter set, including Google Waterfall, Moloco, and Verve where supported by the underlying native SDKs.

Changed

Updated underlying native SDK pins to iOS CloudXCore ~> 3.4.0 and Android io.cloudx:sdk:4.1.0.

Platform Support

iOS: CloudXCore ~> 3.4.0
Android: io.cloudx:sdk:4.1.0

May 22, 2026

AndroidiOS

Android SDK 4.1.0

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.

iOS SDK 3.4.0

Added

Verve Adapter — New CloudXVerveAdapter (Banner, MREC, Interstitial, Rewarded, Native). Install: pod 'CloudXVerveAdapter', '~> 3.4.0'. Backed by HyBid 3.8.0.
Moloco Adapter — New CloudXMolocoAdapter (Banner, MREC, Interstitial, Rewarded, Native). Install: pod 'CloudXMolocoAdapter', '~> 3.4.0'. Backed by MolocoSDKiOS ~> 4.6.0.
Non-SDK CloudX-rendered HTML banner and MREC with MRAID 3.0 — HTML banner and MREC creatives can now be served through the CloudX renderer, with MRAID 3.0 support.
Native-in-banner and native-in-MREC support — Native creatives can be served into banner or MREC slots on Meta, Vungle, and Moloco.
Trusted Arbiter — Added public APIs for comparing CloudX bids with supported third-party bids from Unity LevelPlay and PubMatic, and selecting the winning platform through CloudX arbitration.
CLXAd.adValues property — New read-only NSDictionary<NSString *, NSString *> exposing SDK-defined loaded-ad metadata. Values may be absent depending on ad format and network.

Changed

UnityAds adapter version range — Widened to accept Unity Ads 4.x patch releases (>= 4.17.0, < 5.0).
Publisher delegate main-queue threading is now documented contract — All CLXAdDelegate callbacks (and protocols that extend it) and CLXAdRevenueDelegate callbacks deliver on the main queue and may fire inline relative to the SDK call that triggered them. No runtime change.

Fixed

Native ad memory leak during long sessions — Long-lived publisher integrations that load many native ads no longer accumulate retained observers across native ad refresh cycles.

May 21, 2026

CLI

CloudX CLI 0.33

Config validation, line-item edits, and publishing

CloudX CLI 0.33 adds the ability to edit line items directly from your configuration workflow, publish reviewed drafts, and validate local YAML files or remote configs.To update an existing Homebrew installation to this release:

brew upgrade cloudx

Added

Config validation — Added cloudx config validate [file] for validating local YAML files, plus remote validation of the live config, a published version, or a draft by ID. Use --strict to fail on warnings. Read the docs →
Line-item writes — Added cloudx config edit create-line-item, cloudx config edit update-line-item, and cloudx config edit delete-line-item for preparing line-item changes in a draft config. Draft edits run validation and never publish automatically. Read the docs →
Configuration publishing — Added cloudx config publish --id <draft-id> to publish a validated draft as the live config. Read the docs →
CLI upgrade notice — The CLI now shows a terminal notice when the CloudX API reports that a newer CLI version is available, with a link to update instructions.

May 15, 2026

APIDashboard

CloudX API — Public API release

CloudX now has a public API for programmatic access to reporting, auction inspection, and account configuration data. The API uses CloudX API keys as bearer tokens and is documented with an interactive OpenAPI reference. Read the docs →

Added

Reporting endpoints — Retrieve dashboard summaries, breakdown rows, bidder performance, app performance, ad-unit performance, and CSV-style exports.
Auction inspection endpoints — Inspect auctions, rounds, bids, ILRD rows, and related delivery details.
Configuration endpoints — Read live, draft, and published account configuration, including configuration history.

Dashboard — Frequency caps

CloudX Dashboard now supports SSP frequency caps for both ad units and segments.You can now:

cap a specific ad unit by hour, day, or session
cap traffic routed through a specific segment
set a default cap for requests that do not include any segments

Frequency caps are evaluated before the auction and counted on impression, so once capped inventory reaches its limit, CloudX returns no fill instead of continuing to serve. Ad-unit configuration is documented in Manage ad units.

May 13, 2026

CLI

CloudX CLI 0.32

To update an existing Homebrew installation to this release:

brew upgrade cloudx

Added

API-key authentication — CLOUDX_API_KEY support for CI, scheduled jobs, scripts, and other non-interactive workflows. API keys are managed by administrators in Settings > API Keys. Read the docs →
CloudX breakdown reporting — cloudx report breakdown --by <dimensions> --metrics <metrics> for CloudX-only aggregate reporting across requests, impressions, revenue, fill rate, eCPM, clicks, and CTR.
Report granularity and controls — cloudx report dashboard and cloudx report export support --granularity daily|hourly; breakdown reports add hourly buckets, sorting, and filters with --granularity hourly, --top, --bottom, and --having.
Configurable request timeout — Global cloudx --timeout <duration> for API requests. The default remains 1m, and values are capped at 2m. Read the docs →

May 12, 2026

React Native

React Native SDK 3.2.0

This release updates the React Native SDK to use CloudX native SDK 3.2.0 on both iOS and Android. There are no required JavaScript API changes for publishers upgrading from 3.1.2.

Added

Magnite adapter support — adds Magnite adapter package support on both iOS and Android.
Improved diagnostics — expands native event visibility for dashboard and operational troubleshooting.
(Android) Bid-floor controls — adds support for native bid-floor controls in the ad request path.

Changed

Updated underlying native SDKs from 3.1.0 to 3.2.0.
(Android) Banner lifecycle handling — improves banner view attach and detach behavior for more consistent adapter behavior.

Fixed

(Android) Adapter discovery diagnostics — missing adapter dependencies now report clearer diagnostics.
(Android) Banner load errors — banner load failures now provide clearer diagnostics when a network reports a loaded banner without a renderable banner view.

Platform Support

iOS: CloudXCore ~> 3.2.0
Android: io.cloudx:sdk:3.2.0

May 7, 2026

CLI

CloudX CLI 0.31

Cross-mediator report sources

CloudX CLI 0.31 adds report source filtering for publishers that forward impression-level revenue data from external mediation platforms. Existing report commands stay CloudX-only by default, and --source can be used to opt into mediator ILRD where supported.To update an existing Homebrew installation to this release:

brew upgrade cloudx

Added

Report source filtering — Added --source to cloudx report dashboard, cloudx report apps, and cloudx report ad-units. Use --source all for CloudX plus all available external mediator sources, --source applovin for one mediator, or --source cloudx,applovin for side-by-side comparison.
Source-aware report metrics — Dashboard, app, and ad-unit reports can now include external mediator ILRD for revenue, impressions, eCPM, and revenue share. Fill rate remains CloudX-only when external mediators are included because external ILRD does not include CloudX request counts.
Clearer source semantics — --source uses the mediator/platform source from ILRD, such as applovin, not downstream demand network names such as ADMOB_BIDDING. Read the docs →

May 6, 2026

CLI

CloudX CLI 0.30

Auction list performance and timeout handling

CloudX CLI 0.30 focuses on making auction inspection more reliable during heavier searches and making timeout failures easier to understand.To update an existing Homebrew installation to this release:

brew upgrade cloudx

Improved

Faster auction lists with ILRD filters — Improved cloudx auction list performance when working with ILRD-heavy searches, especially when narrowing results by external ILRD and mediator.
Longer default request timeout — Increased the default CLI timeout to 60 seconds, giving heavier requests more time to complete.
Clearer timeout errors — Timeout failures now show a clearer CLI message instead of a low-level networking error.
Better timeout visibility — Timed-out CLI requests are easier for CloudX support to identify and diagnose.

May 5, 2026

CLI

CloudX CLI 0.29

Auction and config inspection

CloudX CLI 0.29 expands the terminal workflow from reporting into production debugging. You can now inspect auctions, rounds, bids, ILRD payloads, live configs, drafts, and published config history without switching to the dashboard.To update an existing Homebrew installation to this release:

brew upgrade cloudx

Added

Auction inspection — Added cloudx auction list, cloudx auction show, cloudx auction rounds, and cloudx auction bids for reviewing auction records, related rows, aggregate round metrics, bid and non-bid rows, floor sources, CloudX ILRD, and opted-in external mediator ILRD. Read the docs →
Config inspection — Added cloudx config show for live configs, published versions, drafts, and config rows addressed by ID, with YAML output by default and JSON output for automation. Read the docs →
Config history — Added cloudx config history for published config history, creator filtering, recent-change filtering, draft inclusion, and publish-time diff summaries.
Workflow examples — Updated CLI examples and overview pages with auction, config, JSON, and combined reporting workflows. See examples →

April 28, 2026

UnityDashboard

Unity SDK 4.0.0

What’s New

Added Unity Package Manager (UPM) consumer support so the SDK can be referenced from internal UPM packages. Runtime and editor scripts now ship with assembly definitions (CloudX.Sdk and CloudX.Sdk.Editor).
Removed the runtime dependency on Newtonsoft.Json. The SDK no longer requires com.unity.nuget.newtonsoft-json to be present in your project.

SDK Updates

Updated Android SDK from 3.2.0 to 4.0.0 — see Android SDK changelog for details

Dashboard — A/B Testing

Stop guessing whether a new line item, bid floor, or network configuration will actually move the needle. A/B Testing lets you split impressions between your current setup and an edited variant, then watch them race head-to-head on the metrics that matter — revenue, eCPM, fill rate, and impressions — all in real time, in production.When the data is in, promoting the winner takes a click. Open any active ad unit, hit Create A/B test, and start optimizing your monetization strategy with the rigor your revenue deserves. Read the docs →

April 27, 2026

AndroidMCP

Android SDK 4.0.0

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.

CloudX MCP — AI-native reporting and docs search

The numbers you need, the way you ask. CloudX now has a hosted Model Context Protocol server that plugs straight into ChatGPT, Claude Code, Cursor, Codex, and any other MCP client of your choosing — so your AI assistant can pull live revenue, fill rate, eCPM, and bidder performance from CloudX without you copy-pasting between tabs.Ask “how did US iOS traffic perform last week?” and get the actual numbers back, filtered exactly the way you’d filter them in the dashboard. Ask “how do I integrate the Magnite adapter?” and get an answer grounded in our real docs. Read the docs →

April 24, 2026

AndroidUnity

Android SDK 3.2.0

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.

Unity SDK 3.2.0

What’s New

Added DestroyInterstitial(adUnitId) and DestroyRewarded(adUnitId) to the Unity API so fullscreen ads can be explicitly destroyed and cleaned up

SDK Updates

Updated Android SDK from 3.1.0 to 3.2.0 — see Android SDK changelog for details
Updated iOS SDK from 3.1.0 to 3.2.0 — see iOS SDK changelog for details
Added Magnite adapter support for Android and iOS

April 22, 2026

iOSCLI

iOS SDK 3.2.0

Added

Magnite Adapter — New CloudXMagniteAdapter (Banner, MREC, Interstitial, Rewarded). Install: pod 'CloudXMagniteAdapter', '~> 3.2.0'.
Richer dashboard telemetry — Full telemetry overhaul. More robust event capture, new events, and increased observability.

CloudX CLI 0.28

CloudX in your terminal

Some questions don’t need a browser. With the new CloudX CLI, your daily numbers are one keystroke away — cloudx report dashboard shows revenue, fill rate, eCPM, and trends right next to your prompt. Filter by country, platform, ad unit, or test traffic the same way you would in the dashboard.When you need data downstream, switch to --json for structured output or cloudx report export for CSV ready to pipe into a spreadsheet, a notebook, or another tool. Install with brew install cloudx, sign in once, and your reporting workflow follows you wherever you work. Read the docs →

April 21, 2026

React Native

React Native SDK 3.1.2

Major bump aligning the React Native SDK with the 3.1.0 native SDKs, and adds a manual privacy API in JavaScript.

Install 3.1.2 or later — 3.1.0 and 3.1.1 are not installable. Both earlier 3.1 versions were removed from npm after a release-build issue on iOS. 3.1.2 is the first installable release of the 3.1 line.

Native Ads support is tracked separately and is not part of this release.

Added

Manual Privacy API — CloudX.setHasUserConsent(value) and CloudX.setDoNotSell(value) bridge to the native privacy APIs on iOS and Android. Accepts boolean to set, or null to clear a previously set value and fall back to the IAB storage.
Error Codes — added LOAD_NOT_ALLOWED_WHILE_SHOWING (303) and ADAPTER_INITIALIZATION_TIMEOUT (622) to CloudXErrorCode.

Changed

Updated underlying native SDKs from 2.2.3 to 3.1.0. For full platform-specific details, see the native changelogs:

This SDK now pins iOS CloudXCore ~> 3.1.0 and Android io.cloudx:sdk:3.1.0, and all bundled adapters pin to the same major. The native Android SDK’s new Context requirement is handled by the bridge — no publisher code changes required.

Fixed

(iOS) Release-build compile error — resolves a compile error that prevented archiving an app against the earlier 3.1.0 and 3.1.1 builds for App Store submission.
Banner and MREC render delay — on some devices, a banner or MREC could report a successful load but stay blank until the next auto-refresh (~30 seconds later). The first impression now renders immediately on show.

Upgrading from 2.2.3

(iOS) Remove any manual top-inset workaround. If you used CloudXBannerAd.createAdWithOffsets and passed the device’s top safe-area inset as the yOffset (for example, insets.top from react-native-safe-area-context), remove it. TOP_CENTER and BOTTOM_CENTER banners already position themselves inside the safe area automatically, so an additional offset will push the banner below the safe area on devices with a notch or Dynamic Island. Use CloudXBannerAd.createAd(adUnitId, CloudXAdPosition.TOP_CENTER) for the default placement.
Banner and MREC view lifecycle. Banner and MREC ads now load detached from your view hierarchy and attach to the presenting view controller (iOS) or root content view (Android) when you call showBanner / showMREC. This is invisible through the JavaScript API — mentioned here only for publishers who inspect the native view hierarchy between create and show. A side effect is that you can now pre-load a banner into memory and show it later without it occupying a parent view in the meantime.

Platform Support

iOS: CloudXCore ~> 3.1.0
Android: io.cloudx:sdk:3.1.0

April 17, 2026

AndroidUnity

Android SDK 3.1.0

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.

Unity SDK 3.1.0

What’s New

Revenue-paid callbacks are now delivered immediately and may run off the Unity main thread on Android and iOS

Integration Notes

Do not touch Unity scene or UI APIs directly inside OnAdRevenuePaid. Dispatch back to the main thread first if needed.

SDK Updates

Updated Android SDK from 3.0.0 to 3.1.0 — see Android SDK changelog for details
Updated iOS SDK from 2.2.8 to 3.1.0 — see iOS SDK changelog for details

April 16, 2026

iOS

iOS SDK 3.1.0

Added

Meta Reels & Native Ads — Meta Reels (9:16 vertical video) and other Meta native ad formats are now supported via CLXPublisherNative. This release supports Meta native ads only; additional bidder support is coming in a future release.
Per-Adapter Initialization Timeout — SDK initialization now supports per-adapter timeouts for more predictable startup behavior.

Fixed

Xcode 26 Compatibility — Resolved a build warning when compiling with Xcode 26.

April 9, 2026

iOS

iOS SDK 2.2.9

Fixed

Unity Ads Adapter — Fixed initialization, privacy consent forwarding, rewarded callbacks, and bid token error handling for improved reliability across regions.

April 6, 2026

AndroidUnity

Android SDK 3.0.0

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.

Unity SDK 3.0.0

SDK Updates

Updated Android SDK from 2.2.7 to 3.0.0 — see Android SDK changelog for details
Updated iOS SDK from 2.2.7 to 2.2.8 — see iOS SDK changelog for details

April 3, 2026

iOS

iOS SDK 2.2.8

Fixed

Crash Fix — Fixed a crash that could occur during concurrent ad event tracking on background threads

April 2, 2026

AndroidUnity

Android SDK 2.2.7

Fixed

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

Unity SDK 2.2.7

What’s New

Added first-party metrics telemetry coverage across Android SDK call sites through the updated Android SDK
Fixed iOS banner display after deferred initialization and improved Vungle adapter runtime reliability through the updated iOS SDK

Integration Notes

The Unity integration flow and banner/MREC placement/custom-data ordering guidance introduced in 2.2.6 remain unchanged in this release

SDK Updates

Updated Android SDK from 2.2.6 to 2.2.7 — see Android SDK changelog for details
Updated iOS SDK from 2.2.6 to 2.2.7 — see iOS SDK changelog for details

April 1, 2026

AndroidiOSUnity

Android SDK 2.2.6

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.

iOS SDK 2.2.7

Fixed

Deferred Banner Display — Fixed an issue where banners created before SDK initialization completed could fail to display after initialization succeeded
Vungle Adapter Reliability — Fixed an issue where Vungle rewarded and interstitial ads could crash at runtime due to a method being incorrectly stripped during linking

Unity SDK 2.2.6

What’s New

Added isAdReady support across fullscreen adapters through the updated Android and iOS SDKs
Added Unity Ads privacy consent forwarding through the updated iOS SDK

Integration Notes

For Unity banner and MREC ads, call SetBannerPlacement(...) / SetBannerCustomData(...) and SetMrecPlacement(...) / SetMrecCustomData(...) before CreateBanner(...) or CreateMrec(...) if you want those values applied to the first ad request

SDK Updates

Updated Android SDK from 2.2.4 to 2.2.6 — see Android SDK changelog for details
Updated iOS SDK from 2.2.4 to 2.2.6 — see iOS SDK changelog for details

March 30, 2026

AndroidiOS

Android SDK 2.2.5

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.

iOS SDK 2.2.6

Added

Privacy Consent for Unity Ads — Unity Ads adapter now supports GDPR and CCPA privacy consent forwarding
isAdReady Support — Fullscreen ad adapters now support isAdReady for reliably querying ad availability before calling show

Fixed

Banner Visibility Accuracy — Fixed an issue where setting banner.hidden = YES did not pause ad refresh. Hidden banners could continue loading ads without being impression-eligible, potentially impacting CPMs.
Improved Dependency Compatibility — Widened third-party SDK version constraints (VungleAds, FBAudienceNetwork, InMobiSDK) to prevent CocoaPods dependency conflicts when integrating alongside other mediation SDKs
Fullscreen Ad Reliability — Fixed an issue where ad lifecycle callbacks could be silently lost in rare scenarios
iOS 16 Crash Fix — Fixed a crash on iOS 16 devices related to session tracking

March 27, 2026

Unity

Unity SDK 2.2.4

What’s New

Added SetHasUserConsent(bool?) and SetDoNotSell(bool?) for manual privacy overrides before initialization
Added automatic NSUserTrackingUsageDescription injection during the iOS post-process step when the app has not defined one yet

Fixes

Fixed Android banner view initialization so newly created banner views start hidden until you show them
Fixed iOS interstitial and rewarded show-failure callbacks so OnAdShowFailed now includes both the failed CloudXAd and the corresponding CloudXError, matching the Unity callback contract
Updated the Unity demo app to initialize banner and MREC views once and retry fullscreen ads after both load failures and show failures

SDK Updates

Updated Android SDK from 2.2.3 to 2.2.4 — see Android SDK changelog for details
Updated iOS SDK from 2.2.3 to 2.2.4 — see iOS SDK changelog for details

March 26, 2026

AndroidiOSReact Native

Android SDK 2.2.4

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.

iOS SDK 2.2.4

Changed

Server-Driven Location Controls — Location coordinate sharing in bid requests is now controlled via the CloudX dashboard (account-scoped). No SDK code changes required for publishers.
Improved Bid Request Data — Content language is now included in bid requests for improved ad targeting

React Native SDK 2.2.3

Added

Unity Ads Adapter — Unity Ads now available for banner, interstitial, and rewarded ads (iOS and Android)
Mintegral Adapter — Mintegral adapter now available as a standard release (iOS and Android)

Improved

Fullscreen Ad Reliability — Fixed issues where loading a fullscreen ad while another was showing could silently fail (iOS), and ad reload now works correctly in hidden/display-failed callbacks (Android)
Error Diagnostics — Improved error visibility for no-bid scenarios, making it easier to diagnose fill rate issues
Reduced SDK Footprint — (Android) Removed appcompat and webkit transitive dependencies; renderer now bundled in the core SDK module

Changed

Updated underlying native SDKs from 2.0.0 to 2.2.3. For full platform-specific details, see the native changelogs:

Platform Support

iOS: CloudXCore ~> 2.2.3
Android: io.cloudx:sdk:2.2.3

March 23, 2026

Unity

Unity SDK 2.2.3

SDK Updates

Updated Android SDK from 2.2.2 to 2.2.3 — see Android SDK changelog for details
Updated iOS SDK from 2.2.2 to 2.2.3 — see iOS SDK changelog for details
Added Unity Ads adapter support for Android and iOS

March 20, 2026

Android

Android SDK 2.2.3

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.

March 19, 2026

iOSFlutter

iOS SDK 2.2.3

Added

Unity Ads Adapter — Unity Ads adapter now available for banner, interstitial, and rewarded ads

Fixed

Unity Ads Initialization — Fixed an issue where the Unity Ads adapter could fail to initialize correctly in some configurations

Flutter SDK 2.2.3

First public release on pub.dev. The Dart package major.minor.patch matches the CloudX native SDKs it ships against (iOS CloudXCore, Android io.cloudx:sdk).

Requirements

Dart SDK: >=2.17.1 <4.0.0 (see the package pubspec on pub.dev)
Flutter: >=3.0.0
iOS: 13.0+
Android: minSdk 23 (API 23)

The Dart floor is set low on purpose so apps on older stable Flutter lines can adopt cloudx_flutter without a full toolchain jump.

Included in this release

Banner, MREC, interstitial, and rewarded ads; programmatic overlay APIs and inline CloudXAdView
Listener callbacks, targeting key/values, impression-level revenue (onAdRevenuePaid), and related lifecycle events
Privacy helpers CloudX.setHasUserConsent and CloudX.setDoNotSell (nullable bool? clears overrides and defers to CMP where applicable)
Native pins: CloudXCore 2.2.3 (iOS), io.cloudx:sdk 2.2.3 (Android)

Host app: network adapters

The published plugin is core-only. Declare only the ad-network adapters you need in CocoaPods and Gradle, all at 2.2.3 (Meta, Vungle, InMobi, Mintegral, Unity Ads, renderer, etc.). For Unity Ads, add CloudXUnityAdsAdapter and io.cloudx:adapter-unityads. See the Flutter integration guide for copy-paste snippets.

Android: Mintegral

If you depend on io.cloudx:adapter-mintegral, you must add Mintegral’s Maven repository to Gradle — artifacts are not on Maven Central. See Android integration — Mintegral Maven repository.

March 17, 2026

AndroidUnity

Android SDK 2.2.2

Added

Improved SDK initialization diagnostics by reporting adapter metadata.

Fixed

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

Unity SDK 2.2.2

SDK Updates

Updated Android SDK from 2.2.1 to 2.2.2 — see Android SDK changelog for details
Updated iOS SDK from 2.0.0 to 2.2.2 — see iOS SDK changelog for details
Lowered iOS minimum deployment target from 15.0 to 13.0
Added Mintegral adapter support (Android + iOS)

March 16, 2026

iOS

iOS SDK 2.2.2

Added

Manual Privacy API — New setHasUserConsent: and setDoNotSell: methods for publisher-controlled privacy consent
Mintegral Adapter — Mintegral adapter now available as a standard release

Fixed

Improved Error Visibility — Increased error visibility for no-bid scenarios, making it easier to diagnose fill rate issues
Fullscreen Ad Loading — Fixed an issue where loading a fullscreen ad while another was showing could silently fail
Fullscreen Failure Callbacks — Fixed missing ad unit ID in fullscreen ad failure callbacks
Renderer Impression Tracking — Fixed viewability tracking accuracy in CloudX Renderer

Changed

Mintegral SDK — Upgraded from 8.0.7 to 8.0.8

March 11, 2026

AndroidUnity

Android SDK 2.2.1

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.

Unity SDK 2.2.1

SDK Updates

Updated Android SDK from 2.2.0 to 2.2.1 — see Android SDK changelog for details
Added Mintegral adapter and Maven repository for Android

March 10, 2026

AndroidUnity

Android SDK 2.2.0

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.

Unity SDK 2.2.0

SDK Updates

Updated Android SDK from 2.0.1 to 2.2.0 — see Android SDK changelog for details

March 5, 2026

React Native

React Native SDK 2.0.0

First stable release of the CloudX React Native SDK.

Added

Full SDK integration with banner, MREC, interstitial, and rewarded ad formats
Programmatic overlay APIs for banner (CloudXBannerAd) and MREC (CloudXMRECAd)
Fullscreen ad modules: CloudXInterstitialAd and CloudXRewardedAd
React hooks: useCloudXInterstitial, useCloudXRewarded, useCloudXBanner
Privacy compliance support (CCPA, GDPR, GPP via IAB shared storage)
User targeting with key-value pairs (setUserKeyValue, setAppKeyValue)
Impression-level revenue tracking via addAdRevenuePaidListener
App Tracking Transparency (ATT) support for iOS 14+
Display failure events (addAdFailedToDisplayEventListener) for interstitial and rewarded
Full TypeScript type definitions with CloudX-prefixed namespace
Fabric (New Architecture) and Paper (Legacy) support

Fixed (iOS — since 2.0.0-beta.1)

Fixed duplicate onInterstitialHidden / onRewardedAdHidden callbacks firing twice on close
Fixed double revenue callback for rewarded ads
Fixed thread-safety crash in bid token dictionary construction
showInterstitial / showRewarded now emit display failure events when topViewController is nil (previously silent return)
didFailToLoadAd: now broadcasts to all fullscreen listeners when adUnitId is nil (previously silent)
rewardAmount sent as NSNumber instead of NSString (type alignment with Android and TypeScript)
Improved diagnostic logging for load/failure paths

Platform Support

iOS: CloudXCore ~> 2.2.0-beta
Android: io.cloudx:sdk:2.0.0

March 4, 2026

AndroidUnity

Android SDK 2.0.1

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.

Unity SDK 2.0.1

This patch release adds full compatibility with Unity Engine 2022.3.

Compatibility

Added support for Unity Engine 2022.3 LTS

SDK Updates

Updated Android SDK from 2.0.0 to 2.0.1 — see Android SDK changelog for details

February 26, 2026

React Native

React Native SDK 2.0.0-beta.1

Added

Initial full SDK integration with CloudX Core SDK
Banner ads via CloudXBannerAd module
MREC ads (300x250) via CloudXMRECAd module
Interstitial ads via CloudXInterstitialAd module
Rewarded ads via CloudXRewardedAd module
React hooks: useCloudXInterstitial, useCloudXRewarded, useCloudXBanner
Privacy compliance support (CCPA, GDPR, GPP)
User targeting with key-value pairs
Impression-level revenue tracking
App Tracking Transparency (iOS)
Full TypeScript type definitions
Fabric (New Architecture) and Paper (Legacy) support

Platform Support

iOS: CloudXCore ~> 2.1.0-beta
Android: io.cloudx:sdk:2.0.0

February 5, 2026

Unity

Unity SDK 2.0.0

Breaking Changes

Banner and MREC ads no longer auto-load after creation. You must now call LoadBanner() or LoadMrec() explicitly after CreateBanner() or CreateMrec()
CloudXAd property renames:
- PlacementName is now AdUnitId
- BidderName is now NetworkName

What’s New

Added placement and custom data support for all ad formats:
- SetBannerPlacement(adUnitId, placement) and SetBannerCustomData(adUnitId, customData)
- SetMRecPlacement(adUnitId, placement) and SetMRecCustomData(adUnitId, customData)
- ShowInterstitial(adUnitId, placement?, customData?) now accepts optional placement and customData parameters
- ShowRewarded(adUnitId, placement?, customData?) now accepts optional placement and customData parameters
New CloudXAd properties: AdFormat, Placement, NetworkPlacement

SDK Updates

Updated Android SDK from 0.12.1 to 2.0.0
Updated Android adapters from 0.12.1 to 2.0.0
Updated iOS CloudXCore from 1.3.0 to 2.0.0
Updated iOS CloudXRenderer from 1.3.0 to 2.0.0
Updated iOS adapters from 1.3.0 to 2.0.0

February 4, 2026

AndroidiOS

Android SDK 2.0.0

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.

iOS SDK 2.0.0

This release replaces placement names with Ad Unit IDs from the CloudX dashboard. Update your createBannerWithAdUnitId:, createMRECWithAdUnitId:, createInterstitialWithAdUnitId:, and createRewardedWithAdUnitId: calls to use the ad unit ID instead of a placement name.

Added

Rewarded ads with createRewardedWithAdUnitId:delegate: and CLXRewardedDelegate
InMobi adapter (SDK 11.1) with support for banner, MREC, interstitial, and rewarded ads
CLXAd.networkPlacement property for network-specific placement ID

Breaking Changes

Renamed placement parameter to adUnitId in createBannerWithAdUnitId:, createMRECWithAdUnitId:, createInterstitialWithAdUnitId:, createRewardedWithAdUnitId:
Renamed CLXAd.placement to adUnitId
Renamed CLXAd.bidderName to networkName
Renamed CLXErrorCodeInvalidPlacement to CLXErrorCodeInvalidAdUnit
Changed bannerAdView:didFailWithError: to include ad unit ID in error
Removed testMode parameter from initializeSDKWithAppKey:completion: - test mode is now server-controlled via dashboard

Changed

Meta Audience Network SDK updated from 6.17.0 to 6.21.0
Vungle SDK updated from 7.4.2 to 7.6.0

Fixed

Fixed IFA (Identifier for Advertisers) collection
Fixed country/geo-targeting data collection

January 15, 2026

Unity

Unity SDK 0.12.1

What’s New

Added support for iOS platform

Performance Improvements

Android: BidToken is now generated on a background thread for improved performance

SDK Updates

Updated Android SDK from 0.12.0 to 0.12.1

Improvements

Renamed internal UnityMainThreadDispatcher class to avoid namespace collisions with third-party packages

December 23, 2025

Android

Android SDK 0.12.1

Fixed

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

Android SDK 0.11.1

Fixed

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

December 15, 2025

Unity

Unity SDK 0.12.0

Initial release of CloudX Unity SDK

December 14, 2025

AndroidiOS

Android SDK 0.12.0

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.

iOS SDK 1.3.0

Added

Banner Refresh Retry - Banners now automatically retry loading after failure when hidden

Fixed

App Extension Compatibility - SDK now works correctly in App Extensions (no UIApplication calls)
Rewarded Delegate Callbacks - Fixed callback ordering bug
Symbol Collisions - All category methods now prefixed with clx_ to prevent conflicts

Changed

CloudXCore now distributed as Dynamic Framework - Enables crash symbolication for SDK issues

December 9, 2025

Android

Android SDK 0.11.0

Changed

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

December 4, 2025

iOS

iOS SDK 1.2.1

Added

Visual Debugger Button - New debugging tool for development and QA
High-ROI Key-Value Targeting Examples - Enhanced demo apps with targeting signal examples

Fixed

Corrected vendored_frameworks paths in podspecs

December 3, 2025

Android

Android SDK 0.10.0

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.

November 26, 2025

AndroidiOS

Android SDK 0.9.0

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.

iOS SDK 1.2.0

🚀 First Official Release

Initial release of the CloudX iOS SDK with support for banner, MREC, and interstitial ads.

November 3, 2025

Android

Android SDK 0.6.0

Added

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

October 27, 2025

Android

Android SDK 0.4.0

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.

Documentation Index

​Android SDK 4.1.2

​Added

​Changed

​iOS SDK 3.4.1

​Added

​Fixed

​Unity SDK 4.1.0

​What’s New

​SDK Updates

​Android SDK 4.1.1

​Added

​Changed

​React Native SDK 3.4.0

​Added

​Changed

​Platform Support

​Android SDK 4.1.0

​Added

​iOS SDK 3.4.0

​Added

​Changed

​Fixed

​CloudX CLI 0.33

​Config validation, line-item edits, and publishing

​Added

​CloudX API — Public API release

​Added

​Dashboard — Frequency caps

​CloudX CLI 0.32

​Added

​React Native SDK 3.2.0

​Added

​Changed

​Fixed

​Platform Support

​CloudX CLI 0.31

​Cross-mediator report sources

​Added

​CloudX CLI 0.30

​Auction list performance and timeout handling

​Improved

​CloudX CLI 0.29

​Auction and config inspection

​Added

​Unity SDK 4.0.0

​What’s New

​SDK Updates

​Dashboard — A/B Testing

​Android SDK 4.0.0

​Breaking Changes

​Added

​Changed

​Fixed

​CloudX MCP — AI-native reporting and docs search

​Android SDK 3.2.0

​Added

​Changed

​Fixed

​Unity SDK 3.2.0

​What’s New

​SDK Updates

​iOS SDK 3.2.0

​Added

​CloudX CLI 0.28

​CloudX in your terminal

​React Native SDK 3.1.2

​Added

​Changed

​Fixed

​Upgrading from 2.2.3

​Platform Support

​Android SDK 3.1.0

​Added

​Changed

​Fixed

​Unity SDK 3.1.0

​What’s New

​Integration Notes

​SDK Updates

Android SDK 4.1.2

Added

Changed

iOS SDK 3.4.1

Added

Fixed

Unity SDK 4.1.0

What’s New

SDK Updates

Android SDK 4.1.1

Added

Changed

React Native SDK 3.4.0

Added

Changed

Platform Support

Android SDK 4.1.0

Added

iOS SDK 3.4.0

Added

Changed

Fixed

CloudX CLI 0.33

Config validation, line-item edits, and publishing

Added

CloudX API — Public API release

Added

Dashboard — Frequency caps

CloudX CLI 0.32

Added

React Native SDK 3.2.0

Added

Changed

Fixed

Platform Support

CloudX CLI 0.31

Cross-mediator report sources

Added

CloudX CLI 0.30

Auction list performance and timeout handling

Improved

CloudX CLI 0.29

Auction and config inspection

Added

Unity SDK 4.0.0

What’s New

SDK Updates

Dashboard — A/B Testing

Android SDK 4.0.0

Breaking Changes

Added

Changed

Fixed

CloudX MCP — AI-native reporting and docs search

Android SDK 3.2.0

Added

Changed

Fixed

Unity SDK 3.2.0

What’s New

SDK Updates

iOS SDK 3.2.0

Added

CloudX CLI 0.28

CloudX in your terminal

React Native SDK 3.1.2

Added

Changed

Fixed

Upgrading from 2.2.3

Platform Support

Android SDK 3.1.0

Added

Changed

Fixed

Unity SDK 3.1.0

What’s New

Integration Notes

SDK Updates

iOS SDK 3.1.0