react-native-applovin-max 3.0.2 → 3.1.0

package/android/build.gradle

@@ -41,8 +41,8 @@ android {
   defaultConfig {
     minSdkVersion 16
     targetSdkVersion getExtOrIntegerDefault('targetSdkVersion')
-    versionCode 3000200
-    versionName "3.0.2"
+    versionCode 3010000
+    versionName "3.1.0"
   }
 
   flavorDimensions("default")

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

@@ -29,12 +29,15 @@ import com.applovin.mediation.MaxRewardedAdListener;
 import com.applovin.mediation.ads.MaxAdView;
 import com.applovin.mediation.ads.MaxInterstitialAd;
 import com.applovin.mediation.ads.MaxRewardedAd;
+import com.applovin.sdk.AppLovinAdContentRating;
+import com.applovin.sdk.AppLovinGender;
 import com.applovin.sdk.AppLovinMediationProvider;
 import com.applovin.sdk.AppLovinPrivacySettings;
 import com.applovin.sdk.AppLovinSdk;
 import com.applovin.sdk.AppLovinSdkConfiguration;
 import com.applovin.sdk.AppLovinSdkSettings;
 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.ReactApplicationContext;
@@ -273,6 +276,168 @@ public class AppLovinMAXModule
         } );
     }
 
+    // Data Passing
+
+    @ReactMethod()
+    public void setTargetingDataYearOfBirth(final int yearOfBirth)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "setTargetingDataYearOfBirth" );
+            return;
+        }
+
+        sdk.getTargetingData().setYearOfBirth( yearOfBirth <= 0 ? null : yearOfBirth );
+    }
+
+    @ReactMethod()
+    public void setTargetingDataGender(final String gender)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "setTargetingDataGender" );
+            return;
+        }
+
+        AppLovinGender alGender = AppLovinGender.UNKNOWN;
+
+        if ( "F".equals( gender ) )
+        {
+            alGender = AppLovinGender.FEMALE;
+        }
+        else if ( "M".equals( gender ) )
+        {
+            alGender = AppLovinGender.MALE;
+        }
+        else if ( "O".equals( gender ) )
+        {
+            alGender = AppLovinGender.OTHER;
+        }
+
+        sdk.getTargetingData().setGender( alGender );
+    }
+
+    @ReactMethod()
+    public void setTargetingDataMaximumAdContentRating(final int maximumAdContentRating)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "setTargetingDataMaximumAdContentRating" );
+            return;
+        }
+
+        AppLovinAdContentRating rating = AppLovinAdContentRating.NONE;
+
+        if ( maximumAdContentRating == 1 )
+        {
+            rating = AppLovinAdContentRating.ALL_AUDIENCES;
+        }
+        else if ( maximumAdContentRating == 2 )
+        {
+            rating = AppLovinAdContentRating.EVERYONE_OVER_TWELVE;
+        }
+        else if ( maximumAdContentRating == 3 )
+        {
+            rating = AppLovinAdContentRating.MATURE_AUDIENCES;
+        }
+
+        sdk.getTargetingData().setMaximumAdContentRating( rating );
+    }
+
+    @ReactMethod()
+    public void setTargetingDataEmail(final String email)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "setTargetingDataEmail" );
+            return;
+        }
+
+        sdk.getTargetingData().setEmail( email );
+    }
+
+    @ReactMethod()
+    public void setTargetingDataPhoneNumber(final String phoneNumber)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "setTargetingDataPhoneNumber" );
+            return;
+        }
+
+        sdk.getTargetingData().setPhoneNumber( phoneNumber );
+    }
+
+    @ReactMethod()
+    public void setTargetingDataKeywords(final ReadableArray rawKeywords)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "setTargetingDataKeywords" );
+            return;
+        }
+
+        List<String> keywords = null;
+
+        if ( rawKeywords != null )
+        {
+            keywords = new ArrayList<>( rawKeywords.size() );
+            for ( Object rawKeyword : rawKeywords.toArrayList() )
+            {
+                keywords.add( (String) rawKeyword );
+            }
+        }
+
+        sdk.getTargetingData().setKeywords( keywords );
+    }
+
+    @ReactMethod()
+    public void setTargetingDataInterests(final ReadableArray rawInterests)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "setTargetingDataInterests" );
+            return;
+        }
+
+        List<String> interests = null;
+
+        if ( rawInterests != null )
+        {
+            interests = new ArrayList<>( rawInterests.size() );
+            for ( Object rawInterest : rawInterests.toArrayList() )
+            {
+                interests.add( (String) rawInterest );
+            }
+        }
+
+        sdk.getTargetingData().setInterests( interests );
+    }
+
+    @ReactMethod()
+    public void clearAllTargetingData()
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "clearAllTargetingData" );
+            return;
+        }
+
+        sdk.getTargetingData().clearAll();
+    }
+
+    @ReactMethod()
+    public void setLocationCollectionEnabled(final boolean locationCollectionEnabled)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "setLocationCollectionEnabled" );
+            return;
+        }
+
+        sdk.getSettings().setLocationCollectionEnabled( locationCollectionEnabled );
+    }
+
     // General Public API
 
     @ReactMethod(isBlockingSynchronousMethod = true)
@@ -287,13 +452,32 @@ public class AppLovinMAXModule
     {
         if ( sdk == null )
         {
-            Log.e( "[" + TAG + "]", "Failed to show mediation debugger - please ensure the AppLovin MAX React Native module has been initialized by calling 'AppLovinMAX.initialize(...);'!" );
+            logUninitializedAccessError( "showMediationDebugger" );
             return;
         }
 
         sdk.showMediationDebugger();
     }
 
+    @ReactMethod()
+    public void showConsentDialog(final Callback callback)
+    {
+        if ( sdk == null )
+        {
+            logUninitializedAccessError( "showConsentDialog" );
+            return;
+        }
+
+        sdk.getUserService().showConsentDialog( maybeGetCurrentActivity(), new AppLovinUserService.OnConsentDialogDismissListener()
+        {
+            @Override
+            public void onDismiss()
+            {
+                callback.invoke();
+            }
+        } );
+    }
+
     @ReactMethod(isBlockingSynchronousMethod = true)
     public int getConsentDialogState()
     {
@@ -1174,6 +1358,11 @@ public class AppLovinMAXModule
         e( Log.getStackTraceString( e ) );
     }
 
+    private 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(...);'!" );
+    }
+
     public static void d(final String message)
     {
         final String fullMessage = "[" + TAG + "] " + message;

package/ios/AppLovinMAX.m

@@ -206,6 +206,139 @@ RCT_EXPORT_METHOD(initialize:(NSString *)pluginVersion :(NSString *)sdkKey :(RCT
     }];
 }
 
+#pragma mark - Data Passing
+
+RCT_EXPORT_METHOD(setTargetingDataYearOfBirth:(nonnull NSNumber *)yearOfBirth)
+{
+    if ( !_sdk )
+    {
+        [self logUninitializedAccessError: @"setTargetingDataYearOfBirth"];
+        return;
+    }
+    
+    self.sdk.targetingData.yearOfBirth = yearOfBirth.intValue <= 0 ? nil : yearOfBirth;
+}
+
+RCT_EXPORT_METHOD(setTargetingDataGender:(nullable NSString *)gender)
+{
+    if ( !_sdk )
+    {
+        [self logUninitializedAccessError: @"setTargetingDataGender"];
+        return;
+    }
+    
+    ALGender alGender = ALGenderUnknown;
+
+    if ( [@"F" isEqualToString: gender] )
+    {
+        alGender =  ALGenderFemale;
+    }
+    else if ( [@"M" isEqualToString: gender] )
+    {
+        alGender =  ALGenderMale;
+    }
+    else if ( [@"O" isEqualToString: gender] )
+    {
+        alGender =  ALGenderOther;
+    }
+
+    self.sdk.targetingData.gender = alGender;
+}
+
+RCT_EXPORT_METHOD(setTargetingDataMaximumAdContentRating:(nonnull NSNumber *)maximumAdContentRating)
+{
+    if ( !_sdk )
+    {
+        [self logUninitializedAccessError: @"setTargetingDataMaximumAdContentRating"];
+        return;
+    }
+    
+    ALAdContentRating rating = ALAdContentRatingNone;
+
+    int intVal = maximumAdContentRating.intValue;
+
+    if ( intVal == 1 )
+    {
+        rating = ALAdContentRatingAllAudiences;
+    }
+    else if ( intVal == 2 )
+    {
+        rating = ALAdContentRatingEveryoneOverTwelve;
+    }
+    else if ( intVal == 3 )
+    {
+        rating = ALAdContentRatingMatureAudiences;
+    }
+
+    self.sdk.targetingData.maximumAdContentRating = rating;
+}
+
+RCT_EXPORT_METHOD(setTargetingDataEmail:(nullable NSString *)email)
+{
+    if ( !_sdk )
+    {
+        [self logUninitializedAccessError: @"setTargetingDataEmail"];
+        return;
+    }
+    
+    self.sdk.targetingData.email = email;
+}
+
+RCT_EXPORT_METHOD(setTargetingDataPhoneNumber:(nullable NSString *)phoneNumber)
+{
+    if ( !_sdk )
+    {
+        [self logUninitializedAccessError: @"setTargetingDataPhoneNumber"];
+        return;
+    }
+    
+    self.sdk.targetingData.phoneNumber = phoneNumber;
+}
+
+RCT_EXPORT_METHOD(setTargetingDataKeywords:(nullable NSArray<NSString *> *)keywords)
+{
+    if ( !_sdk )
+    {
+        [self logUninitializedAccessError: @"setTargetingDataKeywords"];
+        return;
+    }
+    
+    self.sdk.targetingData.keywords = keywords;
+}
+
+RCT_EXPORT_METHOD(setTargetingDataInterests:(nullable NSArray<NSString *> *)interests)
+{
+    if ( !_sdk )
+    {
+        [self logUninitializedAccessError: @"setTargetingDataInterests"];
+        return;
+    }
+    
+    self.sdk.targetingData.interests = interests;
+}
+
+RCT_EXPORT_METHOD(clearAllTargetingData)
+{
+    if ( !_sdk )
+    {
+        [self logUninitializedAccessError: @"clearAllTargetingData"];
+        return;
+    }
+    
+    [self.sdk.targetingData clearAll];
+}
+
+RCT_EXPORT_METHOD(setLocationCollectionEnabled:(BOOL)locationCollectionEnabled)
+{
+    if ( !_sdk )
+    {
+        [self logUninitializedAccessError: @"setLocationCollectionEnabled"];
+        return;
+    }
+    
+    self.sdk.settings.locationCollectionEnabled = locationCollectionEnabled;
+}
+
 #pragma mark - General Public API
 
 RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isTablet)
@@ -217,13 +350,20 @@ RCT_EXPORT_METHOD(showMediationDebugger)
 {
     if ( !_sdk )
     {
-        [self log: @"Failed to show mediation debugger - please ensure the AppLovin MAX Unity Plugin has been initialized by calling 'AppLovinMAX.initialize(...);'!"];
+        [self logUninitializedAccessError: @"showMediationDebugger"];
         return;
     }
     
     [self.sdk showMediationDebugger];
 }
 
+RCT_EXPORT_METHOD(showConsentDialog:(RCTResponseSenderBlock)callback)
+{
+    [self log: @"Failed to show consent dialog - Unavailable on iOS, please use the consent flow: https://dash.applovin.com/documentation/mediation/react-native/getting-started/consent-flow"];
+
+    callback(nil);
+}
+
 RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getConsentDialogState)
 {
     if ( ![self isInitialized] ) return @(ALConsentDialogStateUnknown);
@@ -916,6 +1056,11 @@ RCT_EXPORT_METHOD(setRewardedAdExtraParameter:(NSString *)adUnitIdentifier :(NSS
     [self log: @"invalid ad format: %@, from %@", adFormat, [NSThread callStackSymbols]];
 }
 
+- (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];
+}
+
 - (void)log:(NSString *)format, ...
 {
     va_list valist;

package/package.json

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

package/src/TargetingData.js

@@ -0,0 +1,70 @@
+import AppLovinMAX from "./index.js";
+
+const AdContentRating = {
+  None:               0,
+  AllAudiences:       1,
+  EveryoneOverTwelve: 2,
+  MatureAudiences:    3,
+};
+
+const UserGender = {
+  Unknown: 'U',
+  Female:  'F',
+  Male:    'M',
+  Other:   'O'
+};
+
+let TargetingData = {
+
+  set yearOfBirth(value) {
+    AppLovinMAX.setTargetingDataYearOfBirth(value);
+  },
+
+  set gender(value) {
+    if ( value === UserGender.Unknown ||
+         value === UserGender.Female ||
+         value === UserGender.Male ||
+         value === UserGender.Other ) {
+      AppLovinMAX.setTargetingDataGender(value);
+    }
+  },
+
+  set maximumAdContentRating(value) {
+    if ( value === AdContentRating.None ||
+         value === AdContentRating.AllAudiences ||
+         value === AdContentRating.EveryoneOverTwelve ||
+         value === AdContentRating.MatureAudiences ) {
+      AppLovinMAX.setTargetingDataMaximumAdContentRating(value);
+    }
+  },
+
+  set email(value) {
+    AppLovinMAX.setTargetingDataEmail(value);
+  },
+
+  set phoneNumber(value) {
+    AppLovinMAX.setTargetingDataPhoneNumber(value);
+  },
+
+  set keywords(value) {
+    AppLovinMAX.setTargetingDataKeywords(value);
+  },
+
+  set interests(value) {
+    AppLovinMAX.setTargetingDataInterests(value);
+  },
+
+  clearAll() {
+    AppLovinMAX.clearAllTargetingData();
+  }
+  
+};
+
+TargetingData.AdContentRating = AdContentRating;
+TargetingData.UserGender = UserGender;
+
+export {
+  TargetingData,
+  AdContentRating,
+  UserGender
+};

package/src/index.js

@@ -1,9 +1,10 @@
 import { NativeModules, NativeEventEmitter } from "react-native";
 import AdView from "./AppLovinMAXAdView";
+import { TargetingData as targetingData, AdContentRating, UserGender } from "./TargetingData";
 
 const { AppLovinMAX } = NativeModules;
 
-const VERSION = "3.0.2";
+const VERSION = "3.1.0";
 
 /**
  * This enum represents whether or not the consent dialog should be shown for this user.
@@ -67,6 +68,9 @@ const removeEventListener = (event) => {
 export default {
   ...AppLovinMAX,
   AdView,
+  targetingData,
+  AdContentRating,
+  UserGender,
   ConsentDialogState,
   AdViewPosition,
   AdFormat,
@@ -91,6 +95,7 @@ export default {
   /*--------------*/
   /* PRIVACY APIs */
   /*--------------*/
+  /* showConsentDialog(callback) */
   /* getConsentDialogState() */
   /* setHasUserConsent(hasUserConsent) */
   /* hasUserConsent() */
@@ -112,6 +117,7 @@ export default {
   /* setConsentFlowEnabled(enabled) */
   /* setPrivacyPolicyUrl(urlString) */
   /* setTermsOfServiceUrl(urlString) */
+  /* setLocationCollectionEnabled(locationCollectionEnabled) */
 
   /*----------------*/
   /* EVENT TRACKING */