react-native-applovin-max 3.2.0 → 3.3.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 AppLovin Corporation
+Copyright (c) 2022 AppLovin Corporation
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/android/build.gradle

@@ -41,8 +41,8 @@ android {
   defaultConfig {
     minSdkVersion 16
     targetSdkVersion getExtOrIntegerDefault('targetSdkVersion')
-    versionCode 3020000
-    versionName "3.2.0"
+    versionCode 3030000
+    versionName "3.3.0"
   }
 
   flavorDimensions("default")
@@ -150,5 +150,5 @@ dependencies {
 
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 
-  implementation 'com.applovin:applovin-sdk:11.4.3'
+  implementation 'com.applovin:applovin-sdk:11.4.4'
 }

package/android/src/main/java/com/applovin/reactnative/AppLovinMAXAdView.java

@@ -74,7 +74,7 @@ class AppLovinMAXAdView
         return adView;
     }
 
-    public void maybeAttachAdView(final String placement, final String customData, final String adaptiveBannerEnabledStr, final String adUnitId, final MaxAdFormat adFormat)
+    public void maybeAttachAdView(final String placement, final String customData, final String adaptiveBannerEnabledStr, final Boolean autoRefreshEnabled, final String adUnitId, final MaxAdFormat adFormat)
     {
         final Activity currentActivity = reactContext.getCurrentActivity();
         if ( currentActivity == null )
@@ -92,6 +92,7 @@ class AppLovinMAXAdView
                 // If ad unit id and format has been set - create and attach AdView
                 if ( !TextUtils.isEmpty( adUnitId ) && adFormat != null )
                 {
+                    // NOTE: AppLovinMAXModule.getInstance().getSdk() may be null
                     adView = new MaxAdView( adUnitId, adFormat, AppLovinMAXModule.getInstance().getSdk(), currentActivity );
                     adView.setListener( AppLovinMAXModule.getInstance() );
                     adView.setRevenueListener( AppLovinMAXModule.getInstance() );
@@ -111,6 +112,21 @@ class AppLovinMAXAdView
                         adView.setExtraParameter( "adaptive_banner", adaptiveBannerEnabledStr );
                     }
 
+                    // Set this extra parameter to work around a SDK bug that ignores calls to stopAutoRefresh()
+                    adView.setExtraParameter( "allow_pause_auto_refresh_immediately", "true" );
+
+                    if ( autoRefreshEnabled != null )
+                    {
+                        if ( autoRefreshEnabled.booleanValue() )
+                        {
+                            adView.startAutoRefresh();
+                        }
+                        else
+                        {
+                            adView.stopAutoRefresh();
+                        }
+                    }
+
                     adView.loadAd();
 
                     currentWidthPx = getWidth();

package/android/src/main/java/com/applovin/reactnative/AppLovinMAXAdViewManager.java

@@ -30,9 +30,10 @@ class AppLovinMAXAdViewManager
     private final Map<AppLovinMAXAdView, MaxAdFormat> adFormatRegistry = new HashMap<>();
 
     // Storage for placement and extra parameters if set before the MAAdView is created
-    private final Map<AppLovinMAXAdView, String> placementRegistry             = new HashMap<>();
-    private final Map<AppLovinMAXAdView, String> customDataRegistry            = new HashMap<>();
-    private final Map<AppLovinMAXAdView, String> adaptiveBannerEnabledRegistry = new HashMap<>();
+    private final Map<AppLovinMAXAdView, String>  placementRegistry             = new HashMap<>();
+    private final Map<AppLovinMAXAdView, String>  customDataRegistry            = new HashMap<>();
+    private final Map<AppLovinMAXAdView, String>  adaptiveBannerEnabledRegistry = new HashMap<>();
+    private final Map<AppLovinMAXAdView, Boolean> autoRefreshEnabledRegistry    = new HashMap<>();
 
     public AppLovinMAXAdViewManager(final ReactApplicationContext reactApplicationContext)
     {
@@ -57,6 +58,12 @@ class AppLovinMAXAdViewManager
     {
         if ( args == null ) return;
 
+        if ( "setAutoRefresh".equals( commandId ) )
+        {
+            setAutoRefresh( view, args.getBoolean( 0 ) );
+            return;
+        }
+
         String arg = args.getString( 0 );
         if ( arg == null ) return;
 
@@ -137,6 +144,30 @@ class AppLovinMAXAdViewManager
         } );
     }
 
+    public void setAutoRefresh(final AppLovinMAXAdView view, final boolean enabled)
+    {
+        // Post to main thread to avoid race condition with actual creation of MaxAdView in maybeAttachAdView()
+        view.post( () -> {
+
+            MaxAdView adView = view.getAdView();
+            if ( adView != null )
+            {
+                if ( enabled )
+                {
+                    adView.startAutoRefresh();
+                }
+                else
+                {
+                    adView.stopAutoRefresh();
+                }
+            }
+            else
+            {
+                autoRefreshEnabledRegistry.put( view, enabled );
+            }
+        } );
+    }
+
     public void setAdUnitId(final AppLovinMAXAdView view, final String adUnitId)
     {
         adUnitIdRegistry.put( view, adUnitId );
@@ -162,10 +193,12 @@ class AppLovinMAXAdViewManager
         String placement = placementRegistry.remove( view );
         String customData = customDataRegistry.remove( view );
         String adaptiveBannerEnabledStr = adaptiveBannerEnabledRegistry.remove( view );
+        Boolean autoRefreshEnabled = autoRefreshEnabledRegistry.remove( view );
 
         view.maybeAttachAdView( placement,
                                 customData,
                                 adaptiveBannerEnabledStr,
+                                autoRefreshEnabled,
                                 adUnitIdRegistry.get( view ),
                                 adFormatRegistry.get( view ) );
     }

package/android/src/main/java/com/applovin/reactnative/AppLovinMAXModule.java

@@ -45,6 +45,7 @@ import com.applovin.sdk.AppLovinSdkUtils;
 import com.applovin.sdk.AppLovinUserService;
 import com.facebook.react.bridge.Arguments;
 import com.facebook.react.bridge.Callback;
+import com.facebook.react.bridge.LifecycleEventListener;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactContextBaseJavaModule;
 import com.facebook.react.bridge.ReactMethod;
@@ -72,7 +73,8 @@ import static com.facebook.react.modules.core.DeviceEventManagerModule.RCTDevice
  */
 public class AppLovinMAXModule
         extends ReactContextBaseJavaModule
-        implements MaxAdListener, MaxAdViewAdListener, MaxRewardedAdListener, MaxAdRevenueListener
+        implements LifecycleEventListener,
+        MaxAdListener, MaxAdViewAdListener, MaxRewardedAdListener, MaxAdRevenueListener
 {
     private static final String SDK_TAG = "AppLovinSdk";
     private static final String TAG     = "AppLovinMAXModule";
@@ -92,10 +94,12 @@ public class AppLovinMAXModule
     private int           lastRotation;
 
     // Store these values if pub attempts to set it before initializing
-    private String       userIdToSet;
-    private List<String> testDeviceAdvertisingIdsToSet;
-    private Boolean      verboseLoggingToSet;
-    private Boolean      creativeDebuggerEnabledToSet;
+    private       String              userIdToSet;
+    private       List<String>        testDeviceAdvertisingIdsToSet;
+    private       Boolean             verboseLoggingToSet;
+    private       Boolean             creativeDebuggerEnabledToSet;
+    private       Boolean             locationCollectionEnabledToSet;
+    private final Map<String, String> extraParametersToSet = new HashMap<>( 8 );
 
     // Fullscreen Ad Fields
     private final Map<String, MaxInterstitialAd> mInterstitials = new HashMap<>( 2 );
@@ -129,6 +133,9 @@ public class AppLovinMAXModule
 
         instance = this;
         sCurrentActivity = reactContext.getCurrentActivity();
+
+        // Listening to Lifecycle Events
+        reactContext.addLifecycleEventListener( this );
     }
 
     @Override
@@ -253,6 +260,15 @@ public class AppLovinMAXModule
             creativeDebuggerEnabledToSet = null;
         }
 
+        // Set location collection enabled if needed
+        if ( locationCollectionEnabledToSet != null )
+        {
+            sdk.getSettings().setLocationCollectionEnabled( locationCollectionEnabledToSet );
+            locationCollectionEnabledToSet = null;
+        }
+
+        setPendingExtraParametersIfNeeded( sdk.getSettings() );
+
         sdk.initializeSdk( new AppLovinSdk.SdkInitializationListener()
         {
             @Override
@@ -408,16 +424,16 @@ public class AppLovinMAXModule
     }
 
     @ReactMethod()
-    public void setVerboseLogging(final boolean verboseLoggingEnabled)
+    public void setVerboseLogging(final boolean enabled)
     {
         if ( isPluginInitialized )
         {
-            sdk.getSettings().setVerboseLogging( verboseLoggingEnabled );
+            sdk.getSettings().setVerboseLogging( enabled );
             verboseLoggingToSet = null;
         }
         else
         {
-            verboseLoggingToSet = verboseLoggingEnabled;
+            verboseLoggingToSet = enabled;
         }
     }
 
@@ -457,6 +473,27 @@ public class AppLovinMAXModule
         }
     }
 
+    @ReactMethod()
+    public void setExtraParameter(final String key, @Nullable final String value)
+    {
+        if ( TextUtils.isEmpty( key ) )
+        {
+            e( "ERROR: Failed to set extra parameter for null or empty key: " + key );
+            return;
+        }
+
+        if ( sdk != null )
+        {
+            AppLovinSdkSettings settings = sdk.getSettings();
+            settings.setExtraParameter( key, value );
+            setPendingExtraParametersIfNeeded( settings );
+        }
+        else
+        {
+            extraParametersToSet.put( key, value );
+        }
+    }
+
     @ReactMethod()
     public void setConsentFlowEnabled(final boolean enabled) {}
 
@@ -468,18 +505,6 @@ public class AppLovinMAXModule
 
     // Data Passing
 
-    @ReactMethod()
-    public void setUserSegment(final String name)
-    {
-        if ( sdk == null )
-        {
-            logUninitializedAccessError( "setUserSegment" );
-            return;
-        }
-
-        sdk.getUserSegment().setName( name );
-    }
-
     @ReactMethod()
     public void setTargetingDataYearOfBirth(final int yearOfBirth)
     {
@@ -629,15 +654,17 @@ public class AppLovinMAXModule
     }
 
     @ReactMethod()
-    public void setLocationCollectionEnabled(final boolean locationCollectionEnabled)
+    public void setLocationCollectionEnabled(final boolean enabled)
     {
-        if ( sdk == null )
+        if ( isPluginInitialized )
         {
-            logUninitializedAccessError( "setLocationCollectionEnabled" );
-            return;
+            sdk.getSettings().setLocationCollectionEnabled( enabled );
+            locationCollectionEnabledToSet = null;
+        }
+        else
+        {
+            locationCollectionEnabledToSet = enabled;
         }
-
-        sdk.getSettings().setLocationCollectionEnabled( locationCollectionEnabled );
     }
 
     // EVENT TRACKING
@@ -715,6 +742,18 @@ public class AppLovinMAXModule
         setAdViewExtraParameters( adUnitId, getDeviceSpecificBannerAdViewAdFormat(), key, value );
     }
 
+    @ReactMethod()
+    public void startBannerAutoRefresh(final String adUnitId)
+    {
+        startAutoRefresh( adUnitId, getDeviceSpecificBannerAdViewAdFormat() );
+    }
+
+    @ReactMethod()
+    public void stopBannerAutoRefresh(final String adUnitId)
+    {
+        stopAutoRefresh( adUnitId, getDeviceSpecificBannerAdViewAdFormat() );
+    }
+
     @ReactMethod()
     public void showBanner(final String adUnitId)
     {
@@ -765,6 +804,18 @@ public class AppLovinMAXModule
         updateAdViewPosition( adUnitId, mrecPosition, DEFAULT_AD_VIEW_OFFSET, MaxAdFormat.MREC );
     }
 
+    @ReactMethod()
+    public void startMRecAutoRefresh(final String adUnitId)
+    {
+        startAutoRefresh( adUnitId, MaxAdFormat.MREC );
+    }
+
+    @ReactMethod()
+    public void stopMRecAutoRefresh(final String adUnitId)
+    {
+        stopAutoRefresh( adUnitId, MaxAdFormat.MREC );
+    }
+
     @ReactMethod()
     public void showMRec(final String adUnitId)
     {
@@ -1075,7 +1126,7 @@ public class AppLovinMAXModule
         sendReactNativeEvent( ( MaxAdFormat.MREC == adFormat ) ? "OnMRecAdCollapsedEvent" : "OnBannerAdCollapsedEvent", getAdInfo( ad ) );
     }
 
- @Override
+    @Override
     public void onAdRevenuePaid(final MaxAd ad)
     {
         final MaxAdFormat adFormat = ad.getFormat();
@@ -1434,6 +1485,48 @@ public class AppLovinMAXModule
         } );
     }
 
+    private void startAutoRefresh(final String adUnitId, final MaxAdFormat adFormat)
+    {
+        getReactApplicationContext().runOnUiQueueThread( new Runnable()
+        {
+            @Override
+            public void run()
+            {
+                d( "Starting auto refresh " + adFormat.getLabel() + " with ad unit id \"" + adUnitId + "\"" );
+
+                final MaxAdView adView = retrieveAdView( adUnitId, adFormat );
+                if ( adView == null )
+                {
+                    e( adFormat.getLabel() + " does not exist" );
+                    return;
+                }
+
+                adView.startAutoRefresh();
+            }
+        } );
+    }
+
+    private void stopAutoRefresh(final String adUnitId, final MaxAdFormat adFormat)
+    {
+        getReactApplicationContext().runOnUiQueueThread( new Runnable()
+        {
+            @Override
+            public void run()
+            {
+                d( "Stopping auto refresh " + adFormat.getLabel() + " with ad unit id \"" + adUnitId + "\"" );
+
+                final MaxAdView adView = retrieveAdView( adUnitId, adFormat );
+                if ( adView == null )
+                {
+                    e( adFormat.getLabel() + " does not exist" );
+                    return;
+                }
+
+                adView.stopAutoRefresh();
+            }
+        } );
+    }
+
     @Nullable
     private MaxInterstitialAd retrieveInterstitial(String adUnitId)
     {
@@ -1486,6 +1579,9 @@ public class AppLovinMAXModule
             result.setListener( this );
             result.setRevenueListener( this );
 
+            // Set this extra parameter to work around a SDK bug that ignores calls to stopAutoRefresh()
+            result.setExtraParameter( "allow_pause_auto_refresh_immediately", "true" );
+
             mAdViews.put( adUnitId, result );
             mAdViewPositions.put( adUnitId, adViewPosition );
             mAdViewOffsets.put( adUnitId, adViewOffsetPixels );
@@ -1629,6 +1725,18 @@ public class AppLovinMAXModule
         relativeLayout.setPadding( adViewOffset.x, adViewOffset.y, adViewOffset.x, adViewOffset.y );
     }
 
+    private void setPendingExtraParametersIfNeeded(final AppLovinSdkSettings settings)
+    {
+        if ( extraParametersToSet.size() <= 0 ) return;
+
+        for ( final String key : extraParametersToSet.keySet() )
+        {
+            settings.setExtraParameter( key, extraParametersToSet.get( key ) );
+        }
+
+        extraParametersToSet.clear();
+    }
+
     // Utility Methods
 
     private void logInvalidAdFormat(MaxAdFormat adFormat)
@@ -1722,6 +1830,7 @@ public class AppLovinMAXModule
         adInfo.putString( "placement", !TextUtils.isEmpty( ad.getPlacement() ) ? ad.getPlacement() : "" );
         adInfo.putDouble( "revenue", ad.getRevenue() );
         adInfo.putMap( "waterfall", createAdWaterfallInfo( ad.getWaterfall() ) );
+        adInfo.putString( "dspName", !TextUtils.isEmpty( ad.getDspName() ) ? ad.getDspName() : "" );
 
         return adInfo;
     }
@@ -1769,8 +1878,11 @@ public class AppLovinMAXModule
         WritableMap credentials = Arguments.createMap();
         for ( String key : credentialBundle.keySet() )
         {
-            String value = credentialBundle.getString( key, "" );
-            credentials.putString( key, value );
+            Object obj = credentialBundle.get( key );
+            if ( obj instanceof String )
+            {
+                credentials.putString( key, (String) obj );
+            }
         }
         networkResponseObject.putMap( "credentials", credentials );
 
@@ -1790,6 +1902,37 @@ public class AppLovinMAXModule
         return networkResponseObject;
     }
 
+    // Lifecycle Events
+
+    @Override
+    public void onHostResume() { }
+
+    @Override
+    public void onHostPause() { }
+
+    @Override
+    public void onHostDestroy()
+    {
+        // Make copy because `destroyAdView()` will remove from `mAdViews`
+        List<MaxAdView> adViews = new ArrayList<>( mAdViews.values() );
+        for ( MaxAdView adView : adViews )
+        {
+            destroyAdView( adView.getAdUnitId(), adView.getAdFormat() );
+        }
+
+        for ( MaxInterstitialAd interstitialAd : mInterstitials.values() )
+        {
+            interstitialAd.destroy();
+        }
+        mInterstitials.clear();
+
+        for ( MaxRewardedAd rewardedAd : mRewardedAds.values() )
+        {
+            rewardedAd.destroy();
+        }
+        mRewardedAds.clear();
+    }
+
     // React Native Bridge
 
     private void sendReactNativeEvent(final String name, @Nullable final WritableMap params)

package/ios/AppLovinMAX.m

@@ -40,6 +40,9 @@
 @property (nonatomic, strong, nullable) NSArray<NSString *> *testDeviceIdentifiersToSet;
 @property (nonatomic, strong, nullable) NSNumber *verboseLoggingToSet;
 @property (nonatomic, strong, nullable) NSNumber *creativeDebuggerEnabledToSet;
+@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;
@@ -108,6 +111,7 @@ RCT_EXPORT_MODULE()
         self.adViewConstraints = [NSMutableDictionary dictionaryWithCapacity: 2];
         self.adUnitIdentifiersToShowAfterCreate = [NSMutableArray arrayWithCapacity: 2];
         self.disabledAdaptiveBannerAdUnitIdentifiers = [NSMutableSet setWithCapacity: 2];
+        self.extraParametersToSet = [NSMutableDictionary dictionaryWithCapacity: 8];
         
         self.safeAreaBackground = [[UIView alloc] init];
         self.safeAreaBackground.hidden = YES;
@@ -194,6 +198,15 @@ RCT_EXPORT_METHOD(initialize:(NSString *)pluginVersion :(NSString *)sdkKey :(RCT
         self.creativeDebuggerEnabledToSet = nil;
     }
     
+    // Set location collection enabled if needed
+    if ( self.locationCollectionEnabledToSet )
+    {
+        self.sdk.settings.locationCollectionEnabled = self.locationCollectionEnabledToSet.boolValue;
+        self.locationCollectionEnabledToSet = nil;
+    }
+        
+    [self setPendingExtraParametersIfNeeded: self.sdk.settings];
+
     [self.sdk initializeSdkWithCompletionHandler:^(ALSdkConfiguration *configuration)
      {
         [self log: @"SDK initialized"];
@@ -215,7 +228,7 @@ RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isTablet)
 
 RCT_EXPORT_METHOD(showMediationDebugger)
 {
-    if ( !_sdk )
+    if ( !self.sdk )
     {
         [self logUninitializedAccessError: @"showMediationDebugger"];
         return;
@@ -334,6 +347,26 @@ RCT_EXPORT_METHOD(setCreativeDebuggerEnabled:(BOOL)enabled)
     }
 }
 
+RCT_EXPORT_METHOD(setExtraParameter:(NSString *)key :(nullable NSString *)value)
+{
+    if ( ![key al_isValidString] )
+    {
+        [self log: @"[%@] Failed to set extra parameter for nil or empty key: %@", TAG, key];
+        return;
+    }
+
+    if ( self.sdk )
+    {
+        ALSdkSettings *settings = self.sdk.settings;
+        [settings setExtraParameterForKey: key value: value];
+        [self setPendingExtraParametersIfNeeded: settings];
+    }
+    else
+    {
+        self.extraParametersToSet[key] = value;
+    }
+}
+
 RCT_EXPORT_METHOD(setConsentFlowEnabled:(BOOL)enabled)
 {
     self.consentFlowEnabledToSet = @(enabled);
@@ -351,20 +384,9 @@ RCT_EXPORT_METHOD(setTermsOfServiceUrl:(NSString *)urlString)
 
 #pragma mark - Data Passing
 
-RCT_EXPORT_METHOD(setUserSegment:(nullable NSString *)name)
-{
-    if ( !_sdk )
-    {
-        [self logUninitializedAccessError: @"setUserSegment"];
-        return;
-    }
-
-    self.sdk.userSegment.name = name;
-}
-
 RCT_EXPORT_METHOD(setTargetingDataYearOfBirth:(nonnull NSNumber *)yearOfBirth)
 {
-    if ( !_sdk )
+    if ( !self.sdk )
     {
         [self logUninitializedAccessError: @"setTargetingDataYearOfBirth"];
         return;
@@ -375,7 +397,7 @@ RCT_EXPORT_METHOD(setTargetingDataYearOfBirth:(nonnull NSNumber *)yearOfBirth)
 
 RCT_EXPORT_METHOD(setTargetingDataGender:(nullable NSString *)gender)
 {
-    if ( !_sdk )
+    if ( !self.sdk )
     {
         [self logUninitializedAccessError: @"setTargetingDataGender"];
         return;
@@ -401,7 +423,7 @@ RCT_EXPORT_METHOD(setTargetingDataGender:(nullable NSString *)gender)
 
 RCT_EXPORT_METHOD(setTargetingDataMaximumAdContentRating:(nonnull NSNumber *)maximumAdContentRating)
 {
-    if ( !_sdk )
+    if ( !self.sdk )
     {
         [self logUninitializedAccessError: @"setTargetingDataMaximumAdContentRating"];
         return;
@@ -429,7 +451,7 @@ RCT_EXPORT_METHOD(setTargetingDataMaximumAdContentRating:(nonnull NSNumber *)max
 
 RCT_EXPORT_METHOD(setTargetingDataEmail:(nullable NSString *)email)
 {
-    if ( !_sdk )
+    if ( !self.sdk )
     {
         [self logUninitializedAccessError: @"setTargetingDataEmail"];
         return;
@@ -440,7 +462,7 @@ RCT_EXPORT_METHOD(setTargetingDataEmail:(nullable NSString *)email)
 
 RCT_EXPORT_METHOD(setTargetingDataPhoneNumber:(nullable NSString *)phoneNumber)
 {
-    if ( !_sdk )
+    if ( !self.sdk )
     {
         [self logUninitializedAccessError: @"setTargetingDataPhoneNumber"];
         return;
@@ -451,7 +473,7 @@ RCT_EXPORT_METHOD(setTargetingDataPhoneNumber:(nullable NSString *)phoneNumber)
 
 RCT_EXPORT_METHOD(setTargetingDataKeywords:(nullable NSArray<NSString *> *)keywords)
 {
-    if ( !_sdk )
+    if ( !self.sdk )
     {
         [self logUninitializedAccessError: @"setTargetingDataKeywords"];
         return;
@@ -462,7 +484,7 @@ RCT_EXPORT_METHOD(setTargetingDataKeywords:(nullable NSArray<NSString *> *)keywo
 
 RCT_EXPORT_METHOD(setTargetingDataInterests:(nullable NSArray<NSString *> *)interests)
 {
-    if ( !_sdk )
+    if ( !self.sdk )
     {
         [self logUninitializedAccessError: @"setTargetingDataInterests"];
         return;
@@ -473,7 +495,7 @@ RCT_EXPORT_METHOD(setTargetingDataInterests:(nullable NSArray<NSString *> *)inte
 
 RCT_EXPORT_METHOD(clearAllTargetingData)
 {
-    if ( !_sdk )
+    if ( !self.sdk )
     {
         [self logUninitializedAccessError: @"clearAllTargetingData"];
         return;
@@ -482,15 +504,17 @@ RCT_EXPORT_METHOD(clearAllTargetingData)
     [self.sdk.targetingData clearAll];
 }
 
-RCT_EXPORT_METHOD(setLocationCollectionEnabled:(BOOL)locationCollectionEnabled)
+RCT_EXPORT_METHOD(setLocationCollectionEnabled:(BOOL)enabled)
 {
-    if ( !_sdk )
+    if ( [self isPluginInitialized] )
     {
-        [self logUninitializedAccessError: @"setLocationCollectionEnabled"];
-        return;
+        self.sdk.settings.locationCollectionEnabled = enabled;
+        self.locationCollectionEnabledToSet = nil;
+    }
+    else
+    {
+        self.locationCollectionEnabledToSet = @(enabled);
     }
-    
-    self.sdk.settings.locationCollectionEnabled = locationCollectionEnabled;
 }
 
 #pragma mark - Event Tracking
@@ -548,6 +572,16 @@ RCT_EXPORT_METHOD(setBannerExtraParameter:(NSString *)adUnitIdentifier :(NSStrin
     [self setAdViewExtraParameterForAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT key: key value: value];
 }
 
+RCT_EXPORT_METHOD(startBannerAutoRefresh:(NSString *)adUnitIdentifier)
+{
+    [self startAutoRefresh: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
+}
+
+RCT_EXPORT_METHOD(stopBannerAutoRefresh:(NSString *)adUnitIdentifier)
+{
+    [self stopAutoRefresh: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
+}
+
 RCT_EXPORT_METHOD(showBanner:(NSString *)adUnitIdentifier)
 {
     [self showAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: DEVICE_SPECIFIC_ADVIEW_AD_FORMAT];
@@ -590,6 +624,16 @@ RCT_EXPORT_METHOD(updateMRecPosition:(NSString *)mrecPosition :(NSString *)adUni
     [self updateAdViewPosition: mrecPosition withOffset: CGPointZero forAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec];
 }
 
+RCT_EXPORT_METHOD(startMRecAutoRefresh:(NSString *)adUnitIdentifier)
+{
+    [self startAutoRefresh: adUnitIdentifier adFormat: MAAdFormat.mrec];
+}
+
+RCT_EXPORT_METHOD(stopMRecAutoRefresh:(NSString *)adUnitIdentifier)
+{
+    [self stopAutoRefresh: adUnitIdentifier adFormat: MAAdFormat.mrec];
+}
+
 RCT_EXPORT_METHOD(showMRec:(NSString *)adUnitIdentifier)
 {
     [self showAdViewWithAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.mrec];
@@ -1052,6 +1096,28 @@ RCT_EXPORT_METHOD(setRewardedAdExtraParameter:(NSString *)adUnitIdentifier :(NSS
     });
 }
 
+- (void)startAutoRefresh:(NSString *)adUnitIdentifier adFormat:(MAAdFormat *)adFormat
+{
+    dispatch_async(dispatch_get_main_queue(), ^{
+        
+        [self log: @"Starting auto refresh \"%@\" with ad unit identifier \"%@\"", adFormat, adUnitIdentifier];
+        
+        MAAdView *view = [self retrieveAdViewForAdUnitIdentifier: adUnitIdentifier adFormat: adFormat];
+        [view startAutoRefresh];
+    });
+}
+
+- (void)stopAutoRefresh:(NSString *)adUnitIdentifier adFormat:(MAAdFormat *)adFormat
+{
+    dispatch_async(dispatch_get_main_queue(), ^{
+        
+        [self log: @"Stopping auto refresh \"%@\" with ad unit identifier \"%@\"", adFormat, adUnitIdentifier];
+        
+        MAAdView *view = [self retrieveAdViewForAdUnitIdentifier: adUnitIdentifier adFormat: adFormat];
+        [view stopAutoRefresh];
+    });
+}
+
 - (void)showAdViewWithAdUnitIdentifier:(NSString *)adUnitIdentifier adFormat:(MAAdFormat *)adFormat
 {
     dispatch_async(dispatch_get_main_queue(), ^{
@@ -1155,6 +1221,9 @@ RCT_EXPORT_METHOD(setRewardedAdExtraParameter:(NSString *)adUnitIdentifier :(NSS
         result.userInteractionEnabled = NO;
         result.translatesAutoresizingMaskIntoConstraints = NO;
         
+        // Set this extra parameter to work around a SDK bug that ignores calls to stopAutoRefresh()
+        [result setExtraParameterForKey: @"allow_pause_auto_refresh_immediately" value: @"true"];
+
         self.adViews[adUnitIdentifier] = result;
         self.adViewPositions[adUnitIdentifier] = adViewPosition;
         self.adViewOffsets[adUnitIdentifier] = [NSValue valueWithCGPoint: offset];
@@ -1359,6 +1428,18 @@ RCT_EXPORT_METHOD(setRewardedAdExtraParameter:(NSString *)adUnitIdentifier :(NSS
     [NSLayoutConstraint activateConstraints: constraints];
 }
 
+- (void)setPendingExtraParametersIfNeeded:(ALSdkSettings *)settings
+{
+    if ( self.extraParametersToSet.count <= 0 ) return;
+    
+    for ( NSString *key in self.extraParametersToSet.allKeys )
+    {
+        [settings setExtraParameterForKey: key value: self.extraParametersToSet[key]];
+    }
+
+    [self.extraParametersToSet removeAllObjects];
+}
+
 - (void)logInvalidAdFormat:(MAAdFormat *)adFormat
 {
     [self log: @"invalid ad format: %@, from %@", adFormat, [NSThread callStackSymbols]];
@@ -1388,7 +1469,8 @@ RCT_EXPORT_METHOD(setRewardedAdExtraParameter:(NSString *)adUnitIdentifier :(NSS
              @"networkName" : ad.networkName,
              @"placement" : ad.placement ?: @"",
              @"revenue" : @(ad.revenue),
-             @"waterfall": [self createAdWaterfallInfo: ad.waterfall]};
+             @"waterfall": [self createAdWaterfallInfo: ad.waterfall],
+             @"dspName" : ad.DSPName ?: @""};
 }
 
 #pragma mark - Waterfall Information

package/ios/AppLovinMAXAdViewManager.m

@@ -27,6 +27,7 @@
 @property (nonatomic, strong) NSMutableDictionary<NSNumber *, NSString *> *placementRegistry;
 @property (nonatomic, strong) NSMutableDictionary<NSNumber *, NSString *> *customDataRegistry;
 @property (nonatomic, strong) NSMutableDictionary<NSNumber *, NSString *> *adaptiveBannerEnabledRegistry;
+@property (nonatomic, strong) NSMutableDictionary<NSNumber *, NSNumber *> *autoRefreshEnabledRegistry;
 
 @end
 
@@ -49,6 +50,7 @@ RCT_EXPORT_MODULE(AppLovinMAXAdView)
         self.placementRegistry = [NSMutableDictionary dictionary];
         self.customDataRegistry = [NSMutableDictionary dictionary];
         self.adaptiveBannerEnabledRegistry = [NSMutableDictionary dictionary];
+        self.autoRefreshEnabledRegistry = [NSMutableDictionary dictionary];
     }
     return self;
 }
@@ -134,6 +136,38 @@ RCT_EXPORT_METHOD(setAdaptiveBannerEnabled:(nonnull NSNumber *)viewTag toEnabled
     }];
 }
 
+// NOTE: `nonnull` must be annotated here for this RN export to work at runtime
+RCT_EXPORT_METHOD(setAutoRefresh:(nonnull NSNumber *)viewTag toEnabled:(BOOL)enabled)
+{
+    [self.bridge.uiManager addUIBlock:^(RCTUIManager *uiManager, NSDictionary<NSNumber *, UIView *> *viewRegistry) {
+        
+        // NOTE: iOS caches the native view via `viewTag` when you remove it from screen (unlike Android)
+        UIView *view = viewRegistry[viewTag];
+        if ( !view )
+        {
+            RCTLogError(@"Cannot find UIView with tag %@", viewTag);
+            return;
+        }
+        
+        MAAdView *adView = [self adViewFromContainerView: view];
+        if ( adView )
+        {
+            if ( enabled )
+            {
+                [adView startAutoRefresh];
+            }
+            else
+            {
+                [adView stopAutoRefresh];
+            }
+        }
+        else
+        {
+            self.autoRefreshEnabledRegistry[viewTag] = @(enabled);
+        }
+    }];
+}
+
 // NOTE: `nonnull` must be annotated here for this RN export to work at runtime
 RCT_EXPORT_METHOD(setAdUnitId:(nonnull NSNumber *)viewTag toAdUnitId:(NSString *)adUnitId)
 {
@@ -230,6 +264,22 @@ RCT_EXPORT_METHOD(setAdFormat:(nonnull NSNumber *)viewTag toAdFormat:(NSString *
                 [adView setExtraParameterForKey: @"adaptive_banner" value: adaptiveBannerEnabledStr];
             }
             
+            // Set this extra parameter to work around a SDK bug that ignores calls to stopAutoRefresh()
+            [adView setExtraParameterForKey: @"allow_pause_auto_refresh_immediately" value: @"true"];
+
+            NSNumber *autoRefreshEnabled = self.autoRefreshEnabledRegistry[viewTag];
+            if ( autoRefreshEnabled )
+            {
+                if ( [autoRefreshEnabled boolValue] )
+                {
+                    [adView startAutoRefresh];
+                }
+                else
+                {
+                    [adView stopAutoRefresh];
+                }
+            }
+
             [adView loadAd];
             
             [containerView addSubview: adView];

package/ios/Podfile

@@ -35,6 +35,6 @@ target 'AppLovinMAX' do
   pod 'glog', :podspec => '../node_modules/react-native/third-party-podspecs/glog.podspec'
   pod 'Folly', :podspec => '../node_modules/react-native/third-party-podspecs/Folly.podspec'
 
-  pod 'AppLovinSDK', '11.4.2'
+  pod 'AppLovinSDK', '11.4.3'
 
 end

package/ios/Podfile.lock

@@ -1,5 +1,5 @@
 PODS:
-  - AppLovinSDK (11.4.2)
+  - AppLovinSDK (11.4.3)
   - boost-for-react-native (1.63.0)
   - DoubleConversion (1.1.6)
   - FBLazyVector (0.63.4)
@@ -249,7 +249,7 @@ PODS:
   - Yoga (1.14.0)
 
 DEPENDENCIES:
-  - AppLovinSDK (= 11.4.2)
+  - AppLovinSDK (= 11.4.3)
   - DoubleConversion (from `../node_modules/react-native/third-party-podspecs/DoubleConversion.podspec`)
   - FBLazyVector (from `../node_modules/react-native/Libraries/FBLazyVector`)
   - FBReactNativeSpec (from `../node_modules/react-native/Libraries/FBReactNativeSpec`)
@@ -339,7 +339,7 @@ EXTERNAL SOURCES:
     :path: "../node_modules/react-native/ReactCommon/yoga"
 
 SPEC CHECKSUMS:
-  AppLovinSDK: 119a0b2a743f9d9c6002c58776b1013778a65084
+  AppLovinSDK: 221dfbdff620be0ff227ed5b018b97b1f3d15713
   boost-for-react-native: 39c7adb57c4e60d6c5479dd8623128eb5b3f0f2c
   DoubleConversion: cde416483dac037923206447da6e1454df403714
   FBLazyVector: 3bb422f41b18121b71783a905c10e58606f7dc3e
@@ -368,6 +368,6 @@ SPEC CHECKSUMS:
   ReactCommon: 73d79c7039f473b76db6ff7c6b159c478acbbb3b
   Yoga: 4bd86afe9883422a7c4028c00e34790f560923d6
 
-PODFILE CHECKSUM: 485c4fe7a35ea71547f789315321ae261127772e
+PODFILE CHECKSUM: 26bc18f6057a79b7f583981eaa607d7b30a63d74
 
 COCOAPODS: 1.11.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-applovin-max",
   "author": "AppLovin Corporation",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "AppLovin MAX React Native Plugin for Android and iOS",
   "homepage": "https://github.com/AppLovin/AppLovin-MAX-React-Native",
   "license": "MIT",

package/react-native-applovin-max.podspec

@@ -11,10 +11,10 @@ Pod::Spec.new do |s|
   s.authors      = package["author"]
 
   s.platforms    = { :ios => "10.0" }
-  s.source       = { :git => "https://github.com/AppLovin/AppLovin-MAX-React-Native.git", :tag => "release_3_2_0" }
+  s.source       = { :git => "https://github.com/AppLovin/AppLovin-MAX-React-Native.git", :tag => "release_3_3_0" }
   
   s.source_files  = "ios/AppLovinMAX*.{h,m}"
 
   s.dependency "React"
-  s.dependency "AppLovinSDK", "11.4.2"
+  s.dependency "AppLovinSDK", "11.4.3"
 end

package/src/AppLovinMAXAdView.js

@@ -1,7 +1,53 @@
-import { requireNativeComponent, UIManager, findNodeHandle } from "react-native";
+import { NativeModules, requireNativeComponent, UIManager, findNodeHandle, View, Text, StyleSheet } from "react-native";
 import PropTypes from "prop-types";
 import React from "react";
-import AppLovinMAX from "./index.js";
+
+const { AppLovinMAX } = NativeModules;
+
+export const AdFormat = {
+  BANNER: "banner",
+  MREC: "mrec",
+};
+
+export const AdViewPosition = {
+  TOP_CENTER: "top_center",
+  TOP_LEFT: "top_left",
+  TOP_RIGHT: "top_right",
+  CENTERED: "centered",
+  CENTER_LEFT: "center_left",
+  CENTER_RIGHT: "center_right",
+  BOTTOM_LEFT: "bottom_left",
+  BOTTOM_CENTER: "bottom_center",
+  BOTTOM_RIGHT: "bottom_right",
+};
+
+const AdViewWrapper = (props) => {
+  const {style, ...rest} = props;
+  return (
+    AppLovinMAX.isInitialized() ?
+      <AdView {...style} {...rest}/>
+    :
+      <View style={[styles.container, style]} {...rest}>
+        {
+          console.warn('[AppLovinSdk] [AppLovinMAX] <AdView/> has been mounted before AppLovin initialization')
+        } 
+      </View>
+  )
+};
+
+const styles = StyleSheet.create({
+  container: {
+    flexDirection: 'column',
+    justifyContent: 'flex-end',
+    alignItems: 'center',
+    backgroundColor: 'black',
+    borderColor: 'whitesmoke',
+    borderWidth: 1,
+  },
+  message: {
+    color: 'white',
+  },
+});
 
 class AdView extends React.Component {
 
@@ -15,6 +61,7 @@ class AdView extends React.Component {
     this.setPlacement(this.props.placement);
     this.setCustomData(this.props.customData);
     this.setAdaptiveBannerEnabled(this.props.adaptiveBannerEnabled);
+    this.setAutoRefresh(this.props.autoRefresh);
   }
 
   componentDidUpdate(prevProps) {
@@ -38,6 +85,10 @@ class AdView extends React.Component {
     if (prevProps.adaptiveBannerEnabled !== this.props.adaptiveBannerEnabled) {
       this.setAdaptiveBannerEnabled(this.props.adaptiveBannerEnabled);
     }
+
+    if (prevProps.autoRefresh !== this.props.autoRefresh) {
+      this.setAutoRefresh(this.props.autoRefresh);
+    }
   }
 
   render() {
@@ -52,7 +103,7 @@ class AdView extends React.Component {
   // Helper Functions
 
   sizeForAdFormat(adFormat) {
-    if (adFormat === AppLovinMAX.AdFormat.BANNER) {
+    if (adFormat === AdFormat.BANNER) {
 
       var width = AppLovinMAX.isTablet() ? 728 : 320;
       var height;
@@ -120,7 +171,7 @@ class AdView extends React.Component {
     // If the ad unit id or ad format are unset, we can't set the value
     if (adUnitId == null || adFormat == null) return;
 
-    if (adFormat === AppLovinMAX.AdFormat.BANNER) {
+    if (adFormat === AdFormat.BANNER) {
       if (enabled === true || enabled === false) {
         UIManager.dispatchViewManagerCommand(
             findNodeHandle(this),
@@ -130,6 +181,22 @@ class AdView extends React.Component {
       }
     }
   }
+
+  setAutoRefresh(enabled) {
+    var adUnitId = this.props.adUnitId;
+    var adFormat = this.props.adFormat;
+
+    // If the ad unit id or ad format are unset, we can't set the autorefresh.
+    if (adUnitId == null || adFormat == null) return;
+
+    if (enabled === true || enabled === false) {
+      UIManager.dispatchViewManagerCommand(
+        findNodeHandle(this),
+        Platform.OS === 'android' ? "setAutoRefresh" : UIManager.getViewManagerConfig("AppLovinMAXAdView").Commands.setAutoRefresh,
+        [enabled]
+      );
+    }
+  }
 }
 
 AdView.propTypes = {
@@ -157,9 +224,14 @@ AdView.propTypes = {
    * A boolean value representing whether or not to enable adaptive banners. Note that adaptive banners are enabled by default as of v2.3.0.
    */
   adaptiveBannerEnabled: PropTypes.bool,
+
+  /**
+   * A boolean value representing whether or not to enable auto-refresh. Note that auto-refresh is enabled by default.
+   */
+  autoRefresh: PropTypes.bool,
 };
 
 // requireNativeComponent automatically resolves 'AppLovinMAXAdView' to 'AppLovinMAXAdViewManager'
 var AppLovinMAXAdView = requireNativeComponent("AppLovinMAXAdView", AdView);
 
-export default AdView;
+export default AdViewWrapper;

package/src/TargetingData.js

@@ -1,4 +1,6 @@
-import AppLovinMAX from "./index.js";
+import { NativeModules } from "react-native";
+
+const { AppLovinMAX } = NativeModules;
 
 const AdContentRating = {
   None:               0,

package/src/index.js

@@ -1,11 +1,10 @@
 import { NativeModules, NativeEventEmitter } from "react-native";
-import AdView from "./AppLovinMAXAdView";
+import AdView, { AdFormat, AdViewPosition } from "./AppLovinMAXAdView";
 import { TargetingData as targetingData, AdContentRating, UserGender } from "./TargetingData";
-import { UserSegment as userSegment } from "./UserSegment";
 
 const { AppLovinMAX } = NativeModules;
 
-const VERSION = "3.2.0";
+const VERSION = "3.3.0";
 
 /**
  * This enum represents whether or not the consent dialog should be shown for this user.
@@ -28,25 +27,6 @@ const ConsentDialogState = {
   DOES_NOT_APPLY: 2,
 };
 
-const AdFormat = {
-  BANNER: "banner",
-  MREC: "mrec",
-};
-
-const AdViewPosition = {
-  TOP_CENTER: "top_center",
-  TOP_LEFT: "top_left",
-  TOP_RIGHT: "top_right",
-  CENTERED: "centered",
-  CENTER_LEFT: "center_left",
-  CENTER_RIGHT: "center_right",
-  BOTTOM_LEFT: "bottom_left",
-  BOTTOM_CENTER: "bottom_center",
-  BOTTOM_RIGHT: "bottom_right",
-};
-
-// const AdView = AppLovinMAXAdView;
-
 const emitter = new NativeEventEmitter(AppLovinMAX);
 const subscriptions = {};
 
@@ -104,7 +84,6 @@ const showRewardedAd = (adUnitId, ...args) => {
 export default {
   ...AppLovinMAX,
   AdView,
-  userSegment,
   targetingData,
   AdContentRating,
   UserGender,

package/src/UserSegment.js

@@ -1,12 +0,0 @@
-import AppLovinMAX from "./index.js";
-
-let UserSegment = {
-
-  set name(value) {
-    AppLovinMAX.setUserSegment(value);
-  },
-};
-
-export {
-  UserSegment,
-};