概览

#import <CloudXCore/CloudXCore.h>

CLXInitializationConfiguration *config =
    [CLXInitializationConfiguration configurationWithAppKey:@"your-app-key-here"];

[[CloudXCore shared] initializeWithConfiguration:config completion:^(CLXSdkConfiguration *sdkConfig, CLXError * _Nullable error) {
    if (sdkConfig) {
        NSLog(@"CloudX SDK 初始化成功");
    } else {
        NSLog(@"CloudX SDK 初始化失败: %@", error.localizedDescription);
    }
}];

import CloudXCore

let config = CLXInitializationConfiguration.configuration(appKey: "your-app-key-here", builderBlock: nil)

CloudXCore.shared.initialize(with: config) { sdkConfig, error in
    if sdkConfig != nil {
        print("CloudX SDK 初始化成功")
    } else {
        print("CloudX SDK 初始化失败: \(error?.localizedDescription ?? "未知错误")")
    }
}

- (void)didLoadAd:(CLXAd *)ad {
    NSLog(@"广告格式: %ld", (long)ad.adFormat);
    NSLog(@"网络: %@", ad.networkName);
    NSLog(@"收入: %@", ad.revenue);
}

func didLoad(_ ad: CLXAd) {
    print("广告格式: \(ad.adFormat)")
    print("网络: \(ad.networkName ?? "unknown")")
    print("收入: \(ad.revenue ?? 0)")
}

[CloudXCore setMinLogLevel:CLXLogLevelDebug];  // 启用调试日志
[CloudXCore setMinLogLevel:CLXLogLevelNone];   // 禁用所有日志

CloudXCore.setMinLogLevel(.debug)  // 启用调试日志
CloudXCore.setMinLogLevel(.none)   // 禁用所有日志

self.bannerAd.revenueDelegate = self;

- (void)didPayRevenueForAd:(CLXAd *)ad {
    NSLog(@"收入: %@ 来自 %@", ad.revenue, ad.networkName);
}

bannerAd?.revenueDelegate = self

func didPayRevenue(for ad: CLXAd) {
    print("收入: \(ad.revenue ?? 0) 来自 \(ad.networkName ?? "unknown")")
}

static CLXRevenuePrecision *CLXRevenuePrecisionFromGAD(GADAdValuePrecision precision) {
    switch (precision) {
        case GADAdValuePrecisionPrecise: return CLXRevenuePrecision.exact;
        case GADAdValuePrecisionEstimated: return CLXRevenuePrecision.estimated;
        case GADAdValuePrecisionPublisherProvided: return CLXRevenuePrecision.publisherDefined;
        case GADAdValuePrecisionUnknown: return CLXRevenuePrecision.undefined;
    }
    return CLXRevenuePrecision.undefined;
}

- (BOOL)reportAdMobPaidEventWithAdValue:(GADAdValue *)adValue
                               adFormat:(NSString *)adFormat
                                adUnitId:(NSString *)adUnitId
                            responseInfo:(GADResponseInfo *)responseInfo {
    GADAdNetworkResponseInfo *servedBy = responseInfo.loadedAdNetworkResponseInfo;
    CLXRevenueData *data =
        [CLXRevenueData revenueDataWithPlatform:CLXRevenuePlatformAdMob
                                        revenue:adValue.value.doubleValue
                                       adFormat:adFormat
                                   builderBlock:^(CLXRevenueDataBuilder *builder) {
            builder.currencyCode = adValue.currencyCode;
            builder.precision = CLXRevenuePrecisionFromGAD(adValue.precision);
            builder.networkName = servedBy.adSourceName;
            builder.adUnitId = adUnitId;
            builder.thirdPartyAdPlacementId = servedBy.adSourceInstanceName;
        }];

    return [[CloudXCore shared] reportRevenueData:data];
}

__weak GADBannerView *weakBannerView = bannerView;
bannerView.paidEventHandler = ^(GADAdValue *adValue) {
    [self reportAdMobPaidEventWithAdValue:adValue
                                 adFormat:@"banner"
                                  adUnitId:adUnitId
                              responseInfo:weakBannerView.responseInfo];
};

private func toCloudXRevenuePrecision(_ precision: AdValuePrecision) -> CLXRevenuePrecision {
    switch precision {
    case .precise:
        return .exact
    case .estimated:
        return .estimated
    case .publisherProvided:
        return .publisherDefined
    case .unknown:
        return .undefined
    @unknown default:
        return .undefined
    }
}

private func reportAdMobPaidEvent(
    _ adValue: AdValue,
    adFormat: String,
    adUnitId: String,
    responseInfo: ResponseInfo?
) -> Bool {
    let servedBy = responseInfo?.loadedAdNetworkResponseInfo
    let data = CLXRevenueData.revenueData(
        platform: .adMob,
        revenue: adValue.value.doubleValue,
        adFormat: adFormat
    ) { builder in
        builder.currencyCode = adValue.currencyCode
        builder.precision = toCloudXRevenuePrecision(adValue.precision)
        builder.networkName = servedBy?.adSourceName
        builder.adUnitId = adUnitId
        builder.thirdPartyAdPlacementId = servedBy?.adSourceInstanceName
    }

    return CloudXCore.shared.reportRevenueData(data)
}

bannerView.paidEventHandler = { [weak bannerView] adValue in
    _ = reportAdMobPaidEvent(
        adValue,
        adFormat: "banner",
        adUnitId: adUnitId,
        responseInfo: bannerView?.responseInfo
    )
}

@property (nonatomic, strong, nullable) IMAdMetaInfo *latestInMobiMetaInfo;

- (void)banner:(IMBanner *)banner didReceiveWithMetaInfo:(IMAdMetaInfo *)info {
    self.latestInMobiMetaInfo = info;
}

- (void)bannerAdImpressed:(IMBanner *)banner {
    if (!self.latestInMobiMetaInfo) {
        return;
    }

    [self reportInMobiImpressionWithMetaInfo:self.latestInMobiMetaInfo
                                    adFormat:@"banner"
                                 placementId:inMobiPlacementId];
    self.latestInMobiMetaInfo = nil;
}

- (BOOL)reportInMobiImpressionWithMetaInfo:(IMAdMetaInfo *)metaInfo
                                  adFormat:(NSString *)adFormat
                               placementId:(NSString *)placementId {
    CLXRevenueData *data =
        [CLXRevenueData revenueDataWithPlatform:CLXRevenuePlatformInMobi
                                        revenue:[metaInfo getBid]
                                       adFormat:adFormat
                                   builderBlock:^(CLXRevenueDataBuilder *builder) {
            builder.precision = CLXRevenuePrecision.estimated;
            builder.thirdPartyAdPlacementId = placementId;
            builder.creativeId = metaInfo.creativeID;
        }];

    return [[CloudXCore shared] reportRevenueData:data];
}

private var latestInMobiMetaInfo: IMAdMetaInfo?

func banner(_ banner: IMBanner, didReceiveWithMetaInfo info: IMAdMetaInfo) {
    latestInMobiMetaInfo = info
}

func bannerAdImpressed(_ banner: IMBanner) {
    guard let metaInfo = latestInMobiMetaInfo else {
        return
    }

    _ = reportInMobiImpression(
        metaInfo,
        adFormat: "banner",
        placementId: inMobiPlacementId
    )
    latestInMobiMetaInfo = nil
}

private func reportInMobiImpression(
    _ metaInfo: IMAdMetaInfo,
    adFormat: String,
    placementId: String
) -> Bool {
    let data = CLXRevenueData.revenueData(
        platform: .inMobi,
        revenue: metaInfo.getBid(),
        adFormat: adFormat
    ) { builder in
        builder.precision = .estimated
        builder.thirdPartyAdPlacementId = placementId
        builder.creativeId = metaInfo.creativeID
    }

    return CloudXCore.shared.reportRevenueData(data)
}

static NSString *CLXTopOnStringValue(NSDictionary *extra, NSString *key) {
    id value = extra[key];
    return [value isKindOfClass:NSString.class] ? value : nil;
}

static CLXRevenuePrecision *CLXRevenuePrecisionFromTopOn(NSString *precision) {
    if ([precision isEqualToString:@"exact"]) return CLXRevenuePrecision.exact;
    if ([precision isEqualToString:@"estimated"]) return CLXRevenuePrecision.estimated;
    if ([precision isEqualToString:@"publisher_defined"]) return CLXRevenuePrecision.publisherDefined;
    return CLXRevenuePrecision.undefined;
}

- (BOOL)reportTopOnRevenueForPlacementID:(NSString *)placementID
                                   extra:(NSDictionary *)extra
                                adFormat:(NSString *)adFormat {
    NSNumber *revenue = extra[@"publisher_revenue"];
    if (![revenue isKindOfClass:NSNumber.class]) {
        return NO;
    }

    CLXRevenueData *data =
        [CLXRevenueData revenueDataWithPlatform:CLXRevenuePlatformTopOn
                                        revenue:revenue.doubleValue
                                       adFormat:adFormat
                                   builderBlock:^(CLXRevenueDataBuilder *builder) {
            builder.currencyCode = CLXTopOnStringValue(extra, @"currency");
            builder.precision = CLXRevenuePrecisionFromTopOn(CLXTopOnStringValue(extra, @"precision"));
            builder.networkName = CLXTopOnStringValue(extra, @"network_name");
            builder.adUnitId = placementID;
            builder.thirdPartyAdPlacementId = CLXTopOnStringValue(extra, @"network_placement_id");
            builder.networkPlacement = CLXTopOnStringValue(extra, @"adsource_id");
            builder.countryCode = CLXTopOnStringValue(extra, @"country");
        }];

    return [[CloudXCore shared] reportRevenueData:data];
}

- (void)didRevenueForPlacementID:(NSString *)placementID extra:(NSDictionary *)extra {
    [self reportTopOnRevenueForPlacementID:placementID
                                     extra:extra
                                  adFormat:@"banner"];
}

private func topOnRevenuePrecision(_ precision: String?) -> CLXRevenuePrecision {
    switch precision {
    case "exact":
        return .exact
    case "estimated":
        return .estimated
    case "publisher_defined":
        return .publisherDefined
    default:
        return .undefined
    }
}

private func reportTopOnRevenue(
    placementID: String,
    extra: [AnyHashable: Any],
    adFormat: String
) -> Bool {
    guard let revenue = (extra["publisher_revenue"] as? NSNumber)?.doubleValue else {
        return false
    }

    let data = CLXRevenueData.revenueData(
        platform: .topOn,
        revenue: revenue,
        adFormat: adFormat
    ) { builder in
        builder.currencyCode = extra["currency"] as? String
        builder.precision = topOnRevenuePrecision(extra["precision"] as? String)
        builder.networkName = extra["network_name"] as? String
        builder.adUnitId = placementID
        builder.thirdPartyAdPlacementId = extra["network_placement_id"] as? String
        builder.networkPlacement = extra["adsource_id"] as? String
        builder.countryCode = extra["country"] as? String
    }

    return CloudXCore.shared.reportRevenueData(data)
}

func didRevenue(forPlacementID placementID: String, extra: [AnyHashable: Any]) {
    _ = reportTopOnRevenue(
        placementID: placementID,
        extra: extra,
        adFormat: "banner"
    )
}

- (BOOL)reportCustomRevenueEventWithProviderName:(NSString *)providerName
                                         revenue:(double)revenue
                                        adFormat:(NSString *)adFormat
                                    currencyCode:(NSString *)currencyCode
                                        adUnitId:(NSString *)adUnitId
                                     placementId:(NSString *)placementId {
    CLXRevenueData *data =
        [CLXRevenueData revenueDataWithPlatform:CLXRevenuePlatformCustom(providerName)
                                        revenue:revenue
                                       adFormat:adFormat
                                   builderBlock:^(CLXRevenueDataBuilder *builder) {
            builder.currencyCode = currencyCode;
            builder.precision = CLXRevenuePrecision.publisherDefined;
            builder.adUnitId = adUnitId;
            builder.thirdPartyAdPlacementId = placementId;
        }];

    return [[CloudXCore shared] reportRevenueData:data];
}

private func reportCustomRevenueEvent(
    providerName: String,
    revenue: Double,
    adFormat: String,
    currencyCode: String,
    adUnitId: String,
    placementId: String
) -> Bool {
    let data = CLXRevenueData.revenueData(
        platform: .custom(providerName),
        revenue: revenue,
        adFormat: adFormat
    ) { builder in
        builder.currencyCode = currencyCode
        builder.precision = .publisherDefined
        builder.adUnitId = adUnitId
        builder.thirdPartyAdPlacementId = placementId
    }

    return CloudXCore.shared.reportRevenueData(data)
}

#import <AppTrackingTransparency/AppTrackingTransparency.h>

if (@available(iOS 14.5, *)) {
    [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
        // 在 ATT 响应后初始化 CloudX SDK
        [self initializeCloudX];
    }];
} else {
    [self initializeCloudX];
}

import AppTrackingTransparency

if #available(iOS 14.5, *) {
    ATTrackingManager.requestTrackingAuthorization { status in
        // 在 ATT 响应后初始化 CloudX SDK
        self.initializeCloudX()
    }
} else {
    initializeCloudX()
}

// 在初始化 SDK 之前设置隐私
[CloudXCore setHasUserConsent:@YES];
[CloudXCore setDoNotSell:@NO];

[[CloudXCore shared] initializeWithConfiguration:config completion:completion];

// 在初始化 SDK 之前设置隐私
CloudXCore.setHasUserConsent(true)
CloudXCore.setDoNotSell(false)

CloudXCore.shared.initialize(with: config) { sdkConfig, error in
    // ...
}

// 设置哈希用户 ID 用于定向
[[CloudXCore shared] setHashedUserID:@"hashed-user-id"];

// 设置自定义用户键值对（受隐私法规清除）
[[CloudXCore shared] setUserKeyValue:@"age" value:@"25"];
[[CloudXCore shared] setUserKeyValue:@"gender" value:@"male"];
[[CloudXCore shared] setUserKeyValue:@"location" value:@"US"];

// 设置用于请求定向的自定义应用键值对
[[CloudXCore shared] setAppKeyValue:@"app_version" value:@"1.0.0"];
[[CloudXCore shared] setAppKeyValue:@"user_level" value:@"premium"];

// 清除所有自定义键值
[[CloudXCore shared] clearAllKeyValues];

// 设置哈希用户 ID 用于定向
CloudXCore.shared.setHashedUserID("hashed-user-id")

// 设置自定义用户键值对（受隐私法规清除）
CloudXCore.shared.setUserKeyValue("age", value: "25")
CloudXCore.shared.setUserKeyValue("gender", value: "male")
CloudXCore.shared.setUserKeyValue("location", value: "US")

// 设置用于请求定向的自定义应用键值对
CloudXCore.shared.setAppKeyValue("app_version", value: "1.0.0")
CloudXCore.shared.setAppKeyValue("user_level", value: "premium")

// 清除所有自定义键值
CloudXCore.shared.clearAllKeyValues()

CloudXCore.shared.setUserKeyValue("uidapi.com", value: uid2Token)
CloudXCore.shared.setUserKeyValue("euid.eu", value: euidToken)
CloudXCore.shared.setUserKeyValue("liveramp.com", value: liveRampEnvelope)
CloudXCore.shared.setUserKeyValue("id5-sync.com", value: id5Id)

[[CloudXCore shared] setUserKeyValue:@"uidapi.com" value:uid2Token];
[[CloudXCore shared] setUserKeyValue:@"euid.eu" value:euidToken];
[[CloudXCore shared] setUserKeyValue:@"liveramp.com" value:liveRampEnvelope];
[[CloudXCore shared] setUserKeyValue:@"id5-sync.com" value:id5Id];

banner?.setExtraParameter("requestId", value: "request-456")
banner?.setExtraParameter("impressionKey", value: "impression-789")
banner?.load()

[self.banner setExtraParameter:@"requestId" value:@"request-456"];
[self.banner setExtraParameter:@"impressionKey" value:@"impression-789"];
[self.banner load];