Skip to main content

​
Changelog

All notable changes to the CloudX iOS SDK will be documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

​
[1.3.0] - 2025-12-14

​
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

​
[1.2.1] - 2025-12-04

​
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

​
[1.2.0] - 2025-11-26

​
🚀 First Official Release

The CloudX iOS SDK is a comprehensive mobile advertising solution that provides programmatic advertising capabilities for iOS applications.

​
Features

​
Ad Formats

  • Banner Ads (320×50) - Standard banner advertisements
  • MREC Ads (300×250) - Medium rectangle advertisements
  • Interstitial Ads - Full-screen advertisements

​
Core Capabilities

  • Server-Side Header Bidding - Real-time programmatic auction with multiple demand sources
  • Unified Auction - Single SDK manages bidding across all integrated demand partners
  • Privacy Compliance - Built-in support for GDPR, CCPA, and App Tracking Transparency (ATT)
  • Comprehensive Analytics - Session tracking, impression metrics, and revenue reporting

​
Developer Experience

  • Simple Integration - Initialize once, create ads with a single method call
  • Delegate-Based Callbacks - Clear lifecycle events for ad loading, display, and errors
  • Test Mode - Built-in test mode for development and QA
  • Flexible Logging - Configurable log verbosity for debugging

​
Architecture

  • Static XCFramework Distribution - Fast app launch times, no dSYM warnings
  • Modular Adapter System - Add only the demand partners you need
  • iOS 14.0+ - Modern iOS support with Swift and Objective-C compatibility

​
Components

ComponentDescription
CloudXCoreCore SDK with programmatic advertising engine
CloudXMetaAdapterMeta Audience Network integration
CloudXVungleAdapterVungle/Liftoff integration with header bidding
CloudXRendererCreative rendering engine for CloudX demand

​
Installation

Podfile
platform :ios, '14.0'

target 'YourApp' do
  use_frameworks!
  
  pod 'CloudXCore'
  pod 'CloudXMetaAdapter'      # Optional
  pod 'CloudXVungleAdapter'    # Optional
  pod 'CloudXRenderer'         # For test ads
end

​
Quick Start

// Initialize SDK
[[CloudXCore shared] initializeSDKWithAppKey:@"YOUR_APP_KEY"
                                    testMode:NO
                                  completion:^(BOOL success, CLXError *error) {
    if (success) {
        NSLog(@"CloudX SDK initialized!");
    }
}];

// Create and load a banner ad
CLXBannerAdView *banner = [[CloudXCore shared] createBannerWithPlacement:@"PLACEMENT_ID"
                                                           viewController:self
                                                                 delegate:self
                                                                     tmax:nil];
[self.view addSubview:banner];
[banner load];

​
Documentation

For complete documentation, see the Integration Guide.