react-native-google-mobile-ads 5.0.1 → 6.0.0

package/RNGoogleMobileAds.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
   s.social_media_url    = 'http://twitter.com/invertaseio'
   s.ios.deployment_target = "10.0"
   s.source_files        = 'ios/**/*.{h,m}'
-  s.frameworks          = "AppTrackingTransparency"
+  s.weak_frameworks     = "AppTrackingTransparency"
 
   # React Native dependencies
   s.dependency          'React-Core'

package/__tests__/interstitial.test.ts

@@ -1,4 +1,4 @@
-import { InterstitialAd } from '../src';
+import { AdEventType, InterstitialAd } from '../src';
 
 describe('Google Mobile Ads Interstitial', function () {
   describe('createForAdRequest', function () {
@@ -34,17 +34,44 @@ describe('Google Mobile Ads Interstitial', function () {
       });
     });
 
-    describe('onAdEvent', function () {
-      it('throws if handler is not a function', function () {
+    describe('addAdEventsListener', function () {
+      it('throws if listener is not a function', function () {
         const i = InterstitialAd.createForAdRequest('abc');
 
         // @ts-ignore
-        expect(() => i.onAdEvent('foo')).toThrowError("'handler' expected a function");
+        expect(() => i.addAdEventsListener('foo')).toThrowError("'listener' expected a function");
       });
 
       it('returns an unsubscriber function', function () {
         const i = InterstitialAd.createForAdRequest('abc');
-        const unsub = i.onAdEvent(() => {});
+        const unsub = i.addAdEventsListener(() => {});
+        expect(unsub).toBeDefined();
+        unsub();
+      });
+    });
+
+    describe('addAdEventListener', function () {
+      it('throws if type is not a AdEventType', function () {
+        const i = InterstitialAd.createForAdRequest('abc');
+
+        // @ts-ignore
+        expect(() => i.addAdEventListener('foo')).toThrowError(
+          "'type' expected a valid event type value.",
+        );
+      });
+
+      it('throws if listener is not a function', function () {
+        const i = InterstitialAd.createForAdRequest('abc');
+
+        // @ts-ignore
+        expect(() => i.addAdEventListener(AdEventType.LOADED, 'foo')).toThrowError(
+          "'listener' expected a function",
+        );
+      });
+
+      it('returns an unsubscriber function', function () {
+        const i = InterstitialAd.createForAdRequest('abc');
+        const unsub = i.addAdEventListener(AdEventType.LOADED, () => {});
         expect(unsub).toBeDefined();
         unsub();
       });

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsAppOpenModule.java

@@ -119,7 +119,8 @@ public class ReactNativeGoogleMobileAdsAppOpenModule extends ReactNativeModule {
   }
 
   @ReactMethod
-  public void appOpenShow(int requestId, ReadableMap showOptions, Promise promise) {
+  public void appOpenShow(
+      int requestId, String adUnitId, ReadableMap showOptions, Promise promise) {
     if (getCurrentActivity() == null) {
       rejectPromiseWithCodeAndMessage(
           promise,

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsBannerAdViewManager.java

@@ -20,6 +20,7 @@ package io.invertase.googlemobileads;
 import android.view.ViewGroup;
 import androidx.annotation.NonNull;
 import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.common.MapBuilder;
@@ -33,22 +34,31 @@ import com.google.android.gms.ads.AdListener;
 import com.google.android.gms.ads.AdRequest;
 import com.google.android.gms.ads.AdSize;
 import com.google.android.gms.ads.AdView;
+import com.google.android.gms.ads.BaseAdView;
 import com.google.android.gms.ads.LoadAdError;
+import com.google.android.gms.ads.admanager.AdManagerAdView;
+import com.google.android.gms.ads.admanager.AppEventListener;
+import java.util.ArrayList;
+import java.util.List;
 import java.util.Map;
 import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
 
 public class ReactNativeGoogleMobileAdsBannerAdViewManager
     extends SimpleViewManager<ReactViewGroup> {
   private static final String REACT_CLASS = "RNGoogleMobileAdsBannerView";
-  private String EVENT_AD_LOADED = "onAdLoaded";
-  private String EVENT_AD_FAILED_TO_LOAD = "onAdFailedToLoad";
-  private String EVENT_AD_OPENED = "onAdOpened";
-  private String EVENT_AD_CLOSED = "onAdClosed";
+  private final String EVENT_AD_LOADED = "onAdLoaded";
+  private final String EVENT_AD_FAILED_TO_LOAD = "onAdFailedToLoad";
+  private final String EVENT_AD_OPENED = "onAdOpened";
+  private final String EVENT_AD_CLOSED = "onAdClosed";
+  private final String EVENT_APP_EVENT = "onAppEvent";
+  private final int COMMAND_ID_RECORD_MANUAL_IMPRESSION = 1;
 
-  private Boolean requested = false;
   private AdRequest request;
-  private AdSize size;
+  private List<AdSize> sizes;
   private String unitId;
+  private Boolean manualImpressionsEnabled;
+  private boolean isFluid;
 
   @Nonnull
   @Override
@@ -59,24 +69,7 @@ public class ReactNativeGoogleMobileAdsBannerAdViewManager
   @Nonnull
   @Override
   public ReactViewGroup createViewInstance(@Nonnull ThemedReactContext themedReactContext) {
-    ReactViewGroup viewGroup = new ReactViewGroup(themedReactContext);
-    AdView adView = new AdView(themedReactContext);
-    viewGroup.addView(adView);
-    setAdListener(viewGroup);
-    return viewGroup;
-  }
-
-  private AdView getAdView(ReactViewGroup viewGroup) {
-    return (AdView) viewGroup.getChildAt(0);
-  }
-
-  private void resetAdView(ReactViewGroup reactViewGroup) {
-    AdView oldAdView = getAdView(reactViewGroup);
-    AdView newAdView = new AdView(reactViewGroup.getContext());
-    reactViewGroup.removeViewAt(0);
-    if (oldAdView != null) oldAdView.destroy();
-    reactViewGroup.addView(newAdView);
-    setAdListener(reactViewGroup);
+    return new ReactViewGroup(themedReactContext);
   }
 
   @Override
@@ -86,6 +79,26 @@ public class ReactNativeGoogleMobileAdsBannerAdViewManager
     return builder.build();
   }
 
+  @Nullable
+  @Override
+  public Map<String, Integer> getCommandsMap() {
+    return MapBuilder.of("recordManualImpression", COMMAND_ID_RECORD_MANUAL_IMPRESSION);
+  }
+
+  @Override
+  public void receiveCommand(
+      @NonNull ReactViewGroup reactViewGroup, String commandId, @Nullable ReadableArray args) {
+    super.receiveCommand(reactViewGroup, commandId, args);
+    int commandIdInt = Integer.parseInt(commandId);
+
+    if (commandIdInt == COMMAND_ID_RECORD_MANUAL_IMPRESSION) {
+      BaseAdView adView = getAdView(reactViewGroup);
+      if (adView instanceof AdManagerAdView) {
+        ((AdManagerAdView) adView).recordManualImpression();
+      }
+    }
+  }
+
   @ReactProp(name = "unitId")
   public void setUnitId(ReactViewGroup reactViewGroup, String value) {
     unitId = value;
@@ -98,62 +111,62 @@ public class ReactNativeGoogleMobileAdsBannerAdViewManager
     requestAd(reactViewGroup);
   }
 
-  @ReactProp(name = "size")
-  public void setSize(ReactViewGroup reactViewGroup, String value) {
-    size = ReactNativeGoogleMobileAdsCommon.getAdSize(value, reactViewGroup);
-
-    WritableMap payload = Arguments.createMap();
-
-    int width = size.getWidth();
-    int height = size.getHeight();
-
-    payload.putDouble("width", width);
-    payload.putDouble("height", height);
-
-    if (size != AdSize.FLUID) {
-      sendEvent(reactViewGroup, "onSizeChange", payload);
+  @ReactProp(name = "sizes")
+  public void setSizes(ReactViewGroup reactViewGroup, ReadableArray value) {
+    List<AdSize> sizeList = new ArrayList<>();
+    for (Object size : value.toArrayList()) {
+      if (size instanceof String) {
+        String sizeString = (String) size;
+        sizeList.add(ReactNativeGoogleMobileAdsCommon.getAdSize(sizeString, reactViewGroup));
+      }
     }
+    sizes = sizeList;
     requestAd(reactViewGroup);
   }
 
-  private void setAdListener(ReactViewGroup reactViewGroup) {
-    final AdView adView = getAdView(reactViewGroup);
+  @ReactProp(name = "manualImpressionsEnabled")
+  public void setManualImpressionsEnabled(ReactViewGroup reactViewGroup, boolean value) {
+    this.manualImpressionsEnabled = value;
+    requestAd(reactViewGroup);
+  }
 
+  private BaseAdView initAdView(ReactViewGroup reactViewGroup) {
+    BaseAdView oldAdView = getAdView(reactViewGroup);
+    if (oldAdView != null) {
+      oldAdView.destroy();
+      reactViewGroup.removeView(oldAdView);
+    }
+    BaseAdView adView;
+    if (ReactNativeGoogleMobileAdsCommon.isAdManagerUnit(unitId)) {
+      adView = new AdManagerAdView(reactViewGroup.getContext());
+    } else {
+      adView = new AdView(reactViewGroup.getContext());
+    }
     adView.setDescendantFocusability(ViewGroup.FOCUS_BLOCK_DESCENDANTS);
     adView.setAdListener(
         new AdListener() {
           @Override
           public void onAdLoaded() {
-            int top;
-            int left;
-            int width;
-            int height;
-
-            if (size == AdSize.FLUID) {
-              top = 0;
+            AdSize adSize = adView.getAdSize();
+            int left, top, width, height;
+            if (isFluid) {
+              // TODO size=FLUID is still not working
               left = 0;
+              top = 0;
               width = reactViewGroup.getWidth();
               height = reactViewGroup.getHeight();
             } else {
-              top = adView.getTop();
               left = adView.getLeft();
-              width = adView.getAdSize().getWidthInPixels(reactViewGroup.getContext());
-              height = adView.getAdSize().getHeightInPixels(reactViewGroup.getContext());
+              top = adView.getTop();
+              width = adSize.getWidthInPixels(reactViewGroup.getContext());
+              height = adSize.getHeightInPixels(reactViewGroup.getContext());
             }
-
-            // TODO size=FLUID not loading ad, height of child FrameLayout incorrect?
             adView.measure(width, height);
             adView.layout(left, top, left + width, top + height);
 
             WritableMap payload = Arguments.createMap();
-
-            if (size != AdSize.FLUID) {
-              payload.putInt("width", (int) PixelUtil.toDIPFromPixel(width) + 1);
-              payload.putInt("height", (int) PixelUtil.toDIPFromPixel(height) + 1);
-            } else {
-              payload.putInt("width", (int) PixelUtil.toDIPFromPixel(width));
-              payload.putInt("height", (int) PixelUtil.toDIPFromPixel(height));
-            }
+            payload.putDouble("width", PixelUtil.toDIPFromPixel(width));
+            payload.putDouble("height", PixelUtil.toDIPFromPixel(height));
 
             sendEvent(reactViewGroup, EVENT_AD_LOADED, payload);
           }
@@ -175,23 +188,52 @@ public class ReactNativeGoogleMobileAdsBannerAdViewManager
             sendEvent(reactViewGroup, EVENT_AD_CLOSED, null);
           }
         });
+    if (adView instanceof AdManagerAdView) {
+      ((AdManagerAdView) adView)
+          .setAppEventListener(
+              new AppEventListener() {
+                @Override
+                public void onAppEvent(@NonNull String name, @Nullable String data) {
+                  WritableMap payload = Arguments.createMap();
+                  payload.putString("name", name);
+                  payload.putString("data", data);
+                  sendEvent(reactViewGroup, EVENT_APP_EVENT, payload);
+                }
+              });
+    }
+    reactViewGroup.addView(adView);
+    return adView;
+  }
+
+  @Nullable
+  private BaseAdView getAdView(ReactViewGroup reactViewGroup) {
+    return (BaseAdView) reactViewGroup.getChildAt(0);
   }
 
   private void requestAd(ReactViewGroup reactViewGroup) {
-    if (size == null || unitId == null || request == null) {
+    if (sizes == null || unitId == null || request == null || manualImpressionsEnabled == null) {
       return;
     }
 
-    if (requested) {
-      resetAdView(reactViewGroup);
+    BaseAdView adView = initAdView(reactViewGroup);
+    adView.setAdUnitId(unitId);
+
+    isFluid = false;
+    if (adView instanceof AdManagerAdView) {
+      if (sizes.contains(AdSize.FLUID)) {
+        isFluid = true;
+        ((AdManagerAdView) adView).setAdSizes(AdSize.FLUID);
+      } else {
+        ((AdManagerAdView) adView).setAdSizes(sizes.toArray(new AdSize[0]));
+      }
+      if (manualImpressionsEnabled) {
+        ((AdManagerAdView) adView).setManualImpressionsEnabled(true);
+      }
+    } else {
+      adView.setAdSize(sizes.get(0));
     }
 
-    AdView adView = getAdView(reactViewGroup);
-    adView.setAdUnitId(unitId);
-    adView.setAdSize(size);
     adView.loadAd(request);
-
-    requested = true;
   }
 
   private void sendEvent(ReactViewGroup reactViewGroup, String type, WritableMap payload) {

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsCommon.java

@@ -17,13 +17,11 @@ package io.invertase.googlemobileads;
  *
  */
 
-import android.location.Location;
 import android.os.Bundle;
 import android.util.DisplayMetrics;
 import android.view.Display;
 import com.facebook.react.bridge.Arguments;
 import com.facebook.react.bridge.ReactContext;
-import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.views.view.ReactViewGroup;
@@ -165,15 +163,6 @@ public class ReactNativeGoogleMobileAdsCommon {
       builder.setContentUrl(Objects.requireNonNull(adRequestOptions.getString("contentUrl")));
     }
 
-    if (adRequestOptions.hasKey("location")) {
-      ReadableArray locationArray = adRequestOptions.getArray("location");
-      Location location = new Location("");
-      location.setLatitude(Objects.requireNonNull(locationArray).getDouble(0));
-      location.setLongitude(Objects.requireNonNull(locationArray).getDouble(1));
-
-      builder.setLocation(location);
-    }
-
     if (adRequestOptions.hasKey("requestAgent")) {
       builder.setRequestAgent(Objects.requireNonNull(adRequestOptions.getString("requestAgent")));
     }
@@ -264,4 +253,9 @@ public class ReactNativeGoogleMobileAdsCommon {
     codeAndMessage[1] = message;
     return codeAndMessage;
   }
+
+  public static boolean isAdManagerUnit(String unitId) {
+    if (unitId == null) return false;
+    return unitId.startsWith("/");
+  }
 }

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsConsentModule.java

@@ -16,11 +16,13 @@ package io.invertase.googlemobileads;
  * limitations under the License.
  *
  */
-
+import android.content.SharedPreferences;
+import android.preference.PreferenceManager;
 import com.facebook.react.bridge.Arguments;
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableMap;
 import com.google.android.ump.ConsentDebugSettings;
@@ -28,7 +30,6 @@ import com.google.android.ump.ConsentInformation;
 import com.google.android.ump.ConsentRequestParameters;
 import com.google.android.ump.UserMessagingPlatform;
 import io.invertase.googlemobileads.common.ReactNativeModule;
-import java.util.List;
 import javax.annotation.Nonnull;
 
 public class ReactNativeGoogleMobileAdsConsentModule extends ReactNativeModule {
@@ -63,10 +64,10 @@ public class ReactNativeGoogleMobileAdsConsentModule extends ReactNativeModule {
           new ConsentDebugSettings.Builder(getApplicationContext());
 
       if (options.hasKey("testDeviceIdentifiers")) {
-        List<Object> devices = options.getArray("testDeviceIdentifiers").toArrayList();
+        ReadableArray devices = options.getArray("testDeviceIdentifiers");
 
-        for (Object device : devices) {
-          debugSettingsBuilder.addTestDeviceHashedId((String) device);
+        for (int i = 0; i < devices.size(); i++) {
+          debugSettingsBuilder.addTestDeviceHashedId(devices.getString(i));
         }
       }
 
@@ -152,4 +153,17 @@ public class ReactNativeGoogleMobileAdsConsentModule extends ReactNativeModule {
   public void reset() {
     consentInformation.reset();
   }
+
+  @ReactMethod
+  public void getTCString(Promise promise) {
+    try {
+      SharedPreferences prefs =
+          PreferenceManager.getDefaultSharedPreferences(getReactApplicationContext());
+      // https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20CMP%20API%20v2.md#in-app-details
+      String tcString = prefs.getString("IABTCF_TCString", null);
+      promise.resolve(tcString);
+    } catch (Exception e) {
+      rejectPromiseWithCodeAndMessage(promise, "consent-string-error", e.toString());
+    }
+  }
 }

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsEvent.java

@@ -32,6 +32,7 @@ public class ReactNativeGoogleMobileAdsEvent implements NativeEvent {
   public static final String GOOGLE_MOBILE_ADS_EVENT_OPENED = "opened";
   public static final String GOOGLE_MOBILE_ADS_EVENT_CLICKED = "clicked";
   public static final String GOOGLE_MOBILE_ADS_EVENT_CLOSED = "closed";
+  public static final String GOOGLE_MOBILE_ADS_EVENT_APP_EVENT = "app_event";
 
   public static final String GOOGLE_MOBILE_ADS_EVENT_REWARDED_LOADED = "rewarded_loaded";
   public static final String GOOGLE_MOBILE_ADS_EVENT_REWARDED_EARNED_REWARD =

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsInterstitialModule.java

@@ -20,6 +20,7 @@ package io.invertase.googlemobileads;
 import static io.invertase.googlemobileads.ReactNativeGoogleMobileAdsCommon.buildAdRequest;
 import static io.invertase.googlemobileads.ReactNativeGoogleMobileAdsCommon.getCodeAndMessageFromAdError;
 import static io.invertase.googlemobileads.ReactNativeGoogleMobileAdsCommon.sendAdEvent;
+import static io.invertase.googlemobileads.ReactNativeGoogleMobileAdsEvent.GOOGLE_MOBILE_ADS_EVENT_APP_EVENT;
 import static io.invertase.googlemobileads.ReactNativeGoogleMobileAdsEvent.GOOGLE_MOBILE_ADS_EVENT_CLICKED;
 import static io.invertase.googlemobileads.ReactNativeGoogleMobileAdsEvent.GOOGLE_MOBILE_ADS_EVENT_CLOSED;
 import static io.invertase.googlemobileads.ReactNativeGoogleMobileAdsEvent.GOOGLE_MOBILE_ADS_EVENT_ERROR;
@@ -38,6 +39,8 @@ import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableMap;
 import com.google.android.gms.ads.FullScreenContentCallback;
 import com.google.android.gms.ads.LoadAdError;
+import com.google.android.gms.ads.admanager.AdManagerInterstitialAd;
+import com.google.android.gms.ads.admanager.AppEventListener;
 import com.google.android.gms.ads.interstitial.InterstitialAd;
 import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;
 import io.invertase.googlemobileads.common.ReactNativeModule;
@@ -74,7 +77,6 @@ public class ReactNativeGoogleMobileAdsInterstitialModule extends ReactNativeMod
 
                 @Override
                 public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
-
                   interstitialAd.setFullScreenContentCallback(
                       new FullScreenContentCallback() {
                         @Override
@@ -96,7 +98,23 @@ public class ReactNativeGoogleMobileAdsInterstitialModule extends ReactNativeMod
                               GOOGLE_MOBILE_ADS_EVENT_OPENED, requestId, adUnitId, null);
                         }
                       });
-
+                  if (interstitialAd instanceof AdManagerInterstitialAd) {
+                    ((AdManagerInterstitialAd) interstitialAd)
+                        .setAppEventListener(
+                            new AppEventListener() {
+                              @Override
+                              public void onAppEvent(@NonNull String name, @Nullable String data) {
+                                WritableMap payload = Arguments.createMap();
+                                payload.putString("name", name);
+                                payload.putString("data", data);
+                                sendInterstitialEvent(
+                                    GOOGLE_MOBILE_ADS_EVENT_APP_EVENT,
+                                    requestId,
+                                    adUnitId,
+                                    payload);
+                              }
+                            });
+                  }
                   interstitialAdArray.put(requestId, interstitialAd);
                   sendInterstitialEvent(GOOGLE_MOBILE_ADS_EVENT_LOADED, requestId, adUnitId, null);
                 }
@@ -111,16 +129,25 @@ public class ReactNativeGoogleMobileAdsInterstitialModule extends ReactNativeMod
                 }
               };
 
-          InterstitialAd.load(
-              currentActivity,
-              adUnitId,
-              buildAdRequest(adRequestOptions),
-              interstitialAdLoadCallback);
+          if (ReactNativeGoogleMobileAdsCommon.isAdManagerUnit(adUnitId)) {
+            AdManagerInterstitialAd.load(
+                currentActivity,
+                adUnitId,
+                buildAdRequest(adRequestOptions),
+                interstitialAdLoadCallback);
+          } else {
+            InterstitialAd.load(
+                currentActivity,
+                adUnitId,
+                buildAdRequest(adRequestOptions),
+                interstitialAdLoadCallback);
+          }
         });
   }
 
   @ReactMethod
-  public void interstitialShow(int requestId, ReadableMap showOptions, Promise promise) {
+  public void interstitialShow(
+      int requestId, String adUnitId, ReadableMap showOptions, Promise promise) {
     if (getCurrentActivity() == null) {
       rejectPromiseWithCodeAndMessage(
           promise,
@@ -134,9 +161,7 @@ public class ReactNativeGoogleMobileAdsInterstitialModule extends ReactNativeMod
               InterstitialAd interstitialAd = interstitialAdArray.get(requestId);
               if (interstitialAd == null) {
                 rejectPromiseWithCodeAndMessage(
-                    promise,
-                    "null-interstitialAd",
-                    "Interstitial ad attempted to show but its object was null.");
+                    promise, "not-ready", "Interstitial ad attempted to show but was not ready.");
                 return;
               }
 
@@ -146,15 +171,8 @@ public class ReactNativeGoogleMobileAdsInterstitialModule extends ReactNativeMod
                 interstitialAd.setImmersiveMode(false);
               }
 
-              String a = String.valueOf(requestId);
-
-              if (interstitialAd != null) {
-                interstitialAd.show(getCurrentActivity());
-                promise.resolve(null);
-              } else {
-                rejectPromiseWithCodeAndMessage(
-                    promise, "not-ready", "Interstitial ad attempted to show but was not ready.");
-              }
+              interstitialAd.show(getCurrentActivity());
+              promise.resolve(null);
             });
   }
 }

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsModule.java

@@ -17,6 +17,7 @@ package io.invertase.googlemobileads;
  *
  */
 
+import androidx.annotation.Nullable;
 import com.facebook.react.bridge.Arguments;
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReactApplicationContext;
@@ -24,8 +25,10 @@ import com.facebook.react.bridge.ReactMethod;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableArray;
 import com.facebook.react.bridge.WritableMap;
+import com.google.android.gms.ads.AdInspectorError;
 import com.google.android.gms.ads.AdRequest;
 import com.google.android.gms.ads.MobileAds;
+import com.google.android.gms.ads.OnAdInspectorClosedListener;
 import com.google.android.gms.ads.RequestConfiguration;
 import com.google.android.gms.ads.initialization.AdapterStatus;
 import com.google.android.gms.ads.initialization.InitializationStatus;
@@ -140,4 +143,46 @@ public class ReactNativeGoogleMobileAdsModule extends ReactNativeModule {
     MobileAds.setRequestConfiguration(buildRequestConfiguration(requestConfiguration));
     promise.resolve(null);
   }
+
+  @ReactMethod
+  public void openAdInspector(Promise promise) {
+    if (getCurrentActivity() == null) {
+      rejectPromiseWithCodeAndMessage(
+          promise,
+          "null-activity",
+          "Ad Inspector attempted to open but the current Activity was null.");
+      return;
+    }
+    getCurrentActivity()
+        .runOnUiThread(
+            () -> {
+              MobileAds.openAdInspector(
+                  getApplicationContext(),
+                  new OnAdInspectorClosedListener() {
+                    @Override
+                    public void onAdInspectorClosed(@Nullable AdInspectorError adInspectorError) {
+                      if (adInspectorError != null) {
+                        String code = "";
+                        switch (adInspectorError.getCode()) {
+                          case AdInspectorError.ERROR_CODE_INTERNAL_ERROR:
+                            code = "INTERNAL_ERROR";
+                            break;
+                          case AdInspectorError.ERROR_CODE_FAILED_TO_LOAD:
+                            code = "FAILED_TO_LOAD";
+                            break;
+                          case AdInspectorError.ERROR_CODE_NOT_IN_TEST_MODE:
+                            code = "NOT_IN_TEST_MODE";
+                            break;
+                          case AdInspectorError.ERROR_CODE_ALREADY_OPEN:
+                            code = "ALREADY_OPEN";
+                            break;
+                        }
+                        rejectPromiseWithCodeAndMessage(
+                            promise, code, adInspectorError.getMessage());
+                      }
+                      promise.resolve(null);
+                    }
+                  });
+            });
+  }
 }

package/docs/ad-inspector.mdx

@@ -0,0 +1,39 @@
+# Ad Inspector
+
+Ad inspector is an in-app overlay that enables authorized devices to perform real-time analysis of test ad requests directly within a mobile app.
+
+Using ad inspector, you can:
+
+- Inspect your ad units
+- Check whether your ads are filling as expected
+- Identify errors and view details about how to resolve them
+- View the details for each Open Bidding ad network per request
+- View the mediation details for each ad network per request
+- Test individual third-party Open Bidding or waterfall mediation ad sources
+- Verify that you've correctly configured each ad unit for Open Bidding and waterfall mediation
+
+To see more information about ad inspector, see the [official documentation](https://developers.google.com/admob/android/ad-inspector).
+
+## Launch ad inspector
+
+Ad inspector can be launched from anywhere in your app. There are three different ways to launch ad inspector.
+
+1. Use the launch button from the debug menu.
+2. Use the gesture that you selected in the ad inspector settings.
+3. Programmatically using the provided API.
+
+More information about laucnhing ad inspector is available in [official documentation](https://developers.google.com/admob/android/ad-inspector#launch_ad_inspector).
+
+### Launch programmatically
+
+Ad inspector can be launched programmatically with the `openAdInspector` method in the `MobileAds` instance.
+
+```js
+try {
+  await MobileAds().openAdInspector();
+  // The promise will resolve when the inspector is closed.
+} catch (error) {
+  // The promise will reject if ad inspector is closed due to an error.
+  console.log(error);
+}
+```