react-native-applovin-max 6.2.2 → 6.3.0

package/android/build.gradle

@@ -35,8 +35,8 @@ android {
   defaultConfig {
     minSdkVersion 16
     targetSdkVersion getExtOrIntegerDefault('targetSdkVersion')
-    versionCode 6020200
-    versionName "6.2.2"
+    versionCode 6030000
+    versionName "6.3.0"
   }
 
   flavorDimensions("default")
@@ -140,5 +140,5 @@ dependencies {
   // noinspection GradleDynamicVersion
   api 'com.facebook.react:react-native:+'
 
-  implementation 'com.applovin:applovin-sdk:12.1.0'
+  implementation 'com.applovin:applovin-sdk:12.2.0'
 }

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

@@ -43,6 +43,7 @@ class AppLovinMAXAdView
     private String              customData;
     private boolean             adaptiveBannerEnabled;
     private boolean             autoRefresh;
+    private boolean             loadOnMount;
     @Nullable
     private Map<String, Object> extraParameters;
     @Nullable
@@ -146,6 +147,11 @@ class AppLovinMAXAdView
         }
     }
 
+    public void setLoadOnMount(final boolean enabled)
+    {
+        loadOnMount = enabled;
+    }
+
     public void setExtraParameters(@Nullable final ReadableMap readableMap)
     {
         if ( readableMap != null )
@@ -273,7 +279,10 @@ class AppLovinMAXAdView
                 adView.stopAutoRefresh();
             }
 
-            adView.loadAd();
+            if ( loadOnMount )
+            {
+                adView.loadAd();
+            }
 
             addView( adView );
 
@@ -281,6 +290,17 @@ class AppLovinMAXAdView
         }, 250 );
     }
 
+    public void loadAd()
+    {
+        if ( adView == null )
+        {
+            AppLovinMAXModule.e( "Attempting to load uninitialized MaxAdView for " + adUnitId );
+            return;
+        }
+
+        adView.loadAd();
+    }
+
     public void destroy()
     {
         if ( adView != null )

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

@@ -1,6 +1,7 @@
 package com.applovin.reactnative;
 
 import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.common.MapBuilder;
 import com.facebook.react.uimanager.SimpleViewManager;
@@ -9,6 +10,7 @@ import com.facebook.react.uimanager.annotations.ReactProp;
 
 import java.util.Map;
 
+import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
 /**
@@ -17,6 +19,8 @@ import androidx.annotation.Nullable;
 class AppLovinMAXAdViewManager
         extends SimpleViewManager<AppLovinMAXAdView>
 {
+    private static final int COMMAND_LOAD_AD = 1;
+
     public AppLovinMAXAdViewManager(final ReactApplicationContext reactApplicationContext) { }
 
     @Override
@@ -41,6 +45,26 @@ class AppLovinMAXAdViewManager
                 .build();
     }
 
+    @Nullable
+    @Override
+    public Map<String, Integer> getCommandsMap()
+    {
+        return MapBuilder.of(
+                "loadAd", COMMAND_LOAD_AD
+        );
+    }
+
+    @Override
+    public void receiveCommand(@NonNull final AppLovinMAXAdView view, final int commandId, @Nullable final ReadableArray args)
+    {
+        switch ( commandId )
+        {
+            case COMMAND_LOAD_AD:
+                view.loadAd();
+                break;
+        }
+    }
+
     @Override
     protected AppLovinMAXAdView createViewInstance(final ThemedReactContext reactContext)
     {
@@ -84,6 +108,12 @@ class AppLovinMAXAdViewManager
         view.setAutoRefresh( enabled );
     }
 
+    @ReactProp(name = "loadOnMount")
+    public void setLoadOnMount(final AppLovinMAXAdView view, final boolean enabled)
+    {
+        view.setLoadOnMount( enabled );
+    }
+
     @ReactProp(name = "extraParameters")
     public void setExtraParameters(final AppLovinMAXAdView view, @Nullable final ReadableMap value)
     {

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

@@ -270,7 +270,11 @@ public class AppLovinMAXModule
     private void performInitialization(final String pluginVersion, final String sdkKey, final Context context, final Promise promise)
     {
         // Guard against running init logic multiple times
-        if ( isPluginInitialized ) return;
+        if ( isPluginInitialized )
+        {
+            promise.resolve( getInitializationMessage() );
+            return;
+        }
 
         isPluginInitialized = true;
 
@@ -457,15 +461,25 @@ public class AppLovinMAXModule
                     }
                 }.enable();
 
-                WritableMap sdkConfiguration = Arguments.createMap();
-                sdkConfiguration.putString( "countryCode", configuration.getCountryCode() );
-                sdkConfiguration.putString( "consentFlowUserGeography", getRawAppLovinConsentFlowUserGeography( configuration.getConsentFlowUserGeography() ) );
-                sdkConfiguration.putBoolean( "isTestModeEnabled", configuration.isTestModeEnabled() );
-                promise.resolve( sdkConfiguration );
+                promise.resolve( getInitializationMessage() );
             }
         } );
     }
 
+    private WritableMap getInitializationMessage()
+    {
+        WritableMap message = Arguments.createMap();
+
+        if ( sdkConfiguration != null )
+        {
+            message.putString( "countryCode", sdkConfiguration.getCountryCode() );
+            message.putString( "consentFlowUserGeography", getRawAppLovinConsentFlowUserGeography( sdkConfiguration.getConsentFlowUserGeography() ) );
+            message.putBoolean( "isTestModeEnabled", sdkConfiguration.isTestModeEnabled() );
+        }
+
+        return message;
+    }
+
     // General Public API
 
     @ReactMethod
@@ -673,7 +687,7 @@ public class AppLovinMAXModule
     @ReactMethod
     public void showCmpForExistingUser(final Promise promise)
     {
-        if ( sdk == null )
+        if ( !isPluginInitialized )
         {
             logUninitializedAccessError( "showCmpForExistingUser", promise );
             return;
@@ -686,8 +700,7 @@ public class AppLovinMAXModule
             return;
         }
 
-        AppLovinCmpService cmpService = sdk.getCmpService();
-        cmpService.showCmpForExistingUser( currentActivity, (@Nullable final AppLovinCmpError error) -> {
+        sdk.getCmpService().showCmpForExistingUser( currentActivity, (@Nullable final AppLovinCmpError error) -> {
 
             if ( error == null )
             {
@@ -695,21 +708,25 @@ public class AppLovinMAXModule
                 return;
             }
 
-            promise.resolve( error.getCmpCode() );
+            WritableMap params = Arguments.createMap();
+            params.putInt( "code", error.getCode().getValue() );
+            params.putString( "message", error.getMessage() );
+            params.putInt( "cmpCode", error.getCmpCode() );
+            params.putString( "cmpMessage", error.getCmpMessage() );
+            promise.resolve( params );
         } );
     }
 
     @ReactMethod
     public void hasSupportedCmp(final Promise promise)
     {
-        if ( sdk == null )
+        if ( !isPluginInitialized )
         {
             logUninitializedAccessError( "showCmpForExistingUser", promise );
             return;
         }
 
-        AppLovinCmpService cmpService = sdk.getCmpService();
-        promise.resolve( cmpService.hasSupportedCmp() );
+        promise.resolve( sdk.getCmpService().hasSupportedCmp() );
     }
 
     // Data Passing
@@ -1538,7 +1555,7 @@ public class AppLovinMAXModule
     {
         String name;
         MaxAdFormat adFormat = ad.getFormat();
-        if ( MaxAdFormat.BANNER == adFormat || MaxAdFormat.LEADER == adFormat || MaxAdFormat.MREC == adFormat )
+        if ( adFormat.isAdViewAd() )
         {
             name = ( MaxAdFormat.MREC == adFormat ) ? ON_MREC_AD_LOADED_EVENT : ON_BANNER_AD_LOADED_EVENT;
 
@@ -1728,7 +1745,7 @@ public class AppLovinMAXModule
     public void onAdExpanded(final MaxAd ad)
     {
         final MaxAdFormat adFormat = ad.getFormat();
-        if ( adFormat != MaxAdFormat.BANNER && adFormat != MaxAdFormat.LEADER && adFormat != MaxAdFormat.MREC )
+        if ( !adFormat.isAdViewAd() )
         {
             logInvalidAdFormat( adFormat );
             return;
@@ -1741,7 +1758,7 @@ public class AppLovinMAXModule
     public void onAdCollapsed(final MaxAd ad)
     {
         final MaxAdFormat adFormat = ad.getFormat();
-        if ( adFormat != MaxAdFormat.BANNER && adFormat != MaxAdFormat.LEADER && adFormat != MaxAdFormat.MREC )
+        if ( !adFormat.isAdViewAd() )
         {
             logInvalidAdFormat( adFormat );
             return;
@@ -2747,6 +2764,11 @@ public class AppLovinMAXModule
         setAmazonResult( result, adUnitId, MaxAdFormat.INTERSTITIAL );
     }
 
+    public void setAmazonRewardedResult(final Object result, final String adUnitId)
+    {
+        setAmazonResult( result, adUnitId, MaxAdFormat.REWARDED );
+    }
+
     private void setAmazonResult(final Object result, final String adUnitId, final MaxAdFormat adFormat)
     {
         if ( sdk == null )

package/ios/AppLovinMAX.m

@@ -206,7 +206,11 @@ RCT_EXPORT_METHOD(isInitialized:(RCTPromiseResolveBlock)resolve :(RCTPromiseReje
 RCT_EXPORT_METHOD(initialize:(NSString *)pluginVersion :(NSString *)sdkKey :(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
     // Guard against running init logic multiple times
-    if ( [self isPluginInitialized] ) return;
+    if ( [self isPluginInitialized] )
+    {
+        resolve([self initializationMessage]);
+        return;
+    }
     
     self.pluginInitialized = YES;
     
@@ -377,13 +381,25 @@ RCT_EXPORT_METHOD(initialize:(NSString *)pluginVersion :(NSString *)sdkKey :(RCT
         self.sdkConfiguration = configuration;
         self.sdkInitialized = YES;
         
-        resolve(@{@"countryCode" : self.sdk.configuration.countryCode,
-                  @"appTrackingStatus" : [self fromAppLovinAppTrackingStatus: self.sdk.configuration.appTrackingTransparencyStatus],
-                  @"consentFlowUserGeography" : [self fromAppLovinConsentFlowUserGeography: self.sdk.configuration.consentFlowUserGeography],
-                  @"isTestModeEnabled" : @(self.sdk.configuration.isTestModeEnabled)});
+        resolve([self initializationMessage]);
     }];
 }
 
+- (NSDictionary<NSString *, id> *)initializationMessage
+{
+    NSMutableDictionary<NSString *, id> *message = [NSMutableDictionary dictionaryWithCapacity: 4];
+    
+    if ( self.sdkConfiguration )
+    {
+        message[@"countryCode"] = self.sdkConfiguration.countryCode;
+        message[@"appTrackingStatus"] = [self fromAppLovinAppTrackingStatus: self.sdk.configuration.appTrackingTransparencyStatus];
+        message[@"consentFlowUserGeography"] = [self fromAppLovinConsentFlowUserGeography: self.sdk.configuration.consentFlowUserGeography];
+        message[@"isTestModeEnabled"] = @(self.sdkConfiguration.isTestModeEnabled);
+    }
+    
+    return message;
+}
+
 #pragma mark - General Public API
 
 RCT_EXPORT_METHOD(isTablet:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
@@ -556,14 +572,13 @@ RCT_EXPORT_METHOD(setConsentFlowDebugUserGeography:(NSString *)userGeography)
 
 RCT_EXPORT_METHOD(showCmpForExistingUser:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
-    if ( !self.sdk )
+    if ( ![self isPluginInitialized] )
     {
         [self logUninitializedAccessError: @"showCmpForExistingUser" withPromiseReject: reject];
         return;
     }
 
-    ALCMPService *cmpService = self.sdk.cmpService;
-    [cmpService showCMPForExistingUserWithCompletion:^(ALCMPError * _Nullable error) {
+    [self.sdk.cmpService showCMPForExistingUserWithCompletion:^(ALCMPError * _Nullable error) {
         
         if ( !error )
         {
@@ -571,20 +586,22 @@ RCT_EXPORT_METHOD(showCmpForExistingUser:(RCTPromiseResolveBlock)resolve :(RCTPr
             return;
         }
 
-        resolve(@(error.code));
+        resolve(@{@"code" : @(error.code),
+                  @"message" : error.message ?: @"",
+                  @"cmpCode" : @(error.cmpCode),
+                  @"cmpMessage" : error.cmpMessage ?: @""});
     }];
 }
 
 RCT_EXPORT_METHOD(hasSupportedCmp:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
 {
-    if ( !self.sdk )
+    if ( ![self isPluginInitialized] )
     {
         [self logUninitializedAccessError: @"hasSupportedCmp" withPromiseReject: reject];
         return;
     }
 
-    ALCMPService *cmpService = self.sdk.cmpService;
-    resolve(@([cmpService hasSupportedCMP]));
+    resolve(@([self.sdk.cmpService hasSupportedCMP]));
 }
 
 #pragma mark - Data Passing
@@ -1255,7 +1272,7 @@ RCT_EXPORT_METHOD(setAppOpenAdLocalExtraParameter:(NSString *)adUnitIdentifier :
 {
     NSString *name;
     MAAdFormat *adFormat = ad.format;
-    if ( MAAdFormat.banner == adFormat || MAAdFormat.leader == adFormat || MAAdFormat.mrec == adFormat )
+    if ( [adFormat isAdViewAd] )
     {
         MAAdView *adView = [self retrieveAdViewForAdUnitIdentifier: ad.adUnitIdentifier adFormat: adFormat];
         // An ad is now being shown, enable user interaction.
@@ -1431,7 +1448,7 @@ RCT_EXPORT_METHOD(setAppOpenAdLocalExtraParameter:(NSString *)adUnitIdentifier :
 - (void)didExpandAd:(MAAd *)ad
 {
     MAAdFormat *adFormat = ad.format;
-    if ( adFormat != MAAdFormat.banner && adFormat != MAAdFormat.leader && adFormat != MAAdFormat.mrec )
+    if ( ![adFormat isAdViewAd] )
     {
         [self logInvalidAdFormat: adFormat];
         return;
@@ -1444,7 +1461,7 @@ RCT_EXPORT_METHOD(setAppOpenAdLocalExtraParameter:(NSString *)adUnitIdentifier :
 - (void)didCollapseAd:(MAAd *)ad
 {
     MAAdFormat *adFormat = ad.format;
-    if ( adFormat != MAAdFormat.banner && adFormat != MAAdFormat.leader && adFormat != MAAdFormat.mrec )
+    if ( ![adFormat isAdViewAd] )
     {
         [self logInvalidAdFormat: adFormat];
         return;
@@ -1867,7 +1884,7 @@ RCT_EXPORT_METHOD(setAppOpenAdLocalExtraParameter:(NSString *)adUnitIdentifier :
     
     // Deactivate any previous constraints and reset visibility state so that the safe area background can be positioned again.
     [NSLayoutConstraint deactivateConstraints: self.safeAreaBackground.constraints];
-    self.safeAreaBackground.hidden = NO;
+    self.safeAreaBackground.hidden = adView.hidden;
     
     //
     // Determine ad width
@@ -2292,6 +2309,11 @@ RCT_EXPORT_METHOD(setAppOpenAdLocalExtraParameter:(NSString *)adUnitIdentifier :
     [self setAmazonResult: result forAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.interstitial];
 }
 
+- (void)setAmazonResult:(id)result forRewardedAdUnitIdentifier:(NSString *)adUnitIdentifier
+{
+    [self setAmazonResult: result forAdUnitIdentifier: adUnitIdentifier adFormat: MAAdFormat.rewarded];
+}
+
 - (void)setAmazonResult:(id /* DTBAdResponse or DTBAdErrorInfo */)result forAdUnitIdentifier:(NSString *)adUnitIdentifier adFormat:(MAAdFormat *)adFormat
 {
     if ( !self.sdk )

package/ios/AppLovinMAXAdView.h

@@ -15,6 +15,8 @@ NS_ASSUME_NONNULL_BEGIN
 
 + (MAAdView *)sharedWithAdUnitIdentifier:(NSString *)adUnitIdentifier;
 
+- (void)loadAd;
+
 @end
 
 NS_ASSUME_NONNULL_END

package/ios/AppLovinMAXAdView.m

@@ -20,6 +20,7 @@
 @property (nonatomic, copy, nullable) NSString *customData;
 @property (nonatomic, assign, readonly, getter=isAdaptiveBannerEnabled) BOOL adaptiveBannerEnabled;
 @property (nonatomic, assign, readonly, getter=isAutoRefresh) BOOL autoRefresh;
+@property (nonatomic, assign, readonly, getter=isLoadOnMount) BOOL loadOnMount;
 @property (nonatomic, copy, nullable) NSDictionary *extraParameters;
 @property (nonatomic, copy, nullable) NSDictionary *localExtraParameters;
 
@@ -135,6 +136,11 @@ static NSMutableDictionary<NSString *, MAAdView *> *adViewInstances;
     }
 }
 
+- (void)setLoadOnMount:(BOOL)loadOnMount
+{
+    _loadOnMount = loadOnMount;
+}
+
 - (void)attachAdViewIfNeeded
 {
     // Re-assign in case of race condition
@@ -202,7 +208,10 @@ static NSMutableDictionary<NSString *, MAAdView *> *adViewInstances;
             [self.adView stopAutoRefresh];
         }
         
-        [self.adView loadAd];
+        if ( [self isLoadOnMount] )
+        {
+            [self.adView loadAd];
+        }
         
         [self addSubview: self.adView];
         
@@ -215,6 +224,17 @@ static NSMutableDictionary<NSString *, MAAdView *> *adViewInstances;
     });
 }
 
+- (void)loadAd
+{
+    if ( !self.adView )
+    {
+        [[AppLovinMAX shared] log: @"Attempting to load uninitialized MAAdView for %@", self.adUnitId];
+        return;
+    }
+
+    [self.adView loadAd];
+}
+
 - (void)didMoveToWindow
 {
     [super didMoveToWindow];

package/ios/AppLovinMAXAdViewManager.m

@@ -6,6 +6,7 @@
 //  Copyright © 2020 AppLovin. All rights reserved.
 //
 
+#import "AppLovinMAX.h"
 #import "AppLovinMAXAdViewManager.h"
 #import "AppLovinMAXAdview.h"
 
@@ -19,6 +20,7 @@ RCT_EXPORT_VIEW_PROPERTY(placement, NSString)
 RCT_EXPORT_VIEW_PROPERTY(customData, NSString)
 RCT_EXPORT_VIEW_PROPERTY(adaptiveBannerEnabled, BOOL)
 RCT_EXPORT_VIEW_PROPERTY(autoRefresh, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(loadOnMount, BOOL)
 RCT_EXPORT_VIEW_PROPERTY(extraParameters, NSDictionary)
 RCT_EXPORT_VIEW_PROPERTY(localExtraParameters, NSDictionary)
 
@@ -40,4 +42,20 @@ RCT_EXPORT_VIEW_PROPERTY(onAdRevenuePaidEvent, RCTDirectEventBlock)
     return [[AppLovinMAXAdView alloc] init];
 }
 
+RCT_EXPORT_METHOD(loadAd:(nonnull NSNumber *)viewTag)
+{
+    [self.bridge.uiManager addUIBlock:^(__unused RCTUIManager *uiManager, NSDictionary<NSNumber *, UIView *> *viewRegistry) {
+        
+        UIView *view = viewRegistry[viewTag];
+        if ( ![view isKindOfClass: [AppLovinMAXAdView class]] )
+        {
+            [[AppLovinMAX shared] log: @"Cannot find AppLovinMAXAdView with tag %@", viewTag];
+            return;
+        }
+        
+        AppLovinMAXAdView *adView = (AppLovinMAXAdView *) view;
+        [adView loadAd];
+    }];
+}
+
 @end

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', '12.1.0'
+  pod 'AppLovinSDK', '12.2.1'
 
 end

package/ios/Podfile.lock

@@ -1,5 +1,5 @@
 PODS:
-  - AppLovinSDK (12.1.0)
+  - AppLovinSDK (12.2.1)
   - boost-for-react-native (1.63.0)
   - DoubleConversion (1.1.6)
   - FBLazyVector (0.63.5)
@@ -249,7 +249,7 @@ PODS:
   - Yoga (1.14.0)
 
 DEPENDENCIES:
-  - AppLovinSDK (= 12.1.0)
+  - AppLovinSDK (= 12.2.1)
   - 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: 179d509c258e01a3a77eb8416f0ba843a12ed322
+  AppLovinSDK: ed2ea453fc6cc836f4f829046865e6731010c139
   boost-for-react-native: 39c7adb57c4e60d6c5479dd8623128eb5b3f0f2c
   DoubleConversion: cde416483dac037923206447da6e1454df403714
   FBLazyVector: 352a8ca9bbc8e2f097d680747a8c97ecef12d469
@@ -368,6 +368,6 @@ SPEC CHECKSUMS:
   ReactCommon: b9ff54b6dd22ba4a776eda22d7f83ec27544ca35
   Yoga: 0276e9f20976c8568e107cfc1163a8629051adc0
 
-PODFILE CHECKSUM: d7248805481768209533def6ca165110984d9914
+PODFILE CHECKSUM: f5dc83bbecf23ce4ab6cb8ef2384fddaad9e6760
 
 COCOAPODS: 1.11.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-applovin-max",
   "author": "AppLovin Corporation",
-  "version": "6.2.2",
+  "version": "6.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_6_2_2" }
+  s.source       = { :git => "https://github.com/AppLovin/AppLovin-MAX-React-Native.git", :tag => "release_6_3_0" }
   
   s.source_files  = "ios/AppLovinMAX*.{h,m}"
 
   s.dependency "React"
-  s.dependency "AppLovinSDK", "12.1.0"
+  s.dependency "AppLovinSDK", "12.2.1"
 end

package/src/AdView.tsx

@@ -1,10 +1,10 @@
 import * as React from 'react';
-import { useEffect, useState } from 'react';
-import { NativeModules, requireNativeComponent, StyleSheet } from 'react-native';
-import type { ViewProps, ViewStyle, StyleProp } from 'react-native';
+import { useEffect, useState, useRef, useCallback, useImperativeHandle, forwardRef } from 'react';
+import { NativeModules, requireNativeComponent, StyleSheet, UIManager, findNodeHandle } from 'react-native';
+import type { ViewProps, ViewStyle, StyleProp, NativeMethods } from 'react-native';
 import type { AdDisplayFailedInfo, AdInfo, AdLoadFailedInfo, AdRevenueInfo } from './types/AdInfo';
 import type { AdNativeEvent } from './types/AdEvent';
-import type { AdViewProps } from './types/AdViewProps';
+import type { AdViewProps, AdViewHandler } from './types/AdViewProps';
 
 const { AppLovinMAX } = NativeModules;
 
@@ -65,6 +65,8 @@ type AdViewNativeEvents = {
 
 const AdViewComponent = requireNativeComponent<AdViewProps & ViewProps & AdViewNativeEvents>('AppLovinMAXAdView');
 
+type AdViewType = React.Component<AdViewProps> & NativeMethods;
+
 const ADVIEW_SIZE = {
     banner: { width: 320, height: 50 },
     leader: { width: 728, height: 90 },
@@ -161,28 +163,51 @@ const sizeAdViewDimensions = (
  * />
  * ```
  */
-export const AdView = ({
-    adUnitId,
-    adFormat,
-    placement,
-    customData,
-    adaptiveBannerEnabled = true,
-    autoRefresh = true,
-    extraParameters,
-    localExtraParameters,
-    onAdLoaded,
-    onAdLoadFailed,
-    onAdDisplayFailed,
-    onAdClicked,
-    onAdExpanded,
-    onAdCollapsed,
-    onAdRevenuePaid,
-    style,
-    ...otherProps
-}: AdViewProps & ViewProps) => {
+export const AdView = forwardRef<AdViewHandler, AdViewProps & ViewProps>(function AdView(
+    {
+        adUnitId,
+        adFormat,
+        placement,
+        customData,
+        adaptiveBannerEnabled = true,
+        autoRefresh = true,
+        loadOnMount = true,
+        extraParameters,
+        localExtraParameters,
+        onAdLoaded,
+        onAdLoadFailed,
+        onAdDisplayFailed,
+        onAdClicked,
+        onAdExpanded,
+        onAdCollapsed,
+        onAdRevenuePaid,
+        style,
+        ...otherProps
+    },
+    ref
+) {
+    const adViewRef = useRef<AdViewType | null>(null);
     const [isInitialized, setIsInitialized] = useState<boolean>(false);
     const [dimensions, setDimensions] = useState({});
 
+    const loadAd = () => {
+        if (adViewRef.current) {
+            UIManager.dispatchViewManagerCommand(
+                findNodeHandle(adViewRef.current),
+                UIManager.getViewManagerConfig('AppLovinMAXAdView').Commands.loadAd,
+                undefined
+            );
+        }
+    };
+
+    useImperativeHandle(ref, () => ({ loadAd }), []);
+
+    const saveElement = useCallback((element: AdViewType | null) => {
+        if (element) {
+            adViewRef.current = element;
+        }
+    }, []);
+
     useEffect(() => {
         AppLovinMAX.isInitialized().then((result: boolean) => {
             setIsInitialized(result);
@@ -244,12 +269,14 @@ export const AdView = ({
 
     return (
         <AdViewComponent
+            ref={saveElement}
             adUnitId={adUnitId}
             adFormat={adFormat}
             placement={placement}
             customData={customData}
             adaptiveBannerEnabled={adaptiveBannerEnabled}
             autoRefresh={autoRefresh}
+            loadOnMount={loadOnMount}
             extraParameters={extraParameters}
             localExtraParameters={localExtraParameters}
             onAdLoadedEvent={onAdLoadedEvent}
@@ -263,4 +290,4 @@ export const AdView = ({
             {...otherProps}
         />
     );
-};
+});

package/src/AppLovinMAX.ts

@@ -4,7 +4,7 @@ import type { Configuration } from './types/Configuration';
 
 const NativeAppLovinMAX = NativeModules.AppLovinMAX;
 
-const VERSION = '6.2.2';
+const VERSION = '6.3.0';
 
 /**
  * This enum represents the user's geography used to determine the type of consent flow shown to the
@@ -65,7 +65,7 @@ export enum AppTrackingStatus {
 /**
  * Represents errors for CMP flow.
  */
-export enum CmpError {
+export enum CMPErrorCode {
     /**
      * Indicates that an unspecified error has occurred.
      */

package/src/index.ts

@@ -1,4 +1,4 @@
-export { default, AppLovinMAX, ConsentFlowUserGeography, AppTrackingStatus, CmpError } from './AppLovinMAX';
+export { default, AppLovinMAX, ConsentFlowUserGeography, AppTrackingStatus, CMPErrorCode } from './AppLovinMAX';
 export { Privacy } from './Privacy';
 export { TargetingData, AdContentRating, UserGender } from './TargetingData';
 export { InterstitialAd } from './InterstitialAd';

package/src/types/AdViewProps.ts

@@ -2,6 +2,16 @@ import type { AdProps } from './AdProps';
 import type { AdInfo } from './AdInfo';
 import type { AdFormat } from '../AdView';
 
+/**
+ * A handler of {@link AdView}.
+ */
+export type AdViewHandler = {
+    /**
+     * If the {@link loadOnMount} attribute is set to false, you can call this API to start loading ads in this AdView.
+     */
+    loadAd(): void;
+};
+
 /**
  * Represents an {@link AdView} - Banner / MREC.
  */
@@ -23,6 +33,12 @@ export type AdViewProps = AdProps & {
      */
     autoRefresh?: boolean;
 
+    /**
+     * A boolean value representing whether or not to load an ad as soon as {@link AdView} is
+     * mounted. Note that the default value is true.
+     */
+    loadOnMount?: boolean;
+
     /**
      * A callback fuction that {@link AdView} fires when it expands the ad.
      */

package/src/types/AppLovinMAX.ts

@@ -1,5 +1,6 @@
 import type { Configuration } from './Configuration';
-import type { ConsentFlowUserGeography, CmpError } from '../AppLovinMAX';
+import type { CMPError } from './CMPError';
+import type { ConsentFlowUserGeography } from '../AppLovinMAX';
 
 /**
  * Represents the AppLovinMAX module.
@@ -63,8 +64,8 @@ export type AppLovinMAXType = {
     setVerboseLogging(verboseLoggingEnabled: boolean): void;
 
     /**
-     * Enables devices to receive test ads by passing in the advertising identifier (IDFA) of each
-     * test device. Refer to AppLovin logs for the IDFA of your current device.
+     * Enables devices to receive test ads by passing in the advertising identifier (IDFA or IDFV) of
+     * each test device. Refer to AppLovin logs for the IDFA or IDFV of your current device.
      *
      * @param advertisingIds A list of the advertising ids.
      */
@@ -136,11 +137,11 @@ export type AppLovinMAXType = {
      * Note that this resets the user’s existing consent information.
      *
      * The function returns when the flow finishes showing. On success, returns null. On failure,
-     * returns one of the {@link CmpError} codes.
+     * returns one of the {@link CMPError} codes.
      *
-     * @return {Promise<CmpError|null>}
+     * @return {Promise<CMPError|null>}
      */
-    showCmpForExistingUser(): Promise<CmpError | null>;
+    showCmpForExistingUser(): Promise<CMPError | null>;
 
     /**
      * Returns true if a supported CMP SDK is detected.

package/src/types/CMPError.ts

@@ -0,0 +1,23 @@
+import type { CMPErrorCode } from '../AppLovinMAX';
+
+export type CMPError = {
+    /**
+     * The error code for this error.
+     */
+    code: CMPErrorCode;
+
+    /**
+     * The error message for this error.
+     */
+    message: string;
+
+    /**
+     * The error code returned by the CMP.
+     */
+    cmpCode: number;
+
+    /**
+     * The error message returned by the CMP.
+     */
+    cmpMessage: string;
+};

package/src/types/index.ts

@@ -1,4 +1,5 @@
 export * from './Configuration';
+export * from './CMPError';
 export * from './AdInfo';
 export * from './AdViewProps';
 export * from './NativeAdViewProps';