cloudx-react-native 3.4.6 → 3.6.0

package/ios/CloudX.mm

@@ -4,7 +4,9 @@
 //
 
 #import "CloudX.h"
+#import "CloudXExtraParameters.h"
 #import <React/RCTUtils.h>
+#import <math.h>
 
 
 @interface UIColor (CLXUtils)
@@ -57,6 +59,7 @@
 
 // Fullscreen ad storage — lazily created on first load/show, keyed by ad unit ID.
 @property (nonatomic, strong) NSMutableDictionary<NSString *, CLXInterstitial *> *interstitials;
+@property (nonatomic, strong) NSMutableDictionary<NSString *, CLXAppOpen *> *appOpenAds;
 @property (nonatomic, strong) NSMutableDictionary<NSString *, CLXRewarded *> *rewardedAds;
 
 // Overlay banner/MREC state — each ad unit ID owns exactly one CLXBannerAdView,
@@ -107,6 +110,14 @@ static NSString *const ON_INTERSTITIAL_DISPLAY_FAILED_EVENT  = @"OnInterstitialD
 static NSString *const ON_INTERSTITIAL_HIDDEN_EVENT          = @"OnInterstitialHiddenEvent";
 static NSString *const ON_INTERSTITIAL_AD_REVENUE_PAID       = @"OnInterstitialAdRevenuePaid";
 
+static NSString *const ON_APPOPEN_LOADED_EVENT               = @"OnAppOpenLoadedEvent";
+static NSString *const ON_APPOPEN_LOAD_FAILED_EVENT          = @"OnAppOpenLoadFailedEvent";
+static NSString *const ON_APPOPEN_CLICKED_EVENT              = @"OnAppOpenClickedEvent";
+static NSString *const ON_APPOPEN_DISPLAYED_EVENT            = @"OnAppOpenDisplayedEvent";
+static NSString *const ON_APPOPEN_DISPLAY_FAILED_EVENT       = @"OnAppOpenDisplayFailedEvent";
+static NSString *const ON_APPOPEN_HIDDEN_EVENT               = @"OnAppOpenHiddenEvent";
+static NSString *const ON_APPOPEN_AD_REVENUE_PAID            = @"OnAppOpenAdRevenuePaid";
+
 static NSString *const ON_REWARDED_AD_LOADED_EVENT           = @"OnRewardedAdLoadedEvent";
 static NSString *const ON_REWARDED_AD_LOAD_FAILED_EVENT      = @"OnRewardedAdLoadFailedEvent";
 static NSString *const ON_REWARDED_AD_CLICKED_EVENT          = @"OnRewardedAdClickedEvent";
@@ -157,6 +168,7 @@ RCT_EXPORT_MODULE(CloudX)
         CloudXShared = self;
 
         self.interstitials = [NSMutableDictionary dictionaryWithCapacity: 2];
+        self.appOpenAds    = [NSMutableDictionary dictionaryWithCapacity: 2];
         self.rewardedAds   = [NSMutableDictionary dictionaryWithCapacity: 2];
 
         self.adViews                         = [NSMutableDictionary dictionaryWithCapacity: 2];
@@ -283,6 +295,20 @@ RCT_EXPORT_METHOD(arbiter:(NSDictionary<NSString *, id> *)configuration resolve:
     }];
 }
 
+#pragma mark - Publisher-reported Revenue
+
+RCT_EXPORT_METHOD(reportRevenueData:(NSDictionary<NSString *, id> *)data resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
+{
+    CLXRevenueData *revenueData = [self revenueDataFromDictionary: data];
+    if ( !revenueData )
+    {
+        resolve(@(NO));
+        return;
+    }
+
+    resolve(@([[CloudXCore shared] reportRevenueData: revenueData]));
+}
+
 #pragma mark - Banners
 
 RCT_EXPORT_METHOD(createBanner:(NSString *)adUnitIdentifier position:(NSString *)bannerPosition)
@@ -431,7 +457,9 @@ RCT_EXPORT_METHOD(loadInterstitial:(NSString *)adUnitIdentifier)
 RCT_EXPORT_METHOD(setInterstitialExtraParameters:(NSString *)adUnitIdentifier extraParameters:(NSDictionary<NSString *, id> *)extraParameters)
 {
     CLXInterstitial *interstitial = [self retrieveInterstitialForAdUnitIdentifier: adUnitIdentifier];
-    [self applyExtraParameters: extraParameters toFullscreenAd: interstitial];
+    [CloudXExtraParameters applyExtraParameters: extraParameters toFullscreenAd: interstitial logBlock:^(NSString *message) {
+        [self log: @"%@", message];
+    }];
 }
 
 RCT_EXPORT_METHOD(isInterstitialReady:(NSString *)adUnitIdentifier resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
@@ -471,6 +499,60 @@ RCT_EXPORT_METHOD(destroyInterstitial:(NSString *)adUnitIdentifier)
     }
 }
 
+#pragma mark - App Open
+
+RCT_EXPORT_METHOD(loadAppOpen:(NSString *)adUnitIdentifier)
+{
+    [self log: @"loadAppOpen called from JS — adUnitId: %@", adUnitIdentifier];
+    CLXAppOpen *appOpen = [self retrieveAppOpenForAdUnitIdentifier: adUnitIdentifier];
+    [appOpen load];
+}
+
+RCT_EXPORT_METHOD(setAppOpenExtraParameters:(NSString *)adUnitIdentifier extraParameters:(NSDictionary<NSString *, id> *)extraParameters)
+{
+    CLXAppOpen *appOpen = [self retrieveAppOpenForAdUnitIdentifier: adUnitIdentifier];
+    [CloudXExtraParameters applyExtraParameters: extraParameters toFullscreenAd: appOpen logBlock:^(NSString *message) {
+        [self log: @"%@", message];
+    }];
+}
+
+RCT_EXPORT_METHOD(isAppOpenReady:(NSString *)adUnitIdentifier resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
+{
+    CLXAppOpen *appOpen = [self retrieveAppOpenForAdUnitIdentifier: adUnitIdentifier];
+    resolve(@([appOpen isReady]));
+}
+
+RCT_EXPORT_METHOD(showAppOpen:(NSString *)adUnitIdentifier placement:(nullable NSString *)placement customData:(nullable NSString *)customData)
+{
+    UIViewController *vc = [self topViewController];
+    if ( !vc )
+    {
+        [self log: @"showAppOpen: no visible view controller — emitting display failure"];
+        NSDictionary *body = @{@"adUnitId": adUnitIdentifier ?: @"",
+                               @"code":     @(-1),
+                               @"message":  @"No visible view controller to present app open ad from"};
+        [self sendReactNativeEventWithName: ON_APPOPEN_DISPLAY_FAILED_EVENT body: body];
+        return;
+    }
+
+    CLXAppOpen *appOpen = [self retrieveAppOpenForAdUnitIdentifier: adUnitIdentifier];
+    [appOpen showFromViewController: vc placement: placement customData: customData];
+}
+
+RCT_EXPORT_METHOD(destroyAppOpen:(NSString *)adUnitIdentifier)
+{
+    [self log: @"Destroying app open ad with ad unit identifier \"%@\"", adUnitIdentifier];
+
+    CLXAppOpen *appOpen = self.appOpenAds[adUnitIdentifier];
+    if ( appOpen )
+    {
+        appOpen.delegate = nil;
+        appOpen.revenueDelegate = nil;
+        [appOpen destroy];
+        [self.appOpenAds removeObjectForKey: adUnitIdentifier];
+    }
+}
+
 #pragma mark - Rewarded
 
 RCT_EXPORT_METHOD(loadRewarded:(NSString *)adUnitIdentifier)
@@ -483,7 +565,9 @@ RCT_EXPORT_METHOD(loadRewarded:(NSString *)adUnitIdentifier)
 RCT_EXPORT_METHOD(setRewardedExtraParameters:(NSString *)adUnitIdentifier extraParameters:(NSDictionary<NSString *, id> *)extraParameters)
 {
     CLXRewarded *rewardedAd = [self retrieveRewardedAdForAdUnitIdentifier: adUnitIdentifier];
-    [self applyExtraParameters: extraParameters toFullscreenAd: rewardedAd];
+    [CloudXExtraParameters applyExtraParameters: extraParameters toFullscreenAd: rewardedAd logBlock:^(NSString *message) {
+        [self log: @"%@", message];
+    }];
 }
 
 RCT_EXPORT_METHOD(isRewardedReady:(NSString *)adUnitIdentifier resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
@@ -548,6 +632,10 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
         {
             name = ON_INTERSTITIAL_LOADED_EVENT;
         }
+        else if ( adFormat == CLXAdFormatAppOpen )
+        {
+            name = ON_APPOPEN_LOADED_EVENT;
+        }
         else if ( adFormat == CLXAdFormatRewarded )
         {
             name = ON_REWARDED_AD_LOADED_EVENT;
@@ -575,6 +663,11 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
                 [self sendReactNativeEventWithName: ON_INTERSTITIAL_LOAD_FAILED_EVENT
                                               body: [self adLoadFailedInfoForAd: key withError: error]];
             }
+            for ( NSString *key in self.appOpenAds )
+            {
+                [self sendReactNativeEventWithName: ON_APPOPEN_LOAD_FAILED_EVENT
+                                              body: [self adLoadFailedInfoForAd: key withError: error]];
+            }
             for ( NSString *key in self.rewardedAds )
             {
                 [self sendReactNativeEventWithName: ON_REWARDED_AD_LOAD_FAILED_EVENT
@@ -593,14 +686,18 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
         {
             name = ON_INTERSTITIAL_LOAD_FAILED_EVENT;
         }
+        else if ( self.appOpenAds[adUnitId] )
+        {
+            name = ON_APPOPEN_LOAD_FAILED_EVENT;
+        }
         else if ( self.rewardedAds[adUnitId] )
         {
             name = ON_REWARDED_AD_LOAD_FAILED_EVENT;
         }
         else
         {
-            [self log: @"didFailToLoadAd — adUnitId '%@' not found in any dictionary (keys: adViews=%@, interstitials=%@, rewardedAds=%@)",
-             adUnitId, self.adViews.allKeys, self.interstitials.allKeys, self.rewardedAds.allKeys];
+            [self log: @"didFailToLoadAd — adUnitId '%@' not found in any dictionary (keys: adViews=%@, interstitials=%@, appOpenAds=%@, rewardedAds=%@)",
+             adUnitId, self.adViews.allKeys, self.interstitials.allKeys, self.appOpenAds.allKeys, self.rewardedAds.allKeys];
             return;
         }
 
@@ -625,6 +722,10 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
         {
             name = ON_INTERSTITIAL_CLICKED_EVENT;
         }
+        else if ( adFormat == CLXAdFormatAppOpen )
+        {
+            name = ON_APPOPEN_CLICKED_EVENT;
+        }
         else if ( adFormat == CLXAdFormatRewarded )
         {
             name = ON_REWARDED_AD_CLICKED_EVENT;
@@ -643,13 +744,17 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
 {
     dispatch_async(dispatch_get_main_queue(), ^{
         CLXAdFormat adFormat = ad.adFormat;
-        if ( adFormat != CLXAdFormatInterstitial && adFormat != CLXAdFormatRewarded ) return;
+        if ( adFormat != CLXAdFormatInterstitial && adFormat != CLXAdFormatAppOpen && adFormat != CLXAdFormatRewarded ) return;
 
         NSString *name;
         if ( adFormat == CLXAdFormatInterstitial )
         {
             name = ON_INTERSTITIAL_DISPLAYED_EVENT;
         }
+        else if ( adFormat == CLXAdFormatAppOpen )
+        {
+            name = ON_APPOPEN_DISPLAYED_EVENT;
+        }
         else
         {
             name = ON_REWARDED_AD_DISPLAYED_EVENT;
@@ -663,13 +768,17 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
 {
     dispatch_async(dispatch_get_main_queue(), ^{
         CLXAdFormat adFormat = ad.adFormat;
-        if ( adFormat != CLXAdFormatInterstitial && adFormat != CLXAdFormatRewarded ) return;
+        if ( adFormat != CLXAdFormatInterstitial && adFormat != CLXAdFormatAppOpen && adFormat != CLXAdFormatRewarded ) return;
 
         NSString *name;
         if ( adFormat == CLXAdFormatInterstitial )
         {
             name = ON_INTERSTITIAL_DISPLAY_FAILED_EVENT;
         }
+        else if ( adFormat == CLXAdFormatAppOpen )
+        {
+            name = ON_APPOPEN_DISPLAY_FAILED_EVENT;
+        }
         else
         {
             name = ON_REWARDED_AD_DISPLAY_FAILED_EVENT;
@@ -683,13 +792,17 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
 {
     dispatch_async(dispatch_get_main_queue(), ^{
         CLXAdFormat adFormat = ad.adFormat;
-        if ( adFormat != CLXAdFormatInterstitial && adFormat != CLXAdFormatRewarded ) return;
+        if ( adFormat != CLXAdFormatInterstitial && adFormat != CLXAdFormatAppOpen && adFormat != CLXAdFormatRewarded ) return;
 
         NSString *name;
         if ( adFormat == CLXAdFormatInterstitial )
         {
             name = ON_INTERSTITIAL_HIDDEN_EVENT;
         }
+        else if ( adFormat == CLXAdFormatAppOpen )
+        {
+            name = ON_APPOPEN_HIDDEN_EVENT;
+        }
         else
         {
             name = ON_REWARDED_AD_HIDDEN_EVENT;
@@ -746,6 +859,10 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
         {
             name = ON_INTERSTITIAL_AD_REVENUE_PAID;
         }
+        else if ( adFormat == CLXAdFormatAppOpen )
+        {
+            name = ON_APPOPEN_AD_REVENUE_PAID;
+        }
         else if ( adFormat == CLXAdFormatRewarded )
         {
             name = ON_REWARDED_AD_REVENUE_PAID;
@@ -876,7 +993,9 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
         CLXBannerAdView *adView = [self retrieveAdViewForAdUnitIdentifier: adUnitIdentifier adFormat: adFormat];
         if ( adView )
         {
-            [self applyExtraParameters: extraParameters toAdView: adView];
+            [CloudXExtraParameters applyExtraParameters: extraParameters toAdView: adView logBlock:^(NSString *message) {
+                [self log: @"%@", message];
+            }];
             return;
         }
 
@@ -887,17 +1006,7 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
             self.adViewExtraParameters[adUnitIdentifier] = pending;
         }
 
-        [extraParameters enumerateKeysAndObjectsUsingBlock:^(NSString *key, id value, BOOL *stop) {
-            if ( !key || key.length == 0 ) return;
-            if ( !value || [value isKindOfClass: [NSNull class]] )
-            {
-                [pending removeObjectForKey: key];
-            }
-            else
-            {
-                pending[key] = value;
-            }
-        }];
+        [CloudXExtraParameters mergeExtraParameters: extraParameters intoPendingDictionary: pending];
     }];
 }
 
@@ -905,49 +1014,8 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
 {
     NSDictionary<NSString *, id> *pending = [self.adViewExtraParameters[adUnitIdentifier] copy];
     if ( pending.count == 0 ) return;
-    [self applyExtraParameters: pending toAdView: adView];
-}
-
-- (void)applyExtraParameterValue:(id)value forKey:(NSString *)key toTarget:(id)target
-{
-    if ( !target || !key || key.length == 0 ) return;
-
-    SEL selector = NSSelectorFromString(@"setExtraParameter:value:");
-    if ( ![target respondsToSelector: selector] )
-    {
-        selector = NSSelectorFromString(@"setExtraParameterForKey:value:");
-    }
-
-    if ( ![target respondsToSelector: selector] )
-    {
-        [self log: @"Skipping extra parameter \"%@\" because %@ does not respond to setExtraParameter:value: or setExtraParameterForKey:value:", key, NSStringFromClass([target class])];
-        return;
-    }
-
-    using SetExtraParameterMethod = void (*)(id, SEL, NSString *, id);
-    SetExtraParameterMethod method = (SetExtraParameterMethod)[target methodForSelector: selector];
-    method(target, selector, key, value);
-
-    [self log: @"Applied extra parameter \"%@\" with value \"%@\" to %@", key, value ?: @"(cleared)", NSStringFromClass([target class])];
-}
-
-- (void)applyExtraParameters:(NSDictionary<NSString *, id> *)extraParameters toAdView:(CLXBannerAdView *)adView
-{
-    [extraParameters enumerateKeysAndObjectsUsingBlock:^(NSString *key, id value, BOOL *stop) {
-        if ( !key || key.length == 0 ) return;
-        id normalizedValue = [value isKindOfClass: [NSNull class]] ? nil : value;
-        SEL selector = NSSelectorFromString(@"setExtraParameter:value:");
-        id target = [adView respondsToSelector: selector] ? adView : adView.ad;
-        [self applyExtraParameterValue: normalizedValue forKey: key toTarget: target];
-    }];
-}
-
-- (void)applyExtraParameters:(NSDictionary<NSString *, id> *)extraParameters toFullscreenAd:(id<CLXFullscreenAd>)ad
-{
-    [extraParameters enumerateKeysAndObjectsUsingBlock:^(NSString *key, id value, BOOL *stop) {
-        if ( !key || key.length == 0 ) return;
-        id normalizedValue = [value isKindOfClass: [NSNull class]] ? nil : value;
-        [self applyExtraParameterValue: normalizedValue forKey: key toTarget: ad];
+    [CloudXExtraParameters applyExtraParameters: pending toAdView: adView logBlock:^(NSString *message) {
+        [self log: @"%@", message];
     }];
 }
 
@@ -1152,6 +1220,21 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
     return result;
 }
 
+- (CLXAppOpen *)retrieveAppOpenForAdUnitIdentifier:(NSString *)adUnitIdentifier
+{
+    CLXAppOpen *result = self.appOpenAds[adUnitIdentifier];
+    if ( !result )
+    {
+        result = [[CloudXCore shared] createAppOpenWithAdUnitId: adUnitIdentifier];
+        result.delegate        = self;
+        result.revenueDelegate = self;
+
+        self.appOpenAds[adUnitIdentifier] = result;
+    }
+
+    return result;
+}
+
 - (CLXRewarded *)retrieveRewardedAdForAdUnitIdentifier:(NSString *)adUnitIdentifier
 {
     CLXRewarded *result = self.rewardedAds[adUnitIdentifier];
@@ -1501,6 +1584,107 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
     return vc;
 }
 
+- (nullable CLXRevenueData *)revenueDataFromDictionary:(NSDictionary<NSString *, id> *)dictionary
+{
+    if ( ![dictionary isKindOfClass: [NSDictionary class]] )
+    {
+        [self log: @"reportRevenueData: ignoring data with missing or invalid required fields"];
+        return nil;
+    }
+
+    NSString *platform = [self stringValueFromDictionary: dictionary key: @"platform"];
+    NSNumber *revenueNumber = [self revenueNumberValueFromDictionary: dictionary key: @"revenue"];
+    NSString *adFormat = [self stringValueFromDictionary: dictionary key: @"adFormat"];
+    CLXRevenuePlatform revenuePlatform = [self revenuePlatformFromString: platform];
+    if ( !revenuePlatform || !revenueNumber || [self isBlankString: adFormat] )
+    {
+        [self log: @"reportRevenueData: ignoring data with missing or invalid required fields"];
+        return nil;
+    }
+
+    double revenue = revenueNumber.doubleValue;
+    if ( !isfinite(revenue) )
+    {
+        [self log: @"reportRevenueData: ignoring data with non-finite revenue=%@", revenueNumber];
+        return nil;
+    }
+
+    return [CLXRevenueData revenueDataWithPlatform: revenuePlatform
+                                           revenue: revenue
+                                          adFormat: adFormat
+                                      builderBlock:^(CLXRevenueDataBuilder *builder) {
+        builder.currencyCode = [self nonBlankStringValueFromDictionary: dictionary key: @"currencyCode"];
+        builder.precision = [self revenuePrecisionFromString: [self stringValueFromDictionary: dictionary key: @"precision"]];
+        builder.networkName = [self nonBlankStringValueFromDictionary: dictionary key: @"networkName"];
+        builder.adUnitId = [self nonBlankStringValueFromDictionary: dictionary key: @"adUnitId"];
+        builder.thirdPartyAdPlacementId = [self nonBlankStringValueFromDictionary: dictionary key: @"thirdPartyAdPlacementId"];
+        builder.creativeId = [self nonBlankStringValueFromDictionary: dictionary key: @"creativeId"];
+        builder.networkPlacement = [self nonBlankStringValueFromDictionary: dictionary key: @"networkPlacement"];
+        builder.countryCode = [self nonBlankStringValueFromDictionary: dictionary key: @"countryCode"];
+        builder.userSegment = [self nonBlankStringValueFromDictionary: dictionary key: @"userSegment"];
+    }];
+}
+
+- (nullable CLXRevenuePlatform)revenuePlatformFromString:(nullable NSString *)platform
+{
+    if ( !platform )
+    {
+        return nil;
+    }
+
+    NSString *trimmedPlatform = [platform stringByTrimmingCharactersInSet: [NSCharacterSet whitespaceAndNewlineCharacterSet]];
+    if ( trimmedPlatform.length == 0 )
+    {
+        return nil;
+    }
+
+    if ( [trimmedPlatform caseInsensitiveCompare: CLXRevenuePlatformAdMob] == NSOrderedSame )
+    {
+        return CLXRevenuePlatformAdMob;
+    }
+
+    if ( [trimmedPlatform caseInsensitiveCompare: CLXRevenuePlatformInMobi] == NSOrderedSame )
+    {
+        return CLXRevenuePlatformInMobi;
+    }
+
+    return CLXRevenuePlatformCustom(trimmedPlatform);
+}
+
+- (nullable NSString *)nonBlankStringValueFromDictionary:(NSDictionary<NSString *, id> *)dictionary key:(NSString *)key
+{
+    NSString *value = [self stringValueFromDictionary: dictionary key: key];
+    return [self isBlankString: value] ? nil : value;
+}
+
+- (nullable NSNumber *)revenueNumberValueFromDictionary:(NSDictionary<NSString *, id> *)dictionary key:(NSString *)key
+{
+    id value = dictionary[key];
+    if ( ![value isKindOfClass: [NSNumber class]] ) return nil;
+    if ( CFGetTypeID((__bridge CFTypeRef)value) == CFBooleanGetTypeID() ) return nil;
+    return value;
+}
+
+- (BOOL)isBlankString:(nullable NSString *)value
+{
+    if ( ![value isKindOfClass: [NSString class]] ) return YES;
+    return [value stringByTrimmingCharactersInSet: [NSCharacterSet whitespaceAndNewlineCharacterSet]].length == 0;
+}
+
+- (nullable CLXRevenuePrecision *)revenuePrecisionFromString:(nullable NSString *)value
+{
+    if ( !value ) return nil;
+
+    NSString *lower = [value lowercaseString];
+    if ( [lower isEqualToString: @"exact"] ) return CLXRevenuePrecision.exact;
+    if ( [lower isEqualToString: @"estimated"] ) return CLXRevenuePrecision.estimated;
+    if ( [lower isEqualToString: @"publisher_defined"] ) return CLXRevenuePrecision.publisherDefined;
+    if ( [lower isEqualToString: @"undefined"] ) return CLXRevenuePrecision.undefined;
+
+    [self log: @"reportRevenueData: ignoring unknown precision=%@", value];
+    return nil;
+}
+
 - (CLXLogLevel)logLevelFromString:(NSString *)level
 {
     NSString *lower = [level lowercaseString];
@@ -1735,6 +1919,11 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
         *result = CLXAdFormatInterstitial;
         return YES;
     }
+    if ( [upper isEqualToString: @"APP_OPEN"] )
+    {
+        *result = CLXAdFormatAppOpen;
+        return YES;
+    }
     if ( [upper isEqualToString: @"REWARDED"] )
     {
         *result = CLXAdFormatRewarded;
@@ -1755,6 +1944,7 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
         case CLXAdFormatBanner:       return @"BANNER";
         case CLXAdFormatMREC:         return @"MREC";
         case CLXAdFormatInterstitial: return @"INTERSTITIAL";
+        case CLXAdFormatAppOpen:      return @"APP_OPEN";
         case CLXAdFormatRewarded:     return @"REWARDED";
         default:                      return @"";
     }
@@ -1791,6 +1981,14 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
              ON_INTERSTITIAL_HIDDEN_EVENT,
              ON_INTERSTITIAL_AD_REVENUE_PAID,
 
+             ON_APPOPEN_LOADED_EVENT,
+             ON_APPOPEN_LOAD_FAILED_EVENT,
+             ON_APPOPEN_CLICKED_EVENT,
+             ON_APPOPEN_DISPLAYED_EVENT,
+             ON_APPOPEN_DISPLAY_FAILED_EVENT,
+             ON_APPOPEN_HIDDEN_EVENT,
+             ON_APPOPEN_AD_REVENUE_PAID,
+
              ON_REWARDED_AD_LOADED_EVENT,
              ON_REWARDED_AD_LOAD_FAILED_EVENT,
              ON_REWARDED_AD_CLICKED_EVENT,
@@ -1825,6 +2023,14 @@ RCT_EXPORT_METHOD(destroyRewarded:(NSString *)adUnitIdentifier)
              @"ON_INTERSTITIAL_HIDDEN_EVENT":          ON_INTERSTITIAL_HIDDEN_EVENT,
              @"ON_INTERSTITIAL_AD_REVENUE_PAID":       ON_INTERSTITIAL_AD_REVENUE_PAID,
 
+             @"ON_APPOPEN_LOADED_EVENT":              ON_APPOPEN_LOADED_EVENT,
+             @"ON_APPOPEN_LOAD_FAILED_EVENT":         ON_APPOPEN_LOAD_FAILED_EVENT,
+             @"ON_APPOPEN_CLICKED_EVENT":              ON_APPOPEN_CLICKED_EVENT,
+             @"ON_APPOPEN_DISPLAYED_EVENT":            ON_APPOPEN_DISPLAYED_EVENT,
+             @"ON_APPOPEN_DISPLAY_FAILED_EVENT":       ON_APPOPEN_DISPLAY_FAILED_EVENT,
+             @"ON_APPOPEN_HIDDEN_EVENT":               ON_APPOPEN_HIDDEN_EVENT,
+             @"ON_APPOPEN_AD_REVENUE_PAID":            ON_APPOPEN_AD_REVENUE_PAID,
+
              @"ON_REWARDED_AD_LOADED_EVENT":          ON_REWARDED_AD_LOADED_EVENT,
              @"ON_REWARDED_AD_LOAD_FAILED_EVENT":     ON_REWARDED_AD_LOAD_FAILED_EVENT,
              @"ON_REWARDED_AD_CLICKED_EVENT":          ON_REWARDED_AD_CLICKED_EVENT,

package/ios/CloudXAdView.h

@@ -0,0 +1,33 @@
+//
+//  CloudXAdView.h
+//  cloudx-react-native
+//
+//  In-tree banner/MREC view component. Unlike the imperative overlay banner in
+//  CloudX.mm (attached above the whole RN view tree), this hosts a
+//  CLXBannerAdView as an ordinary RN view so app overlays layer above it.
+//
+
+#import <React/RCTUIManager.h>
+#import <CloudXCore/CloudXCore.h>
+
+#ifdef RCT_NEW_ARCH_ENABLED
+#import <React/RCTViewComponentView.h>
+@interface CloudXAdView : RCTViewComponentView <CLXBannerDelegate, CLXAdRevenueDelegate>
+#else
+@interface CloudXAdView : UIView <CLXBannerDelegate, CLXAdRevenueDelegate>
+#endif
+
+NS_ASSUME_NONNULL_BEGIN
+
+// Nil by default on the Old Architecture (only set when the publisher passes
+// the corresponding callback); delegate call sites guard with `if (self.onX)`.
+@property (nonatomic, copy, nullable) RCTDirectEventBlock onAdLoadedEvent;
+@property (nonatomic, copy, nullable) RCTDirectEventBlock onAdLoadFailedEvent;
+@property (nonatomic, copy, nullable) RCTDirectEventBlock onAdClickedEvent;
+@property (nonatomic, copy, nullable) RCTDirectEventBlock onAdRevenuePaidEvent;
+
+- (void)setExtraParametersFromEntryArray:(nullable NSArray<NSDictionary<NSString *, id> *> *)extraParameters;
+
+@end
+
+NS_ASSUME_NONNULL_END