Integration

AppLovin Auction adapter for CloudX iOS SDK. Supports Interstitial, Rewarded, Native, and App Open.

This page covers iOS integration. Signed-in publishers can open the AppLovin Auction setup guide from the CloudX documentation dashboard.

The iOS adapter supports Interstitial, Rewarded, Native, and App Open. Banner and MREC are not supported.

Installation

CocoaPods

pod 'CloudXAppLovinAdapter', '~> 13.6.3.0'

pod install --repo-update

Manual

1. Download CloudXAppLovinAdapter.xcframework.zip from Releases.
2. Unzip and add CloudXAppLovinAdapter.xcframework to your Xcode project.
3. Add AppLovinSDK version 13.6.3.
4. Add -ObjC to Other Linker Flags.

Initialization

Initialize CloudX with your CloudX app key as usual. CloudX receives the MAX SDK key and MAX ad-unit IDs from server configuration.

The adapter initializes MAX when AppLovin Auction placements are provisioned. If another component initializes MAX first, it must use the same SDK key.

The adapter registers automatically when it is linked into the app. You do not need to call CloudXAppLovinAdapterRegister().

Privacy

Set consent through the CloudX privacy API before CloudX initialization when possible.

The adapter forwards explicit CloudX consent to MAX:

• User consent maps to the MAX user-consent setting.
• Do Not Sell maps to the MAX Do Not Sell setting.

The adapter also forwards later explicit privacy updates.

Follow AppLovin’s current iOS privacy guidance and SKAdNetwork setup for host-app requirements that are outside the CloudX adapter.

Cached ads

The adapter keeps one eligible MAX fill for each provisioned placement.

• An auction loss retains the fill.
• An auction win consumes the exact fill.
• Consumption starts a replacement load.
• Native fills expire after one hour.
• Fullscreen formats use MAX expiration callbacks.

The adapter pauses new prefetch work while the app is in the background. It resumes when the app becomes active.

Revenue

MAX reports realized revenue through the paid event for the displayed ad. CloudX sends that revenue with the AppLovin Auction impression and suppresses duplicate global AppLovin ILRD for the same placement.

An impression can be reported without revenue when MAX does not send a timely paid event. CloudX does not replace missing realized revenue with the auction price.

Compatibility

Support

For support, contact support@cloudx.io.