Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt

Use this file to discover all available pages before exploring further.

​
[3.4.0] - 2026-05-25

​
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

​
[3.2.0] - 2026-05-12

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

​
[3.1.2] - 2026-04-21

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

​
[2.2.3] - 2026-03-26

​
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

​
[2.0.0] - 2026-03-05

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

​
[2.0.0-beta.1] - 2026-02-26

​
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