react-native-applovin-max 4.1.6 → 5.0.0

package/ios/AppLovinMAX.m

@@ -44,10 +44,6 @@
 @property (nonatomic, strong, nullable) NSNumber *locationCollectionEnabledToSet;
 @property (nonatomic, strong) NSMutableDictionary<NSString *, NSString *> *extraParametersToSet;
 
-@property (nonatomic, strong, nullable) NSNumber *consentFlowEnabledToSet;
-@property (nonatomic, strong, nullable) NSURL *privacyPolicyURLToSet;
-@property (nonatomic, strong, nullable) NSURL *termsOfServiceURLToSet;
-
 @property (nonatomic, strong, nullable) NSNumber *targetingYearOfBirthToSet;
 @property (nonatomic,   copy, nullable) NSString *targetingGenderToSet;
 @property (nonatomic, strong, nullable) NSNumber *targetingMaximumAdContentRatingToSet;
@@ -82,6 +78,55 @@
 static NSString *const SDK_TAG = @"AppLovinSdk";
 static NSString *const TAG = @"AppLovinMAX";
 
+static NSString *const ON_BANNER_AD_LOADED_EVENT = @"OnBannerAdLoadedEvent";
+static NSString *const ON_BANNER_AD_LOAD_FAILED_EVENT = @"OnBannerAdLoadFailedEvent";
+static NSString *const ON_BANNER_AD_CLICKED_EVENT = @"OnBannerAdClickedEvent";
+static NSString *const ON_BANNER_AD_COLLAPSED_EVENT = @"OnBannerAdCollapsedEvent";
+static NSString *const ON_BANNER_AD_EXPANDED_EVENT = @"OnBannerAdExpandedEvent";
+static NSString *const ON_BANNER_AD_REVENUE_PAID = @"OnBannerAdRevenuePaid";
+
+static NSString *const ON_MREC_AD_LOADED_EVENT = @"OnMRecAdLoadedEvent";
+static NSString *const ON_MREC_AD_LOAD_FAILED_EVENT = @"OnMRecAdLoadFailedEvent";
+static NSString *const ON_MREC_AD_CLICKED_EVENT= @"OnMRecAdClickedEvent";
+static NSString *const ON_MREC_AD_COLLAPSED_EVENT = @"OnMRecAdCollapsedEvent";
+static NSString *const ON_MREC_AD_EXPANDED_EVENT = @"OnMRecAdExpandedEvent";
+static NSString *const ON_MREC_AD_REVENUE_PAID = @"OnMRecAdRevenuePaid";
+
+static NSString *const ON_INTERSTITIAL_LOADED_EVENT = @"OnInterstitialLoadedEvent";
+static NSString *const ON_INTERSTITIAL_LOAD_FAILED_EVENT = @"OnInterstitialLoadFailedEvent";
+static NSString *const ON_INTERSTITIAL_CLICKED_EVENT = @"OnInterstitialClickedEvent";
+static NSString *const ON_INTERSTITIAL_DISPLAYED_EVENT = @"OnInterstitialDisplayedEvent";
+static NSString *const ON_INTERSTITIAL_AD_FAILED_TO_DISPLAY_EVENT = @"OnInterstitialAdFailedToDisplayEvent";
+static NSString *const ON_INTERSTITIAL_HIDDEN_EVENT = @"OnInterstitialHiddenEvent";
+static NSString *const ON_INTERSTITIAL_AD_REVENUE_PAID = @"OnInterstitialAdRevenuePaid";
+
+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";
+static NSString *const ON_REWARDED_AD_DISPLAYED_EVENT = @"OnRewardedAdDisplayedEvent";
+static NSString *const ON_REWARDED_AD_FAILED_TO_DISPLAY_EVENT = @"OnRewardedAdFailedToDisplayEvent";
+static NSString *const ON_REWARDED_AD_HIDDEN_EVENT = @"OnRewardedAdHiddenEvent";
+static NSString *const ON_REWARDED_AD_RECEIVED_REWARD_EVENT = @"OnRewardedAdReceivedRewardEvent";
+static NSString *const ON_REWARDED_AD_REVENUE_PAID = @"OnRewardedAdRevenuePaid";
+
+static NSString *const ON_APPOPEN_AD_LOADED_EVENT = @"OnAppOpenAdLoadedEvent";
+static NSString *const ON_APPOPEN_AD_LOAD_FAILED_EVENT = @"OnAppOpenAdLoadFailedEvent";
+static NSString *const ON_APPOPEN_AD_CLICKED_EVENT = @"OnAppOpenAdClickedEvent";
+static NSString *const ON_APPOPEN_AD_DISPLAYED_EVENT = @"OnAppOpenAdDisplayedEvent";
+static NSString *const ON_APPOPEN_AD_FAILED_TO_DISPLAY_EVENT = @"OnAppOpenAdFailedToDisplayEvent";
+static NSString *const ON_APPOPEN_AD_HIDDEN_EVENT = @"OnAppOpenAdHiddenEvent";
+static NSString *const ON_APPOPEN_AD_REVENUE_PAID = @"OnAppOpenAdRevenuePaid";
+
+static NSString *const TOP_CENTER = @"top_center";
+static NSString *const TOP_LEFT = @"top_left";
+static NSString *const TOP_RIGHT = @"top_right";
+static NSString *const CENTERED = @"centered";
+static NSString *const CENTER_LEFT = @"center_left";
+static NSString *const CENTER_RIGHT = @"center_right";
+static NSString *const BOTTOM_LEFT = @"bottom_left";
+static NSString *const BOTTOM_CENTER = @"bottom_center";
+static NSString *const BOTTOM_RIGHT = @"bottom_right";
+
 static AppLovinMAX *AppLovinMAXShared; // Shared instance of this bridge module.
 
 // To export a module named AppLovinMAX ("RCT" automatically removed)
@@ -134,12 +179,12 @@ RCT_EXPORT_MODULE()
     return self;
 }
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isInitialized)
+RCT_EXPORT_METHOD(isInitialized:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
-    return @([self isPluginInitialized] && [self isSDKInitialized]);
+    resolve(@([self isPluginInitialized] && [self isSDKInitialized]));
 }
 
-RCT_EXPORT_METHOD(initialize:(NSString *)pluginVersion :(NSString *)sdkKey :(RCTResponseSenderBlock)callback)
+RCT_EXPORT_METHOD(initialize:(NSString *)pluginVersion :(NSString *)sdkKey :(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
     // Guard against running init logic multiple times
     if ( [self isPluginInitialized] ) return;
@@ -157,22 +202,13 @@ RCT_EXPORT_METHOD(initialize:(NSString *)pluginVersion :(NSString *)sdkKey :(RCT
         }
         else
         {
-            [NSException raise: NSInternalInconsistencyException
-                        format: @"Unable to initialize AppLovin SDK - no SDK key provided and not found in Info.plist!"];
+            reject(RCTErrorUnspecified, @"Unable to initialize AppLovin SDK - no SDK key provided and not found in Info.plist!", nil);
+            return;
         }
     }
     
-    ALSdkSettings *settings = [[ALSdkSettings alloc] init];
-    settings.consentFlowSettings.enabled = self.consentFlowEnabledToSet.boolValue;
-    settings.consentFlowSettings.privacyPolicyURL = self.privacyPolicyURLToSet;
-    settings.consentFlowSettings.termsOfServiceURL = self.termsOfServiceURLToSet;
-    
-    self.consentFlowEnabledToSet = nil;
-    self.privacyPolicyURLToSet = nil;
-    self.termsOfServiceURLToSet = nil;
-    
     // Initialize SDK
-    self.sdk = [ALSdk sharedWithKey: sdkKey settings: settings];
+    self.sdk = [ALSdk sharedWithKey: sdkKey];
     [self.sdk setPluginVersion: [@"React-Native-" stringByAppendingString: pluginVersion]];
     [self.sdk setMediationProvider: ALMediationProviderMAX];
     
@@ -262,16 +298,15 @@ RCT_EXPORT_METHOD(initialize:(NSString *)pluginVersion :(NSString *)sdkKey :(RCT
         self.sdkConfiguration = configuration;
         self.sdkInitialized = YES;
         
-        callback(@[@{@"consentDialogState" : @(configuration.consentDialogState),
-                     @"countryCode" : self.sdk.configuration.countryCode}]);
+        resolve(@{@"countryCode" : self.sdk.configuration.countryCode});
     }];
 }
 
 #pragma mark - General Public API
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isTablet)
+RCT_EXPORT_METHOD(isTablet:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
-    return @([UIDevice currentDevice].userInterfaceIdiom == UIUserInterfaceIdiomPad);
+    resolve(@([UIDevice currentDevice].userInterfaceIdiom == UIUserInterfaceIdiomPad));
 }
 
 RCT_EXPORT_METHOD(showMediationDebugger)
@@ -285,28 +320,14 @@ RCT_EXPORT_METHOD(showMediationDebugger)
     [self.sdk showMediationDebugger];
 }
 
-RCT_EXPORT_METHOD(showConsentDialog:(RCTResponseSenderBlock)callback)
-{
-    [self log: @"Failed to show consent dialog - Unavailable on iOS, please use the consent flow: https://dash.applovin.com/documentation/mediation/react-native/getting-started/consent-flow"];
-    
-    callback(nil);
-}
-
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getConsentDialogState)
-{
-    if ( ![self isInitialized] ) return @(ALConsentDialogStateUnknown);
-    
-    return @(self.sdkConfiguration.consentDialogState);
-}
-
 RCT_EXPORT_METHOD(setHasUserConsent:(BOOL)hasUserConsent)
 {
     [ALPrivacySettings setHasUserConsent: hasUserConsent];
 }
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(hasUserConsent)
+RCT_EXPORT_METHOD(hasUserConsent:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
-    return @([ALPrivacySettings hasUserConsent]);
+    resolve(@([ALPrivacySettings hasUserConsent]));
 }
 
 RCT_EXPORT_METHOD(setIsAgeRestrictedUser:(BOOL)isAgeRestrictedUser)
@@ -314,9 +335,9 @@ RCT_EXPORT_METHOD(setIsAgeRestrictedUser:(BOOL)isAgeRestrictedUser)
     [ALPrivacySettings setIsAgeRestrictedUser: isAgeRestrictedUser];
 }
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isAgeRestrictedUser)
+RCT_EXPORT_METHOD(isAgeRestrictedUser:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
-    return @([ALPrivacySettings isAgeRestrictedUser]);
+    resolve(@([ALPrivacySettings isAgeRestrictedUser]));
 }
 
 RCT_EXPORT_METHOD(setDoNotSell:(BOOL)doNotSell)
@@ -324,9 +345,9 @@ RCT_EXPORT_METHOD(setDoNotSell:(BOOL)doNotSell)
     [ALPrivacySettings setDoNotSell: doNotSell];
 }
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isDoNotSell)
+RCT_EXPORT_METHOD(isDoNotSell:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
-    return @([ALPrivacySettings isDoNotSell]);
+    resolve(@([ALPrivacySettings isDoNotSell]));
 }
 
 RCT_EXPORT_METHOD(setUserId:(NSString *)userId)
@@ -349,11 +370,9 @@ RCT_EXPORT_METHOD(setMuted:(BOOL)muted)
     self.sdk.settings.muted = muted;
 }
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isMuted)
+RCT_EXPORT_METHOD(isMuted:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
-    if ( ![self isPluginInitialized] ) return @(NO);
-    
-    return @(self.sdk.settings.muted);
+    resolve([self isPluginInitialized] ? @(self.sdk.settings.muted) : @(NO) );
 }
 
 RCT_EXPORT_METHOD(setVerboseLogging:(BOOL)enabled)
@@ -415,21 +434,6 @@ RCT_EXPORT_METHOD(setExtraParameter:(NSString *)key :(nullable NSString *)value)
     }
 }
 
-RCT_EXPORT_METHOD(setConsentFlowEnabled:(BOOL)enabled)
-{
-    self.consentFlowEnabledToSet = @(enabled);
-}
-
-RCT_EXPORT_METHOD(setPrivacyPolicyUrl:(NSString *)urlString)
-{
-    self.privacyPolicyURLToSet = [NSURL URLWithString: urlString];
-}
-
-RCT_EXPORT_METHOD(setTermsOfServiceUrl:(NSString *)urlString)
-{
-    self.termsOfServiceURLToSet = [NSURL URLWithString: urlString];
-}
-
 #pragma mark - Data Passing
 
 RCT_EXPORT_METHOD(setTargetingDataYearOfBirth:(nonnull NSNumber *)yearOfBirth)
@@ -443,6 +447,17 @@ RCT_EXPORT_METHOD(setTargetingDataYearOfBirth:(nonnull NSNumber *)yearOfBirth)
     self.sdk.targetingData.yearOfBirth = yearOfBirth.intValue <= 0 ? nil : yearOfBirth;
 }
 
+RCT_EXPORT_METHOD(getTargetingDataYearOfBirth:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
+{
+    if ( !self.sdk )
+    {
+        resolve(self.targetingYearOfBirthToSet ? self.targetingYearOfBirthToSet : @0);
+        return;
+    }
+    
+    resolve(self.sdk.targetingData.yearOfBirth ? self.sdk.targetingData.yearOfBirth : @0);
+}
+
 RCT_EXPORT_METHOD(setTargetingDataGender:(nullable NSString *)gender)
 {
     if ( !self.sdk )
@@ -454,6 +469,17 @@ RCT_EXPORT_METHOD(setTargetingDataGender:(nullable NSString *)gender)
     self.sdk.targetingData.gender = [self toAppLovinGender: gender];
 }
 
+RCT_EXPORT_METHOD(getTargetingDataGender:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
+{
+    if ( !self.sdk )
+    {
+        resolve(self.targetingGenderToSet ? self.targetingGenderToSet : @"U");
+        return;
+    }
+    
+    resolve([self fromAppLovinGender: self.sdk.targetingData.gender]);
+}
+
 RCT_EXPORT_METHOD(setTargetingDataMaximumAdContentRating:(nonnull NSNumber *)maximumAdContentRating)
 {
     if ( !self.sdk )
@@ -465,6 +491,17 @@ RCT_EXPORT_METHOD(setTargetingDataMaximumAdContentRating:(nonnull NSNumber *)max
     self.sdk.targetingData.maximumAdContentRating = [self toAppLovinAdContentRating: maximumAdContentRating];
 }
 
+RCT_EXPORT_METHOD(getTargetingDataMaximumAdContentRating:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
+{
+    if ( !self.sdk )
+    {
+        resolve(self.targetingMaximumAdContentRatingToSet ? self.targetingMaximumAdContentRatingToSet : @0);
+        return;
+    }
+    
+    resolve(@(self.sdk.targetingData.maximumAdContentRating));
+}
+
 RCT_EXPORT_METHOD(setTargetingDataEmail:(nullable NSString *)email)
 {
     if ( !self.sdk )
@@ -476,6 +513,17 @@ RCT_EXPORT_METHOD(setTargetingDataEmail:(nullable NSString *)email)
     self.sdk.targetingData.email = email;
 }
 
+RCT_EXPORT_METHOD(getTargetingDataEmail:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
+{
+    if ( !self.sdk )
+    {
+        resolve(self.targetingEmailToSet);
+        return;
+    }
+    
+    resolve(self.sdk.targetingData.email);
+}
+
 RCT_EXPORT_METHOD(setTargetingDataPhoneNumber:(nullable NSString *)phoneNumber)
 {
     if ( !self.sdk )
@@ -487,6 +535,17 @@ RCT_EXPORT_METHOD(setTargetingDataPhoneNumber:(nullable NSString *)phoneNumber)
     self.sdk.targetingData.phoneNumber = phoneNumber;
 }
 
+RCT_EXPORT_METHOD(getTargetingDataPhoneNumber:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
+{
+    if ( !self.sdk )
+    {
+        resolve(self.targetingPhoneNumberToSet);
+        return;
+    }
+    
+    resolve(self.sdk.targetingData.phoneNumber);
+}
+
 RCT_EXPORT_METHOD(setTargetingDataKeywords:(nullable NSArray<NSString *> *)keywords)
 {
     if ( !self.sdk )
@@ -498,6 +557,17 @@ RCT_EXPORT_METHOD(setTargetingDataKeywords:(nullable NSArray<NSString *> *)keywo
     self.sdk.targetingData.keywords = keywords;
 }
 
+RCT_EXPORT_METHOD(getTargetingDataKeywords:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
+{
+    if ( !self.sdk )
+    {
+        resolve(self.targetingKeywordsToSet);
+        return;
+    }
+    
+    resolve(self.sdk.targetingData.keywords);
+}
+
 RCT_EXPORT_METHOD(setTargetingDataInterests:(nullable NSArray<NSString *> *)interests)
 {
     if ( !self.sdk )
@@ -509,6 +579,17 @@ RCT_EXPORT_METHOD(setTargetingDataInterests:(nullable NSArray<NSString *> *)inte
     self.sdk.targetingData.interests = interests;
 }
 
+RCT_EXPORT_METHOD(getTargetingDataInterests:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
+{
+    if ( !self.sdk )
+    {
+        resolve(self.targetingInterestsToSet);
+        return;
+    }
+    
+    resolve(self.sdk.targetingData.interests);
+}
+
 RCT_EXPORT_METHOD(clearAllTargetingData)
 {
     if ( !self.sdk )
@@ -550,124 +631,277 @@ RCT_EXPORT_METHOD(trackEvent:(NSString *)event :(NSDictionary<NSString *, id> *)
 
 RCT_EXPORT_METHOD(createBanner:(NSString *)adUnitIdentifier :(NSString *)bannerPosition)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"createBanner"];
+        return;
+    }
+
     [self createAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT atPosition: bannerPosition withOffset: CGPointZero];
 }
 
 // NOTE: No function overloading in JS so we need new method signature
 RCT_EXPORT_METHOD(createBannerWithOffsets:(NSString *)adUnitIdentifier :(NSString *)bannerPosition :(CGFloat)xOffset :(CGFloat)yOffset)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"createBannerWithOffsets"];
+        return;
+    }
+
     [self createAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT atPosition: bannerPosition withOffset: CGPointMake(xOffset, yOffset)];
 }
 
 RCT_EXPORT_METHOD(setBannerBackgroundColor:(NSString *)adUnitIdentifier :(NSString *)hexColorCode)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setBannerBackgroundColor"];
+        return;
+    }
+
     [self setAdViewBackgroundColorForAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT hexColorCode: hexColorCode];
 }
 
 RCT_EXPORT_METHOD(setBannerPlacement:(NSString *)adUnitIdentifier :(nullable NSString *)placement)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setBannerPlacement"];
+        return;
+    }
+
     [self setAdViewPlacement: placement forAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
 RCT_EXPORT_METHOD(setBannerCustomData:(NSString *)adUnitIdentifier :(nullable NSString *)customData)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setBannerCustomData"];
+        return;
+    }
+
     [self setAdViewCustomData: customData forAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
 RCT_EXPORT_METHOD(updateBannerPosition:(NSString *)adUnitIdentifier :(NSString *)bannerPosition)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"updateBannerPosition"];
+        return;
+    }
+
     [self updateAdViewPosition: bannerPosition withOffset: CGPointZero forAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
 RCT_EXPORT_METHOD(updateBannerOffsets:(NSString *)adUnitIdentifier :(CGFloat)xOffset :(CGFloat)yOffset)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"updateBannerOffsets"];
+        return;
+    }
+
     [self updateAdViewPosition: self.adViewPositions[adUnitIdentifier] withOffset: CGPointMake(xOffset, yOffset) forAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
 RCT_EXPORT_METHOD(setBannerWidth:(NSString *)adUnitIdentifier :(CGFloat)width)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setBannerWidth"];
+        return;
+    }
+
     [self setAdViewWidth: width forAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
 RCT_EXPORT_METHOD(setBannerExtraParameter:(NSString *)adUnitIdentifier :(NSString *)key :(nullable NSString *)value)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setBannerExtraParameter"];
+        return;
+    }
+
     [self setAdViewExtraParameterForAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT key: key value: value];
 }
 
+RCT_EXPORT_METHOD(setBannerLocalExtraParameter:(NSString *)adUnitIdentifier :(NSString *)key :(nullable NSString *)value)
+{
+    [self setAdViewLocalExtraParameterForAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT key: key value: value];
+}
+
 RCT_EXPORT_METHOD(startBannerAutoRefresh:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"startBannerAutoRefresh"];
+        return;
+    }
+
     [self startAutoRefresh: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
 RCT_EXPORT_METHOD(stopBannerAutoRefresh:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"stopBannerAutoRefresh"];
+        return;
+    }
+
     [self stopAutoRefresh: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
 RCT_EXPORT_METHOD(showBanner:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"showBanner"];
+        return;
+    }
+
     [self showAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
 RCT_EXPORT_METHOD(hideBanner:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"hideBanner"];
+        return;
+    }
+
     [self hideAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
 RCT_EXPORT_METHOD(destroyBanner:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"destroyBanner"];
+        return;
+    }
+
     [self destroyAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
 }
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getAdaptiveBannerHeightForWidth:(CGFloat)width)
+RCT_EXPORT_METHOD(getAdaptiveBannerHeightForWidth:(CGFloat)width :(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
-    return @([DEVICE_SPECIFIC_ADVIEW_AD_FORMAT adaptiveSizeForWidth: width].height);
+    resolve(@([DEVICE_SPECIFIC_ADVIEW_AD_FORMAT adaptiveSizeForWidth: width].height));
 }
 
 #pragma mark - MRECs
 
 RCT_EXPORT_METHOD(createMRec:(NSString *)adUnitIdentifier :(NSString *)mrecPosition)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"createMRec"];
+        return;
+    }
+
     [self createAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec atPosition: mrecPosition withOffset: CGPointZero];
 }
 
 RCT_EXPORT_METHOD(setMRecPlacement:(NSString *)adUnitIdentifier :(nullable NSString *)placement)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setMRecPlacement"];
+        return;
+    }
+
     [self setAdViewPlacement: placement forAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec];
 }
 
 RCT_EXPORT_METHOD(setMRecCustomData:(NSString *)adUnitIdentifier :(nullable NSString *)customData)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setMRecCustomData"];
+        return;
+    }
+
     [self setAdViewCustomData: customData forAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec];
 }
 
 RCT_EXPORT_METHOD(updateMRecPosition:(NSString *)mrecPosition :(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"updateMRecPosition"];
+        return;
+    }
+
     [self updateAdViewPosition: mrecPosition withOffset: CGPointZero forAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec];
 }
 
+RCT_EXPORT_METHOD(setMRecExtraParameter:(NSString *)adUnitIdentifier :(NSString *)key :(nullable NSString *)value)
+{
+    [self setAdViewExtraParameterForAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec key: key value: value];
+}
+
+RCT_EXPORT_METHOD(setMRecLocalExtraParameter:(NSString *)adUnitIdentifier :(NSString *)key :(nullable NSString *)value)
+{
+    [self setAdViewLocalExtraParameterForAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec key: key value: value];
+}
+
 RCT_EXPORT_METHOD(startMRecAutoRefresh:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"startMRecAutoRefresh"];
+        return;
+    }
+
     [self startAutoRefresh: adUnitIdentifier adFormat: MAAdFormat.mrec];
 }
 
 RCT_EXPORT_METHOD(stopMRecAutoRefresh:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"stopMRecAutoRefresh"];
+        return;
+    }
+
     [self stopAutoRefresh: adUnitIdentifier adFormat: MAAdFormat.mrec];
 }
 
 RCT_EXPORT_METHOD(showMRec:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"showMRec"];
+        return;
+    }
+
     [self showAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec];
 }
 
 RCT_EXPORT_METHOD(hideMRec:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"hideMRec"];
+        return;
+    }
+
     [self hideAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec];
 }
 
 RCT_EXPORT_METHOD(destroyMRec:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"destroyMRec"];
+        return;
+    }
+
     [self destroyAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec];
 }
 
@@ -675,80 +909,173 @@ RCT_EXPORT_METHOD(destroyMRec:(NSString *)adUnitIdentifier)
 
 RCT_EXPORT_METHOD(loadInterstitial:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"loadInterstitial"];
+        return;
+    }
+
     MAInterstitialAd *interstitial = [self retrieveInterstitialForAdUnitIdentifier: adUnitIdentifier];
     [interstitial loadAd];
 }
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isInterstitialReady:(NSString *)adUnitIdentifier)
+RCT_EXPORT_METHOD(isInterstitialReady:(NSString *)adUnitIdentifier :(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"isInterstitialReady"];
+        resolve(@(NO));
+        return;
+    }
+
     MAInterstitialAd *interstitial = [self retrieveInterstitialForAdUnitIdentifier: adUnitIdentifier];
-    return @([interstitial isReady]);
+    resolve(@([interstitial isReady]));
 }
 
 RCT_EXPORT_METHOD(showInterstitial:(NSString *)adUnitIdentifier :(nullable NSString *)placement :(nullable NSString *)customData)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"showInterstitial"];
+        return;
+    }
+
     MAInterstitialAd *interstitial = [self retrieveInterstitialForAdUnitIdentifier: adUnitIdentifier];
     [interstitial showAdForPlacement: placement customData: customData];
 }
 
 RCT_EXPORT_METHOD(setInterstitialExtraParameter:(NSString *)adUnitIdentifier :(NSString *)key :(nullable NSString *)value)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setInterstitialExtraParameter"];
+        return;
+    }
+
     MAInterstitialAd *interstitial = [self retrieveInterstitialForAdUnitIdentifier: adUnitIdentifier];
     [interstitial setExtraParameterForKey: key value: value];
 }
 
+RCT_EXPORT_METHOD(setInterstitialLocalExtraParameter:(NSString *)adUnitIdentifier :(NSString *)key :(nullable NSString *)value)
+{
+    MAInterstitialAd *interstitial = [self retrieveInterstitialForAdUnitIdentifier: adUnitIdentifier];
+    [interstitial setLocalExtraParameterForKey: key value: value];
+}
+
 #pragma mark - Rewarded
 
 RCT_EXPORT_METHOD(loadRewardedAd:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"loadRewardedAd"];
+        return;
+    }
+
     MARewardedAd *rewardedAd = [self retrieveRewardedAdForAdUnitIdentifier: adUnitIdentifier];
     [rewardedAd loadAd];
 }
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isRewardedAdReady:(NSString *)adUnitIdentifier)
+RCT_EXPORT_METHOD(isRewardedAdReady:(NSString *)adUnitIdentifier :(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"isRewardedAdReady"];
+        resolve(@(NO));
+        return;
+    }
+
     MARewardedAd *rewardedAd = [self retrieveRewardedAdForAdUnitIdentifier: adUnitIdentifier];
-    return @([rewardedAd isReady]);
+    resolve(@([rewardedAd isReady]));
 }
 
 RCT_EXPORT_METHOD(showRewardedAd:(NSString *)adUnitIdentifier :(nullable NSString *)placement :(nullable NSString *)customData)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"showRewardedAd"];
+        return;
+    }
+
     MARewardedAd *rewardedAd = [self retrieveRewardedAdForAdUnitIdentifier: adUnitIdentifier];
     [rewardedAd showAdForPlacement: placement customData: customData];
 }
 
 RCT_EXPORT_METHOD(setRewardedAdExtraParameter:(NSString *)adUnitIdentifier :(NSString *)key :(nullable NSString *)value)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setRewardedAdExtraParameter"];
+        return;
+    }
+
     MARewardedAd *rewardedAd = [self retrieveRewardedAdForAdUnitIdentifier: adUnitIdentifier];
     [rewardedAd setExtraParameterForKey: key value: value];
 }
 
+RCT_EXPORT_METHOD(setRewardedAdLocalExtraParameter:(NSString *)adUnitIdentifier :(NSString *)key :(nullable NSString *)value)
+{
+    MARewardedAd *rewardedAd = [self retrieveRewardedAdForAdUnitIdentifier: adUnitIdentifier];
+    [rewardedAd setLocalExtraParameterForKey: key value: value];
+}
+
 #pragma mark - App Open Ad
 
 RCT_EXPORT_METHOD(loadAppOpenAd:(NSString *)adUnitIdentifier)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"loadAppOpenAd"];
+        return;
+    }
+
     MAAppOpenAd *appOpenAd = [self retrieveAppOpenAdForAdUnitIdentifier: adUnitIdentifier];
     [appOpenAd loadAd];
 }
 
-RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isAppOpenAdReady:(NSString *)adUnitIdentifier)
+RCT_EXPORT_METHOD(isAppOpenAdReady:(NSString *)adUnitIdentifier :(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"isAppOpenAdReady"];
+        resolve(@(NO));
+        return;
+    }
+
     MAAppOpenAd *appOpenAd = [self retrieveAppOpenAdForAdUnitIdentifier: adUnitIdentifier];
-    return @([appOpenAd isReady]);
+    resolve(@([appOpenAd isReady]));
 }
 
 RCT_EXPORT_METHOD(showAppOpenAd:(NSString *)adUnitIdentifier placement:(nullable NSString *)placement customData:(nullable NSString *)customData)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"showAppOpenAd"];
+        return;
+    }
+
     MAAppOpenAd *appOpenAd = [self retrieveAppOpenAdForAdUnitIdentifier: adUnitIdentifier];
     [appOpenAd showAdForPlacement: placement customData: customData];
 }
 
 RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(NSString *)key value:(nullable NSString *)value)
 {
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"setAppOpenAdExtraParameter"];
+        return;
+    }
+
     MAAppOpenAd *appOpenAd = [self retrieveAppOpenAdForAdUnitIdentifier: adUnitIdentifier];
     [appOpenAd setExtraParameterForKey: key value: value];
 }
 
+RCT_EXPORT_METHOD(setAppOpenAdLocalExtraParameter:(NSString *)adUnitIdentifier key:(NSString *)key value:(nullable NSString *)value)
+{
+    MAAppOpenAd *appOpenAd = [self retrieveAppOpenAdForAdUnitIdentifier: adUnitIdentifier];
+    [appOpenAd setLocalExtraParameterForKey: key value: value];
+}
+
 #pragma mark - Ad Callbacks
 
 - (void)didLoadAd:(MAAd *)ad
@@ -761,7 +1088,7 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
         // An ad is now being shown, enable user interaction.
         adView.userInteractionEnabled = YES;
         
-        name = ( MAAdFormat.mrec == adFormat ) ? @"OnMRecAdLoadedEvent" : @"OnBannerAdLoadedEvent";
+        name = ( MAAdFormat.mrec == adFormat ) ? ON_MREC_AD_LOADED_EVENT : ON_BANNER_AD_LOADED_EVENT;
         [self positionAdViewForAd: ad];
         
         // Do not auto-refresh by default if the ad view is not showing yet (e.g. first load during app launch and publisher does not automatically show banner upon load success)
@@ -773,19 +1100,15 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     }
     else if ( MAAdFormat.interstitial == adFormat )
     {
-        name = @"OnInterstitialLoadedEvent";
+        name = ON_INTERSTITIAL_LOADED_EVENT;
     }
     else if ( MAAdFormat.rewarded == adFormat )
     {
-        name = @"OnRewardedAdLoadedEvent";
-    }
-    else if ( MAAdFormat.native == adFormat )
-    {
-        name = @"OnNativeAdLoadedEvent";
+        name = ON_REWARDED_AD_LOADED_EVENT;
     }
     else if ( MAAdFormat.appOpen == adFormat )
     {
-        name = @"OnAppOpenAdLoadedEvent";
+        name = ON_APPOPEN_AD_LOADED_EVENT;
     }
     else
     {
@@ -796,21 +1119,6 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     [self sendReactNativeEventWithName: name body: [self adInfoForAd: ad]];
 }
 
-- (void)sendReactNativeEventForAdLoadFailed:(NSString *)name forAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(nullable MAError *)error
-{
-    NSDictionary *body = ( error ) ?
-        @{@"adUnitId": adUnitIdentifier,
-          @"code" : @(error.code),
-          @"message" : error.message,
-          @"adLoadFailureInfo" : error.adLoadFailureInfo ?: @"",
-          @"waterfall": [self createAdWaterfallInfo: error.waterfall]}
-    :
-        @{@"adUnitId": adUnitIdentifier,
-          @"code" : @(MAErrorCodeUnspecified)};
-    
-    [self sendReactNativeEventWithName: name body: body];
-}
-
 - (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error
 {
     if ( !adUnitIdentifier )
@@ -826,15 +1134,15 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     }
     else if ( self.interstitials[adUnitIdentifier] )
     {
-        name = @"OnInterstitialLoadFailedEvent";
+        name = ON_INTERSTITIAL_LOAD_FAILED_EVENT;
     }
     else if ( self.rewardedAds[adUnitIdentifier] )
     {
-        name = @"OnRewardedAdLoadFailedEvent";
+        name = ON_REWARDED_AD_LOAD_FAILED_EVENT;
     }
     else if ( self.appOpenAds[adUnitIdentifier] )
     {
-        name = @"OnAppOpenAdLoadFailedEvent";
+        name = ON_APPOPEN_AD_LOAD_FAILED_EVENT;
     }
     else
     {
@@ -842,7 +1150,7 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
         return;
     }
     
-    [self sendReactNativeEventForAdLoadFailed: name forAdUnitIdentifier: adUnitIdentifier withError: error];
+    [self sendReactNativeEventWithName: name body: [self adLoadFailedInfoForAd: adUnitIdentifier withError: error]];
 }
 
 - (void)didClickAd:(MAAd *)ad
@@ -851,27 +1159,23 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     MAAdFormat *adFormat = ad.format;
     if ( MAAdFormat.banner == adFormat || MAAdFormat.leader == adFormat )
     {
-        name = @"OnBannerAdClickedEvent";
+        name = ON_BANNER_AD_CLICKED_EVENT;
     }
     else if ( MAAdFormat.mrec == adFormat )
     {
-        name = @"OnMRecAdClickedEvent";
+        name = ON_MREC_AD_CLICKED_EVENT;
     }
     else if ( MAAdFormat.interstitial == adFormat )
     {
-        name = @"OnInterstitialClickedEvent";
+        name = ON_INTERSTITIAL_CLICKED_EVENT;
     }
     else if ( MAAdFormat.rewarded == adFormat )
     {
-        name = @"OnRewardedAdClickedEvent";
-    }
-    else if ( MAAdFormat.native == adFormat )
-    {
-        name = @"OnNativeAdClickedEvent";
+        name = ON_REWARDED_AD_CLICKED_EVENT;
     }
     else if ( MAAdFormat.appOpen == adFormat )
     {
-        name = @"OnAppOpenAdClickedEvent";
+        name = ON_APPOPEN_AD_CLICKED_EVENT;
     }
     else
     {
@@ -891,15 +1195,15 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     NSString *name;
     if ( MAAdFormat.interstitial == adFormat )
     {
-        name = @"OnInterstitialDisplayedEvent";
+        name = ON_INTERSTITIAL_DISPLAYED_EVENT;
     }
     else if ( MAAdFormat.rewarded == adFormat )
     {
-        name = @"OnRewardedAdDisplayedEvent";
+        name = ON_REWARDED_AD_DISPLAYED_EVENT;
     }
     else // APP OPEN
     {
-        name = @"OnAppOpenAdDisplayedEvent";
+        name = ON_APPOPEN_AD_DISPLAYED_EVENT;
     }
     
     [self sendReactNativeEventWithName: name body: [self adInfoForAd: ad]];
@@ -914,22 +1218,18 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     NSString *name;
     if ( MAAdFormat.interstitial == adFormat )
     {
-        name = @"OnInterstitialAdFailedToDisplayEvent";
+        name = ON_INTERSTITIAL_AD_FAILED_TO_DISPLAY_EVENT;
     }
     else if ( MAAdFormat.rewarded == adFormat )
     {
-        name = @"OnRewardedAdFailedToDisplayEvent";
+        name = ON_REWARDED_AD_FAILED_TO_DISPLAY_EVENT;
     }
     else // APP OPEN
     {
-        name = @"OnAppOpenAdFailedToDisplayEvent";
+        name = ON_APPOPEN_AD_FAILED_TO_DISPLAY_EVENT;
     }
     
-    NSMutableDictionary *body = [@{@"code" : @(error.code),
-                                   @"message" : error.message} mutableCopy];
-    [body addEntriesFromDictionary: [self adInfoForAd: ad]];
-    
-    [self sendReactNativeEventWithName: name body: body];
+    [self sendReactNativeEventWithName: name body: [self adDisplayFailedInfoForAd: ad withError: error]];
 }
 
 - (void)didHideAd:(MAAd *)ad
@@ -941,15 +1241,15 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     NSString *name;
     if ( MAAdFormat.interstitial == adFormat )
     {
-        name = @"OnInterstitialHiddenEvent";
+        name = ON_INTERSTITIAL_HIDDEN_EVENT;
     }
     else if ( MAAdFormat.rewarded == adFormat )
     {
-        name = @"OnRewardedAdHiddenEvent";
+        name = ON_REWARDED_AD_HIDDEN_EVENT;
     }
     else // APP OPEN
     {
-        name = @"OnAppOpenAdHiddenEvent";
+        name = ON_APPOPEN_AD_HIDDEN_EVENT;
     }
     
     [self sendReactNativeEventWithName: name body: [self adInfoForAd: ad]];
@@ -964,7 +1264,7 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
         return;
     }
     
-    [self sendReactNativeEventWithName: ( MAAdFormat.mrec == adFormat ) ? @"OnMRecAdExpandedEvent" : @"OnBannerAdExpandedEvent"
+    [self sendReactNativeEventWithName: ( MAAdFormat.mrec == adFormat ) ? ON_MREC_AD_EXPANDED_EVENT : ON_BANNER_AD_EXPANDED_EVENT
                                   body: [self adInfoForAd: ad]];
 }
 
@@ -977,7 +1277,7 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
         return;
     }
     
-    [self sendReactNativeEventWithName: ( MAAdFormat.mrec == adFormat ) ? @"OnMRecAdCollapsedEvent" : @"OnBannerAdCollapsedEvent"
+    [self sendReactNativeEventWithName: ( MAAdFormat.mrec == adFormat ) ? ON_MREC_AD_COLLAPSED_EVENT : ON_BANNER_AD_COLLAPSED_EVENT
                                   body: [self adInfoForAd: ad]];
 }
 
@@ -987,40 +1287,31 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     MAAdFormat *adFormat = ad.format;
     if ( MAAdFormat.banner == adFormat || MAAdFormat.leader == adFormat )
     {
-        name = @"OnBannerAdRevenuePaid";
+        name = ON_BANNER_AD_REVENUE_PAID;
     }
     else if ( MAAdFormat.mrec == adFormat )
     {
-        name = @"OnMRecAdRevenuePaid";
+        name = ON_MREC_AD_REVENUE_PAID;
     }
     else if ( MAAdFormat.interstitial == adFormat )
     {
-        name = @"OnInterstitialAdRevenuePaid";
+        name = ON_INTERSTITIAL_AD_REVENUE_PAID;
     }
     else if ( MAAdFormat.rewarded == adFormat )
     {
-        name = @"OnRewardedAdRevenuePaid";
-    }
-    else if ( MAAdFormat.native == adFormat )
-    {
-        name = @"OnNativeAdRevenuePaid";
+        name = ON_REWARDED_AD_REVENUE_PAID;
     }
     else if ( MAAdFormat.appOpen == adFormat )
     {
-        name = @"OnAppOpenAdRevenuePaid";
+        name = ON_APPOPEN_AD_REVENUE_PAID;
     }
     else
     {
         [self logInvalidAdFormat: adFormat];
         return;
     }
-
-    NSMutableDictionary *body = [self adInfoForAd: ad].mutableCopy;
-    body[@"networkPlacement"] = ad.networkPlacement;
-    body[@"revenuePrecision"] = ad.revenuePrecision;
-    body[@"countryCode"] = self.sdk.configuration.countryCode;
-
-    [self sendReactNativeEventWithName: name body: body];
+    
+    [self sendReactNativeEventWithName: name body: [self adRevenueInfoForAd: ad]];
 }
 
 - (void)didCompleteRewardedVideoForAd:(MAAd *)ad
@@ -1050,7 +1341,7 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
                                    @"rewardAmount": rewardAmount} mutableCopy];
     [body addEntriesFromDictionary: [self adInfoForAd: ad]];
     
-    [self sendReactNativeEventWithName: @"OnRewardedAdReceivedRewardEvent" body: body];
+    [self sendReactNativeEventWithName: ON_REWARDED_AD_RECEIVED_REWARD_EVENT body: body];
 }
 
 #pragma mark - Internal Methods
@@ -1195,6 +1486,17 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     });
 }
 
+- (void)setAdViewLocalExtraParameterForAdUnitIdentifier:(NSString *)adUnitIdentifier adFormat:(MAAdFormat *)adFormat key:(NSString *)key value:(nullable NSString *)value
+{
+    dispatch_async(dispatch_get_main_queue(), ^{
+        
+        [self log: @"Setting %@ local extra with key: \"%@\" value: \"%@\"", adFormat, key, value];
+        
+        MAAdView *adView = [self retrieveAdViewForAdUnitIdentifier: adUnitIdentifier adFormat: adFormat];
+        [adView setLocalExtraParameterForKey: key value: value];
+    });
+}
+
 - (void)startAutoRefresh:(NSString *)adUnitIdentifier adFormat:(MAAdFormat *)adFormat
 {
     dispatch_async(dispatch_get_main_queue(), ^{
@@ -1405,7 +1707,7 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
         adViewWidth = self.adViewWidths[adUnitIdentifier].floatValue;
     }
     // Top center / bottom center stretches full screen
-    else if ( [adViewPosition isEqual: @"top_center"] || [adViewPosition isEqual: @"bottom_center"] )
+    else if ( [adViewPosition isEqual: TOP_CENTER] || [adViewPosition isEqual: BOTTOM_CENTER] )
     {
         adViewWidth = CGRectGetWidth(KEY_WINDOW.bounds);
     }
@@ -1445,14 +1747,14 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     }
     
     // If top of bottom center, stretch width of screen
-    if ( [adViewPosition isEqual: @"top_center"] || [adViewPosition isEqual: @"bottom_center"] )
+    if ( [adViewPosition isEqual: TOP_CENTER] || [adViewPosition isEqual: BOTTOM_CENTER] )
     {
         // Non AdMob banners will still be of 50/90 points tall. Set the auto sizing mask such that the inner ad view is pinned to the bottom or top according to the ad view position.
         if ( !isAdaptiveBannerDisabled )
         {
             adView.autoresizingMask = UIViewAutoresizingFlexibleWidth;
             
-            if ( [@"top_center" isEqual: adViewPosition] )
+            if ( [TOP_CENTER isEqual: adViewPosition] )
             {
                 adView.autoresizingMask |= UIViewAutoresizingFlexibleBottomMargin;
             }
@@ -1470,7 +1772,7 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
                                                 [self.safeAreaBackground.widthAnchor constraintEqualToConstant: adViewWidth],
                                                 [self.safeAreaBackground.centerXAnchor constraintEqualToAnchor: layoutGuide.centerXAnchor]]];
             
-            if ( [adViewPosition isEqual: @"top_center"] )
+            if ( [adViewPosition isEqual: TOP_CENTER] )
             {
                 [constraints addObjectsFromArray: @[[adView.topAnchor constraintEqualToAnchor: layoutGuide.topAnchor],
                                                     [self.safeAreaBackground.topAnchor constraintEqualToAnchor: superview.topAnchor],
@@ -1492,7 +1794,7 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
             [constraints addObjectsFromArray: @[[adView.widthAnchor constraintEqualToConstant: adViewWidth],
                                                 [adView.centerXAnchor constraintEqualToAnchor: layoutGuide.centerXAnchor]]];
             
-            if ( [adViewPosition isEqual: @"top_center"] )
+            if ( [adViewPosition isEqual: TOP_CENTER] )
             {
                 [constraints addObject: [adView.topAnchor constraintEqualToAnchor: layoutGuide.topAnchor constant: yOffset]];
             }
@@ -1510,27 +1812,27 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
         // Assign constant width of 320 or 728
         [constraints addObject: [adView.widthAnchor constraintEqualToConstant: adViewWidth]];
         
-        if ( [adViewPosition isEqual: @"top_left"] )
+        if ( [adViewPosition isEqual: TOP_LEFT] )
         {
             [constraints addObjectsFromArray: @[[adView.topAnchor constraintEqualToAnchor: layoutGuide.topAnchor constant: yOffset],
                                                 [adView.leftAnchor constraintEqualToAnchor: superview.leftAnchor constant: xOffset]]];
         }
-        else if ( [adViewPosition isEqual: @"top_right"] )
+        else if ( [adViewPosition isEqual: TOP_RIGHT] )
         {
             [constraints addObjectsFromArray: @[[adView.topAnchor constraintEqualToAnchor: layoutGuide.topAnchor constant: yOffset],
                                                 [adView.rightAnchor constraintEqualToAnchor: superview.rightAnchor constant: xOffset]]];
         }
-        else if ( [adViewPosition isEqual: @"centered"] )
+        else if ( [adViewPosition isEqual: CENTERED] )
         {
             [constraints addObjectsFromArray: @[[adView.centerXAnchor constraintEqualToAnchor: layoutGuide.centerXAnchor],
                                                 [adView.centerYAnchor constraintEqualToAnchor: layoutGuide.centerYAnchor]]];
         }
-        else if ( [adViewPosition isEqual: @"bottom_left"] )
+        else if ( [adViewPosition isEqual: BOTTOM_LEFT] )
         {
             [constraints addObjectsFromArray: @[[adView.bottomAnchor constraintEqualToAnchor: layoutGuide.bottomAnchor constant: yOffset],
                                                 [adView.leftAnchor constraintEqualToAnchor: superview.leftAnchor constant: xOffset]]];
         }
-        else if ( [adViewPosition isEqual: @"bottom_right"] )
+        else if ( [adViewPosition isEqual: BOTTOM_RIGHT] )
         {
             [constraints addObjectsFromArray: @[[adView.bottomAnchor constraintEqualToAnchor: layoutGuide.bottomAnchor constant: yOffset],
                                                 [adView.rightAnchor constraintEqualToAnchor: superview.rightAnchor constant: xOffset]]];
@@ -1595,6 +1897,24 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
     return ALGenderUnknown;
 }
 
+- (NSString *)fromAppLovinGender:(ALGender)gender
+{
+    if ( gender == ALGenderFemale )
+    {
+        return @"F";
+    }
+    else if ( gender == ALGenderMale )
+    {
+        return @"M";
+    }
+    else if ( gender == ALGenderOther )
+    {
+        return @"O";
+    }
+
+    return @"U";
+}
+
 - (ALAdContentRating)toAppLovinAdContentRating:(nullable NSNumber *)maximumAdContentRating
 {
     if ( maximumAdContentRating )
@@ -1631,6 +1951,36 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
              @"dspName" : ad.DSPName ?: @""};
 }
 
+- (NSDictionary<NSString *, id> *)adLoadFailedInfoForAd:(NSString *)adUnitIdentifier withError:(MAError *)error
+{
+    return ( error ) ?
+        @{@"adUnitId": adUnitIdentifier,
+          @"code" : @(error.code),
+          @"message" : error.message,
+          @"adLoadFailureInfo" : error.adLoadFailureInfo ?: @"",
+          @"waterfall": [self createAdWaterfallInfo: error.waterfall]}
+    :
+        @{@"adUnitId": adUnitIdentifier,
+          @"code" : @(MAErrorCodeUnspecified)};
+}
+
+- (NSDictionary<NSString *, id> *)adDisplayFailedInfoForAd:(MAAd *)ad withError:(MAError *)error
+{
+    NSMutableDictionary *body = [@{@"code" : @(error.code),
+                                   @"message" : error.message} mutableCopy];
+    [body addEntriesFromDictionary: [self adInfoForAd: ad]];
+    return body;
+}
+
+- (NSDictionary<NSString *, id> *)adRevenueInfoForAd:(MAAd *)ad
+{
+    NSMutableDictionary *body = [self adInfoForAd: ad].mutableCopy;
+    body[@"networkPlacement"] = ad.networkPlacement;
+    body[@"revenuePrecision"] = ad.revenuePrecision;
+    body[@"countryCode"] = self.sdk.configuration.countryCode;
+    return body;
+}
+
 #pragma mark - Waterfall Information
 
 - (NSDictionary<NSString *, id> *)createAdWaterfallInfo:(MAAdWaterfallInfo *)waterfallInfo
@@ -1703,49 +2053,99 @@ RCT_EXPORT_METHOD(setAppOpenAdExtraParameter:(NSString *)adUnitIdentifier key:(N
 // From RCTBridgeModule protocol
 - (NSArray<NSString *> *)supportedEvents
 {
-    return @[@"OnMRecAdLoadedEvent",
-             @"OnMRecAdLoadFailedEvent",
-             @"OnMRecAdClickedEvent",
-             @"OnMRecAdCollapsedEvent",
-             @"OnMRecAdExpandedEvent",
-             @"OnMRecAdRevenuePaid",
+    return @[ON_MREC_AD_LOADED_EVENT,
+             ON_MREC_AD_LOAD_FAILED_EVENT,
+             ON_MREC_AD_CLICKED_EVENT,
+             ON_MREC_AD_COLLAPSED_EVENT,
+             ON_MREC_AD_EXPANDED_EVENT,
+             ON_MREC_AD_REVENUE_PAID,
+             
+             ON_BANNER_AD_LOADED_EVENT,
+             ON_BANNER_AD_LOAD_FAILED_EVENT,
+             ON_BANNER_AD_CLICKED_EVENT,
+             ON_BANNER_AD_COLLAPSED_EVENT,
+             ON_BANNER_AD_EXPANDED_EVENT,
+             ON_BANNER_AD_REVENUE_PAID,
+             
+             ON_INTERSTITIAL_LOADED_EVENT,
+             ON_INTERSTITIAL_LOAD_FAILED_EVENT,
+             ON_INTERSTITIAL_CLICKED_EVENT,
+             ON_INTERSTITIAL_DISPLAYED_EVENT,
+             ON_INTERSTITIAL_AD_FAILED_TO_DISPLAY_EVENT,
+             ON_INTERSTITIAL_HIDDEN_EVENT,
+             ON_INTERSTITIAL_AD_REVENUE_PAID,
+             
+             ON_REWARDED_AD_LOADED_EVENT,
+             ON_REWARDED_AD_LOAD_FAILED_EVENT,
+             ON_REWARDED_AD_CLICKED_EVENT,
+             ON_REWARDED_AD_DISPLAYED_EVENT,
+             ON_REWARDED_AD_FAILED_TO_DISPLAY_EVENT,
+             ON_REWARDED_AD_HIDDEN_EVENT,
+             ON_REWARDED_AD_RECEIVED_REWARD_EVENT,
+             ON_REWARDED_AD_REVENUE_PAID,
+             
+             ON_APPOPEN_AD_LOADED_EVENT,
+             ON_APPOPEN_AD_LOAD_FAILED_EVENT,
+             ON_APPOPEN_AD_CLICKED_EVENT,
+             ON_APPOPEN_AD_DISPLAYED_EVENT,
+             ON_APPOPEN_AD_FAILED_TO_DISPLAY_EVENT,
+             ON_APPOPEN_AD_HIDDEN_EVENT,
+             ON_APPOPEN_AD_REVENUE_PAID];
+}
+
+- (NSDictionary *)constantsToExport
+{
+    return @{@"ON_MREC_AD_LOADED_EVENT": ON_MREC_AD_LOADED_EVENT,
+             @"ON_MREC_AD_LOAD_FAILED_EVENT" : ON_MREC_AD_LOAD_FAILED_EVENT,
+             @"ON_MREC_AD_CLICKED_EVENT" : ON_MREC_AD_CLICKED_EVENT,
+             @"ON_MREC_AD_COLLAPSED_EVENT" : ON_MREC_AD_COLLAPSED_EVENT,
+             @"ON_MREC_AD_EXPANDED_EVENT" : ON_MREC_AD_EXPANDED_EVENT,
+             @"ON_MREC_AD_REVENUE_PAID" : ON_MREC_AD_REVENUE_PAID,
+             
+             @"ON_BANNER_AD_LOADED_EVENT" : ON_BANNER_AD_LOADED_EVENT,
+             @"ON_BANNER_AD_LOAD_FAILED_EVENT" : ON_BANNER_AD_LOAD_FAILED_EVENT,
+             @"ON_BANNER_AD_CLICKED_EVENT" : ON_BANNER_AD_CLICKED_EVENT,
+             @"ON_BANNER_AD_COLLAPSED_EVENT" : ON_BANNER_AD_COLLAPSED_EVENT,
+             @"ON_BANNER_AD_EXPANDED_EVENT" : ON_BANNER_AD_EXPANDED_EVENT,
+             @"ON_BANNER_AD_REVENUE_PAID" : ON_BANNER_AD_REVENUE_PAID,
              
-             @"OnBannerAdLoadedEvent",
-             @"OnBannerAdLoadFailedEvent",
-             @"OnBannerAdClickedEvent",
-             @"OnBannerAdCollapsedEvent",
-             @"OnBannerAdExpandedEvent",
-             @"OnBannerAdRevenuePaid",
+             @"ON_INTERSTITIAL_LOADED_EVENT" : ON_INTERSTITIAL_LOADED_EVENT,
+             @"ON_INTERSTITIAL_LOAD_FAILED_EVENT" : ON_INTERSTITIAL_LOAD_FAILED_EVENT,
+             @"ON_INTERSTITIAL_CLICKED_EVENT" : ON_INTERSTITIAL_CLICKED_EVENT,
+             @"ON_INTERSTITIAL_DISPLAYED_EVENT" : ON_INTERSTITIAL_DISPLAYED_EVENT,
+             @"ON_INTERSTITIAL_AD_FAILED_TO_DISPLAY_EVENT" : ON_INTERSTITIAL_AD_FAILED_TO_DISPLAY_EVENT,
+             @"ON_INTERSTITIAL_HIDDEN_EVENT" : ON_INTERSTITIAL_HIDDEN_EVENT,
+             @"ON_INTERSTITIAL_AD_REVENUE_PAID" : ON_INTERSTITIAL_AD_REVENUE_PAID,
              
-             @"OnInterstitialLoadedEvent",
-             @"OnInterstitialLoadFailedEvent",
-             @"OnInterstitialClickedEvent",
-             @"OnInterstitialDisplayedEvent",
-             @"OnInterstitialAdFailedToDisplayEvent",
-             @"OnInterstitialHiddenEvent",
-             @"OnInterstitialAdRevenuePaid",
+             @"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,
+             @"ON_REWARDED_AD_DISPLAYED_EVENT" : ON_REWARDED_AD_DISPLAYED_EVENT,
+             @"ON_REWARDED_AD_FAILED_TO_DISPLAY_EVENT" : ON_REWARDED_AD_FAILED_TO_DISPLAY_EVENT,
+             @"ON_REWARDED_AD_HIDDEN_EVENT" : ON_REWARDED_AD_HIDDEN_EVENT,
+             @"ON_REWARDED_AD_RECEIVED_REWARD_EVENT" : ON_REWARDED_AD_RECEIVED_REWARD_EVENT,
+             @"ON_REWARDED_AD_REVENUE_PAID" : ON_REWARDED_AD_REVENUE_PAID,
              
-             @"OnRewardedAdLoadedEvent",
-             @"OnRewardedAdLoadFailedEvent",
-             @"OnRewardedAdClickedEvent",
-             @"OnRewardedAdDisplayedEvent",
-             @"OnRewardedAdFailedToDisplayEvent",
-             @"OnRewardedAdHiddenEvent",
-             @"OnRewardedAdReceivedRewardEvent",
-             @"OnRewardedAdRevenuePaid",
+             @"ON_APPOPEN_AD_LOADED_EVENT" : ON_APPOPEN_AD_LOADED_EVENT,
+             @"ON_APPOPEN_AD_LOAD_FAILED_EVENT" : ON_APPOPEN_AD_LOAD_FAILED_EVENT,
+             @"ON_APPOPEN_AD_CLICKED_EVENT" : ON_APPOPEN_AD_CLICKED_EVENT,
+             @"ON_APPOPEN_AD_DISPLAYED_EVENT" : ON_APPOPEN_AD_DISPLAYED_EVENT,
+             @"ON_APPOPEN_AD_FAILED_TO_DISPLAY_EVENT" : ON_APPOPEN_AD_FAILED_TO_DISPLAY_EVENT,
+             @"ON_APPOPEN_AD_HIDDEN_EVENT" : ON_APPOPEN_AD_HIDDEN_EVENT,
+             @"ON_APPOPEN_AD_REVENUE_PAID" : ON_APPOPEN_AD_REVENUE_PAID,
              
-             @"OnAppOpenAdLoadedEvent",
-             @"OnAppOpenAdLoadFailedEvent",
-             @"OnAppOpenAdClickedEvent",
-             @"OnAppOpenAdDisplayedEvent",
-             @"OnAppOpenAdFailedToDisplayEvent",
-             @"OnAppOpenAdHiddenEvent",
-             @"OnAppOpenAdRevenuePaid",
+             @"TOP_CENTER_POSITION" : TOP_CENTER,
+             @"TOP_LEFT_POSITION" : TOP_LEFT,
+             @"TOP_RIGHT_POSITION" : TOP_RIGHT,
+             @"CENTERED_POSITION" : CENTERED,
+             @"CENTER_LEFT_POSITION" : CENTER_LEFT,
+             @"CENTER_RIGHT_POSITION" : CENTER_RIGHT,
+             @"BOTTOM_LEFT_POSITION" : BOTTOM_LEFT,
+             @"BOTTOM_CENTER_POSITION" : BOTTOM_CENTER,
+             @"BOTTOM_RIGHT_POSITION" : BOTTOM_RIGHT,
              
-             @"OnNativeAdLoadedEvent",
-             @"OnNativeAdLoadFailedEvent",
-             @"OnNativeAdClickedEvent",
-             @"OnNativeAdRevenuePaid"];
+             @"BANNER_AD_FORMAT_LABEL" : MAAdFormat.banner.label,
+             @"MREC_AD_FORMAT_LABEL" : MAAdFormat.mrec.label};
 }
 
 - (void)startObserving