Overview

npm install cloudx-react-native

target 'YourApp' do
  # ... existing config ...

  # CloudX ad network adapters (add as needed)
  pod 'CloudXMetaAdapter', '~> 6.21.1.0'            # FBAudienceNetwork 6.21.1
  pod 'CloudXVungleAdapter', '~> 7.7.4.0'           # VungleAds 7.7.4
  pod 'CloudXInMobiAdapter', '~> 11.3.0.0'          # InMobiSDK 11.3.0
  pod 'CloudXMintegralAdapter', '~> 8.1.5.0'        # MintegralAdSDK 8.1.5
  pod 'CloudXUnityAdsAdapter', '~> 4.19.0.0'        # UnityAds 4.19.0
  pod 'CloudXMagniteAdapterV2', '~> 1.0.0.1'        # MagniteSDK 1.0.0
  pod 'CloudXMobileFuseAdapter', '~> 1.11.0.0'      # MobileFuseSDK 1.11.0
  pod 'CloudXMolocoAdapter', '~> 4.8.0.0'           # MolocoSDKiOS 4.8.0
  pod 'CloudXVerveAdapter', '~> 3.9.0.0'            # HyBid 3.9.0
  pod 'CloudXDigitalTurbineAdapter', '~> 8.4.8.0'   # Fyber Marketplace SDK 8.4.8
  pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.2' # Google Mobile Ads SDK 13.6.0
  pod 'CloudXPangleAdapter', '~> 8.2.0.7.0'         # Ads-Global (Pangle / ByteDance) 8.2.0.7
  pod 'CloudXTaurusXAdapter', '~> 1.18.1.0'          # TaurusX SDK 1.18.1
end

cd ios && pod install

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSExceptionDomains</key>
  <dict>
    <key>example-ad-network.com</key>
    <dict>
      <key>NSExceptionAllowsInsecureHTTPLoads</key>
      <true/>
      <key>NSIncludesSubdomains</key>
      <true/>
    </dict>
  </dict>
</dict>

dependencies {
    // CloudX Android SDK
    implementation "io.cloudx:sdk:4.5.0"

    // Adapters for ad networks (add as needed)
    implementation "io.cloudx:adapter-digitalturbine:8.4.7.0"     // Digital Turbine Marketplace SDK 8.4.7
    implementation "io.cloudx:adapter-googlewaterfall:25.2.0.2"   // Google Mobile Ads SDK 25.2.0
    implementation "io.cloudx:adapter-inmobi:11.4.0.1"            // InMobi SDK 11.4.0
    implementation "io.cloudx:adapter-magnite:1.0.0.1"            // Magnite Ads SDK 1.0.0
    implementation "io.cloudx:adapter-meta:6.22.0.0"              // Meta Audience Network 6.22.0
    implementation "io.cloudx:adapter-mintegral:17.1.71.1"        // Mintegral SDK 17.1.71
    implementation "io.cloudx:adapter-mobilefuse:1.11.0.1"        // MobileFuse SDK 1.11.0
    implementation "io.cloudx:adapter-moloco:4.11.0.0"            // Moloco SDK 4.11.0
    implementation "io.cloudx:adapter-pangle:8.2.0.4.0"           // Pangle SDK 8.2.0.4
    implementation "io.cloudx:adapter-taurusx:1.18.3.0"           // TaurusX SDK 1.18.3
    implementation "io.cloudx:adapter-unityads:4.19.0.1"          // Unity Ads SDK 4.19.0
    implementation "io.cloudx:adapter-verve:3.9.0.1"              // Verve HyBid SDK 3.9.0
    implementation "io.cloudx:adapter-vungle:7.7.7.0"             // Vungle SDK 7.7.7
}

allprojects {
    repositories {
        maven { url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea" }
    }
}

import { CloudX, CloudXLogLevel } from 'cloudx-react-native';

// Optional: enable verbose logging (development only)
CloudX.setMinLogLevel(CloudXLogLevel.VERBOSE);

// Initialize with your app key
const result = await CloudX.initialize('YOUR_APP_KEY');
if (result.success) {
    console.log('CloudX initialized');
} else {
    console.error('CloudX init failed:', result.message);
}

const initialized = await CloudX.isInitialized();
const version = await CloudX.getVersion();
const tablet = await CloudX.isTablet();

import { CloudX, CloudXLogLevel } from 'cloudx-react-native';

// Enable verbose logging (call before initialize)
CloudX.setMinLogLevel(CloudXLogLevel.VERBOSE);

// Available levels: VERBOSE, DEBUG, INFO, WARN, ERROR, NONE

CloudXInterstitialAd.addAdRevenuePaidListener((adInfo) => {
    trackRevenue(adInfo.revenue, adInfo.networkName, adInfo.adUnitId);
});

import { CloudX, CloudXRevenuePlatform, CloudXRevenuePrecision } from 'cloudx-react-native';

const accepted = await CloudX.reportRevenueData({
    platform: CloudXRevenuePlatform.ADMOB,
    revenue: adValue.valueMicros / 1_000_000.0,
    adFormat: 'INTERSTITIAL',
    currencyCode: adValue.currencyCode,
    precision: CloudXRevenuePrecision.ESTIMATED,
    networkName: 'admob',
    adUnitId: 'interstitial_ad_unit',
});

const toCloudXRevenuePrecision = (precision) => {
    switch (precision) {
        case RevenuePrecisions.PRECISE:
            return CloudXRevenuePrecision.EXACT;
        case RevenuePrecisions.ESTIMATED:
            return CloudXRevenuePrecision.ESTIMATED;
        case RevenuePrecisions.PUBLISHER_PROVIDED:
            return CloudXRevenuePrecision.PUBLISHER_DEFINED;
        case RevenuePrecisions.UNKNOWN:
        default:
            return CloudXRevenuePrecision.UNDEFINED;
    }
};

const reportAdMobPaidEvent = (event, adFormat, adUnitId) =>
    CloudX.reportRevenueData({
        platform: CloudXRevenuePlatform.ADMOB,
        revenue: event.value,
        adFormat,
        currencyCode: event.currency,
        precision: toCloudXRevenuePrecision(event.precision),
        adUnitId,
    });

const AdMobBanner = () => (
    <BannerAd
        unitId={ADMOB_BANNER_UNIT_ID}
        size={BannerAdSize.BANNER}
        onPaid={(event) => {
            reportAdMobPaidEvent(event, 'banner', ADMOB_BANNER_UNIT_ID);
        }}
    />
);

const reportCustomRevenueEvent = (
    providerName,
    revenue,
    adFormat,
    currencyCode,
    adUnitId,
    placementId,
) =>
    CloudX.reportRevenueData({
        platform: CloudXRevenuePlatform.custom(providerName),
        revenue,
        adFormat,
        currencyCode,
        precision: CloudXRevenuePrecision.PUBLISHER_DEFINED,
        adUnitId,
        thirdPartyAdPlacementId: placementId,
    });

import { CloudX } from 'cloudx-react-native';

// GDPR consent: true, false, or null to defer to CMP
CloudX.setHasUserConsent(true);

// CCPA do-not-sell: true, false, or null to defer to CMP
CloudX.setDoNotSell(true);

import { CloudX } from 'cloudx-react-native';

// Set hashed user ID for targeting
CloudX.setHashedUserID('hashed-user-id');

// Set custom user key-value pairs
CloudX.setUserKeyValue('age', '25');
CloudX.setUserKeyValue('gender', 'male');
CloudX.setUserKeyValue('location', 'US');

// Set custom app key-value pairs
CloudX.setAppKeyValue('app_version', '1.0.0');
CloudX.setAppKeyValue('user_level', 'premium');

// Clear all custom key-values
CloudX.clearAllKeyValues();

import {
    CloudXBannerAd,
    CloudXMRECAd,
    CloudXInterstitialAd,
    CloudXRewardedAd,
    CloudXAdPosition,
} from 'cloudx-react-native';

const extraParameters = {
    requestId: 'request-456',
    bidFloor: 0.5,
    testRequest: false,
    keywords: ['sports', 'scores'],
    context: {
        screen: 'home',
        refreshIndex: null,
    },
};

// Call before createAd() for programmatic banner and MREC ads.
CloudXBannerAd.setExtraParameters(BANNER_AD_UNIT_ID, extraParameters);
CloudXBannerAd.createAd(BANNER_AD_UNIT_ID, CloudXAdPosition.BOTTOM_CENTER);

CloudXMRECAd.setExtraParameters(MREC_AD_UNIT_ID, extraParameters);
CloudXMRECAd.createAd(MREC_AD_UNIT_ID, CloudXAdPosition.CENTERED);

// Call before loadAd() for interstitial and rewarded ads.
CloudXInterstitialAd.setExtraParameters(INTERSTITIAL_AD_UNIT_ID, extraParameters);
CloudXInterstitialAd.loadAd(INTERSTITIAL_AD_UNIT_ID);

CloudXRewardedAd.setExtraParameters(REWARDED_AD_UNIT_ID, extraParameters);
CloudXRewardedAd.loadAd(REWARDED_AD_UNIT_ID);

import { CloudXBannerView, CloudXMRECView } from 'cloudx-react-native';

<CloudXBannerView
    adUnitId={BANNER_AD_UNIT_ID}
    extraParameters={{ section: 'top_stories', refreshIndex: 1 }}
/>

<CloudXMRECView
    adUnitId={MREC_AD_UNIT_ID}
    extraParameters={{ section: 'article_body', refreshIndex: 1 }}
/>

CloudX.setUserKeyValue('uidapi.com', uid2Token);
CloudX.setUserKeyValue('euid.eu', euidToken);
CloudX.setUserKeyValue('liveramp.com', liveRampEnvelope);
CloudX.setUserKeyValue('id5-sync.com', id5Id);

import { requestTrackingAuthorization, getTrackingAuthorizationStatus, CloudXATTStatus } from 'cloudx-react-native';

const status = await requestTrackingAuthorization();
if (status === CloudXATTStatus.AUTHORIZED) {
    console.log('Tracking authorized');
}

CloudX.setVisualDebuggingEnabled(true);