概览

npm install cloudx-react-native

platform :ios, '15.0'

target 'YourApp' do
  # ... 现有配置 ...

  # CloudX 广告网络适配器（按需添加）
  pod 'CloudXBigoAdapter', '~> 6.1.0.0'           # BigoADS 6.1.0
  pod 'CloudXMetaAdapter', '~> 6.22.0.0'            # FBAudienceNetwork 6.22.0
  pod 'CloudXVungleAdapter', '~> 7.7.6.0'           # VungleAds 7.7.6
  pod 'CloudXInMobiAdapter', '~> 11.4.1.0'          # InMobiSDK 11.4.1
  pod 'CloudXMintegralAdapter', '~> 8.1.6.1'        # MintegralAdSDK 8.1.6
  pod 'CloudXUnityAdsAdapter', '~> 4.20.1.0'        # UnityAds 4.20.1
  pod 'CloudXMagniteAdapterV2', '~> 1.0.0.2'        # MagniteSDK 1.0.0
  pod 'CloudXMobileFuseAdapter', '~> 1.11.0.1'      # MobileFuseSDK 1.11.0
  pod 'CloudXMolocoAdapter', '~> 4.11.1.0'           # MolocoSDKiOS 4.11.1
  pod 'CloudXVerveAdapter', '~> 3.9.0.0'            # HyBid 3.9.0
  pod 'CloudXDigitalTurbineAdapter', '~> 8.4.10.0'  # Fyber Marketplace SDK 8.4.10
  pod 'CloudXGoogleWaterfallAdapter', '~> 13.9.0.0' # Google Mobile Ads SDK 13.9.0
  pod 'CloudXPangleAdapter', '~> 8.3.0.6.0'         # Ads-Global（Pangle / 字节跳动）8.3.0.6
  pod 'CloudXTaurusXAdapter', '~> 1.18.2.0'          # TaurusX SDK 1.18.2
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.9.0"

    // 广告网络适配器（按需添加）
    implementation "io.cloudx:adapter-bigo:6.1.0.0"               // BIGO Ads SDK 6.1.0
    implementation "io.cloudx:adapter-digitalturbine:8.4.7.1"     // Digital Turbine Marketplace SDK 8.4.7
    implementation "io.cloudx:adapter-googlewaterfall:25.5.0.0"   // Google Mobile Ads SDK 25.5.0
    implementation "io.cloudx:adapter-inmobi:11.5.0.0"            // InMobi SDK 11.5.0
    implementation "io.cloudx:adapter-magnite:1.0.0.2"            // 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.81.0"        // Mintegral SDK 17.1.81
    implementation "io.cloudx:adapter-mobilefuse:1.12.0.0"        // MobileFuse SDK 1.12.0
    implementation "io.cloudx:adapter-moloco:4.13.0.0"            // Moloco SDK 4.13.0
    implementation "io.cloudx:adapter-pangle:8.3.0.4.0"           // Pangle SDK 8.3.0.4
    implementation "io.cloudx:adapter-taurusx:1.19.1.0"           // TaurusX SDK 1.19.1
    implementation "io.cloudx:adapter-unityads:4.21.0.0"          // Unity Ads SDK 4.21.0
    implementation "io.cloudx:adapter-verve:3.9.2.0"              // Verve HyBid SDK 3.9.2
    implementation "io.cloudx:adapter-vungle:7.7.9.0"             // Vungle SDK 7.7.9
}

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

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

// 可选：启用详细日志（仅限开发环境）
CloudX.setMinLogLevel(CloudXLogLevel.VERBOSE);

// 使用您的应用密钥初始化
const result = await CloudX.initialize('YOUR_APP_KEY');
if (result.success) {
    console.log('CloudX 初始化完成');
} else {
    console.error('CloudX 初始化失败:', result.message);
}

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

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

// 启用详细日志（在 initialize 之前调用）
CloudX.setMinLogLevel(CloudXLogLevel.VERBOSE);

// 可用级别: VERBOSE, DEBUG, INFO, WARN, ERROR, NONE

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

const opened = await CloudX.showMediationDebugger();

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 同意：true、false 或 null（回退到 CMP）
CloudX.setHasUserConsent(true);

// CCPA do-not-sell：true、false 或 null（回退到 CMP）
CloudX.setDoNotSell(true);

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

// 设置哈希用户 ID 用于定向
CloudX.setHashedUserID('hashed-user-id');

// 设置自定义用户键值对
CloudX.setUserKeyValue('age', '25');
CloudX.setUserKeyValue('gender', 'male');
CloudX.setUserKeyValue('location', 'US');

// 设置自定义应用键值对
CloudX.setAppKeyValue('app_version', '1.0.0');
CloudX.setAppKeyValue('user_level', 'premium');

// 清除所有自定义键值对
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,
    },
};

// 程序化横幅和 MREC 广告：在 createAd() 之前调用。
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);

// 插屏和激励视频广告：在 loadAd() 之前调用。
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);
CloudX.setUserKeyValue('intentiq.com', intentIQId);

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

const status = await requestTrackingAuthorization();
if (status === CloudXATTStatus.AUTHORIZED) {
    console.log('跟踪已授权');
}

CloudX.setVisualDebuggingEnabled(true);