react-native-applovin-max 6.2.1 → 6.2.3

package/android/build.gradle

@@ -35,8 +35,8 @@ android {
   defaultConfig {
     minSdkVersion 16
     targetSdkVersion getExtOrIntegerDefault('targetSdkVersion')
-    versionCode 6020100
-    versionName "6.2.1"
+    versionCode 6020300
+    versionName "6.2.3"
   }
 
   flavorDimensions("default")

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

@@ -37,6 +37,8 @@ import com.applovin.mediation.ads.MaxAppOpenAd;
 import com.applovin.mediation.ads.MaxInterstitialAd;
 import com.applovin.mediation.ads.MaxRewardedAd;
 import com.applovin.sdk.AppLovinAdContentRating;
+import com.applovin.sdk.AppLovinCmpError;
+import com.applovin.sdk.AppLovinCmpService;
 import com.applovin.sdk.AppLovinGender;
 import com.applovin.sdk.AppLovinMediationProvider;
 import com.applovin.sdk.AppLovinPrivacySettings;
@@ -668,6 +670,48 @@ public class AppLovinMAXModule
         debugUserGeographyToSet = userGeography;
     }
 
+    @ReactMethod
+    public void showCmpForExistingUser(final Promise promise)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "showCmpForExistingUser", promise );
+            return;
+        }
+
+        Activity currentActivity = maybeGetCurrentActivity();
+        if ( currentActivity == null )
+        {
+            promise.reject( new IllegalStateException( "ERROR: Failed to execute showCmpForExistingUser() - unable to get current Activity." ) );
+            return;
+        }
+
+        AppLovinCmpService cmpService = sdk.getCmpService();
+        cmpService.showCmpForExistingUser( currentActivity, (@Nullable final AppLovinCmpError error) -> {
+
+            if ( error == null )
+            {
+                promise.resolve( null );
+                return;
+            }
+
+            promise.resolve( error.getCmpCode() );
+        } );
+    }
+
+    @ReactMethod
+    public void hasSupportedCmp(final Promise promise)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "showCmpForExistingUser", promise );
+            return;
+        }
+
+        AppLovinCmpService cmpService = sdk.getCmpService();
+        promise.resolve( cmpService.hasSupportedCmp() );
+    }
+
     // Data Passing
 
     @ReactMethod
@@ -2389,7 +2433,20 @@ public class AppLovinMAXModule
 
     public static void logUninitializedAccessError(final String callingMethod)
     {
-        e( "ERROR: Failed to execute " + callingMethod + "() - please ensure the AppLovin MAX React Native module has been initialized by calling 'AppLovinMAX.initialize(...);'!" );
+        logUninitializedAccessError( callingMethod, null );
+    }
+
+    public static void logUninitializedAccessError(final String callingMethod, @Nullable final Promise promise)
+    {
+        String message = "ERROR: Failed to execute " + callingMethod + "() - please ensure the AppLovin MAX React Native module has been initialized by calling 'AppLovinMAX.initialize(...);'!";
+
+        if ( promise == null )
+        {
+            e(  message );
+            return;
+        }
+
+        promise.reject( new IllegalStateException( message ) );
     }
 
     public static void d(final String message)
@@ -2690,6 +2747,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 )
@@ -2711,12 +2773,23 @@ public class AppLovinMAXModule
             MaxInterstitialAd interstitial = retrieveInterstitial( adUnitId, "setAmazonResult" );
             if ( interstitial == null )
             {
-                e( "Failed to set Amazon result - unable to retrieve interstitial" );
+                e( "Failed to set Amazon result - unable to find interstitial" );
                 return;
             }
 
             interstitial.setLocalExtraParameter( key, result );
         }
+        else if ( adFormat == MaxAdFormat.REWARDED )
+        {
+            MaxRewardedAd rewardedAd = retrieveRewardedAd( adUnitId, "setAmazonResult" );
+            if ( rewardedAd == null )
+            {
+                e( "Failed to set Amazon result - unable to find rewarded ad" );
+                return;
+            }
+
+            rewardedAd.setLocalExtraParameter( key, result );
+        }
         else // MaxAdFormat.BANNER or MaxAdFormat.MREC
         {
             MaxAdView adView = AppLovinMAXAdView.getInstance( adUnitId );
@@ -2732,7 +2805,7 @@ public class AppLovinMAXModule
             }
             else
             {
-                e( "Failed to set Amazon result - unable to retrieve " + adFormat );
+                e( "Failed to set Amazon result - unable to find " + adFormat );
             }
         }
     }

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

@@ -471,7 +471,7 @@ public class AppLovinMAXNativeAdView
 
     private static void sizeToFit(final @Nullable View view, final View parentView)
     {
-        if ( view != null )
+        if ( view != null && parentView != null )
         {
             view.measure( MeasureSpec.makeMeasureSpec( parentView.getWidth(), MeasureSpec.EXACTLY ),
                           MeasureSpec.makeMeasureSpec( parentView.getHeight(), MeasureSpec.EXACTLY ) );

package/ios/AppLovinMAX.m

@@ -554,6 +554,39 @@ RCT_EXPORT_METHOD(setConsentFlowDebugUserGeography:(NSString *)userGeography)
     self.debugUserGeographyToSet = userGeography;
 }
 
+RCT_EXPORT_METHOD(showCmpForExistingUser:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
+{
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"showCmpForExistingUser" withPromiseReject: reject];
+        return;
+    }
+
+    ALCMPService *cmpService = self.sdk.cmpService;
+    [cmpService showCMPForExistingUserWithCompletion:^(ALCMPError * _Nullable error) {
+        
+        if ( !error )
+        {
+            resolve(nil);
+            return;
+        }
+
+        resolve(@(error.code));
+    }];
+}
+
+RCT_EXPORT_METHOD(hasSupportedCmp:(RCTPromiseResolveBlock)resolve :(RCTPromiseRejectBlock)reject)
+{
+    if ( !self.sdk )
+    {
+        [self logUninitializedAccessError: @"hasSupportedCmp" withPromiseReject: reject];
+        return;
+    }
+
+    ALCMPService *cmpService = self.sdk.cmpService;
+    resolve(@([cmpService hasSupportedCMP]));
+}
+
 #pragma mark - Data Passing
 
 RCT_EXPORT_METHOD(setTargetingDataYearOfBirth:(nonnull NSNumber *)yearOfBirth)
@@ -1995,7 +2028,20 @@ RCT_EXPORT_METHOD(setAppOpenAdLocalExtraParameter:(NSString *)adUnitIdentifier :
 
 - (void)logUninitializedAccessError:(NSString *)callingMethod
 {
-    [self log: @"ERROR: Failed to execute %@() - please ensure the AppLovin MAX React Native module has been initialized by calling 'AppLovinMAX.initialize(...);'!", callingMethod];
+    [self logUninitializedAccessError: callingMethod withPromiseReject: nil];
+}
+
+- (void)logUninitializedAccessError:(NSString *)callingMethod withPromiseReject:(nullable RCTPromiseRejectBlock)reject
+{
+    NSString *message = [NSString stringWithFormat:@"ERROR: Failed to execute %@() - please ensure the AppLovin MAX React Native module has been initialized by calling 'AppLovinMAX.initialize(...);'!", callingMethod];
+
+    if ( !reject )
+    {
+        NSLog(@"[%@] [%@] %@", SDK_TAG, TAG, message);
+        return;
+    }
+
+    reject(TAG, message, nil);
 }
 
 - (void)log:(NSString *)format, ...
@@ -2246,6 +2292,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 )
@@ -2275,6 +2326,17 @@ RCT_EXPORT_METHOD(setAppOpenAdLocalExtraParameter:(NSString *)adUnitIdentifier :
 
         [interstitial setLocalExtraParameterForKey: key value: result];
     }
+    else if ( adFormat == MAAdFormat.rewarded )
+    {
+        MARewardedAd *rewardedAd = [self retrieveRewardedAdForAdUnitIdentifier: adUnitIdentifier];
+        if ( !rewardedAd )
+        {
+            [self log: @"Failed to set Amazon result - unable to find rewarded ad"];
+            return;
+        }
+
+        [rewardedAd setLocalExtraParameterForKey: key value: result];
+    }
     else  // MAAdFormat.banner or MAAdFormat.mrec
     {
         MAAdView *adView = [AppLovinMAXAdView sharedWithAdUnitIdentifier: adUnitIdentifier];

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-applovin-max",
   "author": "AppLovin Corporation",
-  "version": "6.2.1",
+  "version": "6.2.3",
   "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,7 +11,7 @@ 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_1" }
+  s.source       = { :git => "https://github.com/AppLovin/AppLovin-MAX-React-Native.git", :tag => "release_6_2_3" }
   
   s.source_files  = "ios/AppLovinMAX*.{h,m}"
 

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,88 @@ import type { Configuration } from './types/Configuration';
 
 const NativeAppLovinMAX = NativeModules.AppLovinMAX;
 
-const VERSION = '6.2.1';
+const VERSION = '6.2.3';
+
+/**
+ * This enum represents the user's geography used to determine the type of consent flow shown to the
+ * user.
+ */
+export enum ConsentFlowUserGeography {
+    /**
+     * User's geography is unknown.
+     */
+    UNKNOWN = 'U',
+
+    /**
+     * The user is in GDPR region.
+     */
+    GDPR = 'G',
+
+    /**
+     * The user is in a non-GDPR region.
+     */
+    OTHER = 'O',
+}
+
+/**
+ * AppLovin SDK-defined app tracking transparency status values (extended to include "unavailable"
+ * state on iOS before iOS14).
+ */
+export enum AppTrackingStatus {
+    /**
+     * Device is on iOS before iOS14, AppTrackingTransparency.framework is not available.
+     */
+    UNAVAILABLE = 'U',
+
+    /**
+     * The user has not yet received an authorization request to authorize access to app-related
+     * data that can be used for tracking the user or the device.
+     */
+    NOT_DETERMINED = 'N',
+
+    /**
+     * Authorization to access app-related data that can be used for tracking the user or the device
+     * is restricted.
+     */
+    RESTRICTED = 'R',
+
+    /**
+     * The user denies authorization to access app-related data that can be used for tracking the
+     * user or the device.
+     */
+    DENIED = 'D',
+
+    /**
+     * The user authorizes access to app-related data that can be used for tracking the user or the
+     * device.
+     */
+    AUTHORIZED = 'A',
+}
+
+/**
+ * Represents errors for CMP flow.
+ */
+export enum CmpError {
+    /**
+     * Indicates that an unspecified error has occurred.
+     */
+    UNSPECIFIED = -1,
+
+    /**
+     * Indicates that the CMP has not been integrated correctly.
+     */
+    INTEGRATION_ERROR = 1,
+
+    /**
+     * Indicates that the CMP form is unavailable.
+     */
+    FORM_UNAVAILABLE = 2,
+
+    /**
+     * Indicates that the CMP form is not required.
+     */
+    FORM_NOT_REQUIRED = 3,
+}
 
 const initialize = async (sdkKey: string): Promise<Configuration> => {
     return NativeAppLovinMAX.initialize(VERSION, sdkKey);

package/src/Privacy.ts

@@ -3,60 +3,4 @@ import type { PrivacyType } from './types/Privacy';
 
 const { AppLovinMAX } = NativeModules;
 
-/**
- * This enum represents the user's geography used to determine the type of consent flow shown to the
- * user.
- */
-export enum ConsentFlowUserGeography {
-    /**
-     * User's geography is unknown.
-     */
-    UNKNOWN = 'U',
-
-    /**
-     * The user is in GDPR region.
-     */
-    GDPR = 'G',
-
-    /**
-     * The user is in a non-GDPR region.
-     */
-    OTHER = 'O',
-}
-
-/**
- * AppLovin SDK-defined app tracking transparency status values (extended to include "unavailable"
- * state on iOS before iOS14).
- */
-export enum AppTrackingStatus {
-    /**
-     * Device is on iOS before iOS14, AppTrackingTransparency.framework is not available.
-     */
-    UNAVAILABLE = 'U',
-
-    /**
-     * The user has not yet received an authorization request to authorize access to app-related
-     * data that can be used for tracking the user or the device.
-     */
-    NOT_DETERMINED = 'N',
-
-    /**
-     * Authorization to access app-related data that can be used for tracking the user or the device
-     * is restricted.
-     */
-    RESTRICTED = 'R',
-
-    /**
-     * The user denies authorization to access app-related data that can be used for tracking the
-     * user or the device.
-     */
-    DENIED = 'D',
-
-    /**
-     * The user authorizes access to app-related data that can be used for tracking the user or the
-     * device.
-     */
-    AUTHORIZED = 'A',
-}
-
 export const Privacy: PrivacyType = AppLovinMAX;

package/src/index.ts

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

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,4 +1,5 @@
 import type { Configuration } from './Configuration';
+import type { ConsentFlowUserGeography, CmpError } from '../AppLovinMAX';
 
 /**
  * Represents the AppLovinMAX module.
@@ -90,4 +91,61 @@ export type AppLovinMAXType = {
      * @param enabled Defaults to true.
      */
     setLocationCollectionEnabled(enabled: boolean): void;
+
+    /**
+     * @deprecated Use {@link setTermsAndPrivacyPolicyFlowEnabled()} instead.
+     *
+     * Enables the MAX Terms Flow.
+     *
+     * @param enabled true to enable the MAX Terms Flow.
+     */
+    setConsentFlowEnabled(enabled: boolean): void;
+
+    /**
+     * Enables the MAX Terms and Privacy Policy Flow.
+     *
+     * @param enabled true to enable the MAX Terms and Privacy Policy Flow.
+     */
+    setTermsAndPrivacyPolicyFlowEnabled(enabled: boolean): void;
+
+    /**
+     * The URL of your company’s privacy policy, as a string. This is required in order to enable
+     * the Terms Flow.
+     *
+     * @param urlString The URL string to point your company’s privacy policy.
+     */
+    setPrivacyPolicyUrl(urlString: string): void;
+
+    /**
+     * The URL of your company’s terms of service, as a string. This is optional; you can enable
+     * the Terms Flow with or without it.
+     *
+     * @param urlString The URL string to point your company’s terms of service.
+     */
+    setTermsOfServiceUrl(urlString: string): void;
+
+    /**
+     * Set debug user geography. You may use this to test CMP flow by setting this to {@link ConsentFlowUserGeography.GDPR}.
+     *
+     * @note The debug geography is used only when the app is in debug mode.
+     */
+    setConsentFlowDebugUserGeography(userGeography: ConsentFlowUserGeography): void;
+
+    /**
+     * Shows the CMP flow to an existing user.
+     * 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.
+     *
+     * @return {Promise<CmpError|null>}
+     */
+    showCmpForExistingUser(): Promise<CmpError | null>;
+
+    /**
+     * Returns true if a supported CMP SDK is detected.
+     *
+     * @return {boolean}
+     */
+    hasSupportedCmp(): Promise<boolean>;
 };

package/src/types/Configuration.ts

@@ -1,4 +1,4 @@
-import type { ConsentFlowUserGeography, AppTrackingStatus } from '../Privacy';
+import type { ConsentFlowUserGeography, AppTrackingStatus } from '../AppLovinMAX';
 
 /**
  * Encapsulates data for the AppLovinMAX SDK configuration.

package/src/types/Privacy.ts

@@ -1,5 +1,3 @@
-import type { ConsentFlowUserGeography } from '../Privacy';
-
 export type PrivacyType = {
     /**********************************************************************************/
     /* Privacy */
@@ -40,47 +38,4 @@ export type PrivacyType = {
      * Checks if the user opted out of the sale of their personal information.
      */
     isDoNotSell(): Promise<boolean>;
-
-    /**********************************************************************************/
-    /* TERM FLow */
-    /**********************************************************************************/
-
-    /**
-     * @deprecated Use {@link setTermsAndPrivacyPolicyFlowEnabled()} instead.
-     *
-     * Enables the MAX Terms Flow.
-     *
-     * @param enabled true to enable the MAX Terms Flow.
-     */
-    setConsentFlowEnabled(enabled: boolean): void;
-
-    /**
-     * Enables the MAX Terms and Privacy Policy Flow.
-     *
-     * @param enabled true to enable the MAX Terms and Privacy Policy Flow.
-     */
-    setTermsAndPrivacyPolicyFlowEnabled(enabled: boolean): void;
-
-    /**
-     * The URL of your company’s privacy policy, as a string. This is required in order to enable
-     * the Terms Flow.
-     *
-     * @param urlString The URL string to point your company’s privacy policy.
-     */
-    setPrivacyPolicyUrl(urlString: string): void;
-
-    /**
-     * The URL of your company’s terms of service, as a string. This is optional; you can enable
-     * the Terms Flow with or without it.
-     *
-     * @param urlString The URL string to point your company’s terms of service.
-     */
-    setTermsOfServiceUrl(urlString: string): void;
-
-    /**
-     * Set debug user geography. You may use this to test CMP flow by setting this to {@link ConsentFlowUserGeography.GDPR}.
-     *
-     * @note The debug geography is used only when the app is in debug mode.
-     */
-    setConsentFlowDebugUserGeography(userGeography: ConsentFlowUserGeography): void;
 };