feat: support for App Open Ad en Android e iOS

README.md

@@ -1,3 +1,4 @@
+
 <p align="center"><br><img src="https://user-images.githubusercontent.com/236501/85893648-1c92e880-b7a8-11ea-926d-95355b8175c7.png" width="128" height="128" /></p>
 <h3 align="center">AdMob</h3>
 <p align="center"><strong><code>@capacitor-community/admob</code></strong></p>
@@ -188,7 +189,46 @@ const consentInfo = await AdMob.requestConsentInfo({
 2. AdMob.requestConsentInfo
 3. AdMob.showConsentForm (If consent form required )
    3/ AdMob.showBanner
+
+### Show App Open Ad
+
+```ts
+import {
+  AdMob,
+  AppOpenAdPluginEvents,
+  AppOpenAdOptions,
+} from '@capacitor-community/admob';
+
+export async function showAppOpenAd(): Promise<void> {
+  // listen to events
+  AdMob.addListener(AppOpenAdPluginEvents.Loaded, () => {
+    console.log('App Open Ad loaded');
+  });
+  AdMob.addListener(AppOpenAdPluginEvents.FailedToLoad, () => {
+    console.log('Failed to load App Open Ad');
+  });
+  AdMob.addListener(AppOpenAdPluginEvents.Opened, () => {
+    console.log('App Open Ad open');
+  });
+  AdMob.addListener(AppOpenAdPluginEvents.Closed, () => {
+    console.log('App Open Ad close');
+  });
+  AdMob.addListener(AppOpenAdPluginEvents.FailedToShow, () => {
+    console.log('Failed to load App Open Ad');
+  });
 
+  const options: AppOpenAdOptions = {
+    adUnitId: 'TU_AD_UNIT_ID',
+    showOnColdStart: true, // Opcional
+    showOnForeground: true, // Opcional
+  };
+  await AdMob.loadAppOpen(options);
+  const { value } = await AdMob.isAppOpenLoaded();
+  if (value) {
+    await AdMob.showAppOpen();
+  }
+}
+```
 ### Show Banner
 
 ```ts
@@ -371,6 +411,10 @@ AdMob.addListener(RewardAdPluginEvents.Rewarded, async () => {
 * [`addListener(RewardInterstitialAdPluginEvents.Dismissed, ...)`](#addlistenerrewardinterstitialadplugineventsdismissed-)
 * [`addListener(RewardInterstitialAdPluginEvents.FailedToShow, ...)`](#addlistenerrewardinterstitialadplugineventsfailedtoshow-)
 * [`addListener(RewardInterstitialAdPluginEvents.Showed, ...)`](#addlistenerrewardinterstitialadplugineventsshowed-)
+* [`loadAppOpen(...)`](#loadappopen)
+* [`showAppOpen()`](#showappopen)
+* [`isAppOpenLoaded()`](#isappopenloaded)
+* [`addListener(AppOpenAdPluginEvents, ...)`](#addlistenerappopenadpluginevents-)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 * [Enums](#enums)
@@ -1067,6 +1111,63 @@ addListener(eventName: RewardInterstitialAdPluginEvents.Showed, listenerFunc: ()
 --------------------
 
 
+### loadAppOpen(...)
+
+```typescript
+loadAppOpen(options: AppOpenAdOptions) => Promise<void>
+```
+
+Carga un anuncio App Open
+
+| Param         | Type                                                          |
+| ------------- | ------------------------------------------------------------- |
+| **`options`** | <code><a href="#appopenadoptions">AppOpenAdOptions</a></code> |
+
+--------------------
+
+
+### showAppOpen()
+
+```typescript
+showAppOpen() => Promise<void>
+```
+
+Muestra el anuncio App Open si está cargado
+
+--------------------
+
+
+### isAppOpenLoaded()
+
+```typescript
+isAppOpenLoaded() => Promise<{ value: boolean; }>
+```
+
+Verifica si el anuncio App Open está cargado
+
+**Returns:** <code>Promise&lt;{ value: boolean; }&gt;</code>
+
+--------------------
+
+
+### addListener(AppOpenAdPluginEvents, ...)
+
+```typescript
+addListener(eventName: AppOpenAdPluginEvents, listenerFunc: (...args: any[]) => void) => Promise<PluginListenerHandle>
+```
+
+Agrega listeners para eventos de App Open
+
+| Param              | Type                                                                    |
+| ------------------ | ----------------------------------------------------------------------- |
+| **`eventName`**    | <code><a href="#appopenadpluginevents">AppOpenAdPluginEvents</a></code> |
+| **`listenerFunc`** | <code>(...args: any[]) =&gt; void</code>                                |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -1136,7 +1237,7 @@ When notice listener of OnAdLoaded, you can get banner size.
 
 #### AdMobError
 
-For more information
+For more information
 https://developers.google.com/android/reference/com/google/android/gms/ads/AdError
 
 | Prop          | Type                | Description                            |
@@ -1196,7 +1297,7 @@ https://developers.google.com/android/reference/com/google/android/gms/ads/AdErr
 
 #### AdMobRewardItem
 
-For more information
+For more information
 https://developers.google.com/admob/android/rewarded-video-adapters?hl=en
 
 | Prop         | Type                | Description              |
@@ -1228,6 +1329,15 @@ https://developers.google.com/admob/android/rewarded-video-adapters?hl=en
 | **`amount`** | <code>number</code> | Rewarded amount user got |
 
 
+#### AppOpenAdOptions
+
+| Prop                   | Type                 |
+| ---------------------- | -------------------- |
+| **`adUnitId`**         | <code>string</code>  |
+| **`showOnColdStart`**  | <code>boolean</code> |
+| **`showOnForeground`** | <code>boolean</code> |
+
+
 ### Type Aliases
 
 
@@ -1240,7 +1350,7 @@ https://developers.google.com/admob/android/rewarded-video-adapters?hl=en
 
 From T, pick a set of properties whose keys are in the union K
 
-<code>{ [P in K]: T[P]; }</code>
+<code>{ [P in K]: T[P] }</code>
 
 
 ### Enums
@@ -1354,6 +1464,17 @@ From T, pick a set of properties whose keys are in the union K
 | **`Dismissed`**    | <code>'onRewardedInterstitialAdDismissed'</code>    | Emits when the AdReward video is not visible to the user anymore. **Important**: This has nothing to do with the reward it self. This event will emits in this two cases: 1. The user starts the video ad but close it before the reward emit. 2. The user start the video and see it until end, then gets the reward and after that the ad is closed. |
 | **`Rewarded`**     | <code>'onRewardedInterstitialAdReward'</code>       | Emits when user get rewarded from AdReward                                                                                                                                                                                                                                                                                                             |
 
+
+#### AppOpenAdPluginEvents
+
+| Members            | Value                                |
+| ------------------ | ------------------------------------ |
+| **`Loaded`**       | <code>'appOpenAdLoaded'</code>       |
+| **`FailedToLoad`** | <code>'appOpenAdFailedToLoad'</code> |
+| **`Opened`**       | <code>'appOpenAdOpened'</code>       |
+| **`Closed`**       | <code>'appOpenAdClosed'</code>       |
+| **`FailedToShow`** | <code>'appOpenAdFailedToShow'</code> |
+
 </docgen-api>
 
 ## TROUBLE SHOOTING

android/src/main/java/com/getcapacitor/community/admob/AdMob.java

@@ -8,21 +8,27 @@
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
 import com.getcapacitor.annotation.Permission;
+
 import com.getcapacitor.community.admob.banner.BannerExecutor;
 import com.getcapacitor.community.admob.consent.AdConsentExecutor;
 import com.getcapacitor.community.admob.helpers.AuthorizationStatusEnum;
 import com.getcapacitor.community.admob.interstitial.AdInterstitialExecutor;
 import com.getcapacitor.community.admob.interstitial.InterstitialAdCallbackAndListeners;
 import com.getcapacitor.community.admob.rewarded.AdRewardExecutor;
 import com.getcapacitor.community.admob.rewardedinterstitial.AdRewardInterstitialExecutor;
+import com.getcapacitor.community.admob.appopen.AppOpenAdPlugin;
+
 import com.google.android.gms.ads.MobileAds;
 import com.google.android.gms.ads.RequestConfiguration;
 import com.google.android.gms.ads.initialization.InitializationStatus;
 import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
+
 import org.json.JSONException;
 
 @CapacitorPlugin(
-    permissions = { @Permission(alias = "network", strings = { Manifest.permission.ACCESS_NETWORK_STATE, Manifest.permission.INTERNET }) }
+    permissions = {
+        @Permission(alias = "network", strings = { Manifest.permission.ACCESS_NETWORK_STATE, Manifest.permission.INTERNET })
+    }
 )
 public class AdMob extends Plugin {
 
@@ -34,18 +40,21 @@ public class AdMob extends Plugin {
         this::notifyListeners,
         getLogTag()
     );
+
     private final AdRewardExecutor adRewardExecutor = new AdRewardExecutor(
         this::getContext,
         this::getActivity,
         this::notifyListeners,
         getLogTag()
     );
+
     private final AdRewardInterstitialExecutor adRewardInterstitialExecutor = new AdRewardInterstitialExecutor(
         this::getContext,
         this::getActivity,
         this::notifyListeners,
         getLogTag()
     );
+
     private final AdInterstitialExecutor adInterstitialExecutor = new AdInterstitialExecutor(
         this::getContext,
         this::getActivity,
@@ -61,7 +70,28 @@ public class AdMob extends Plugin {
         getLogTag()
     );
 
-    // Initialize AdMob with appId
+    // ✅ AppOpenAd Plugin block now inside the class
+    private final AppOpenAdPlugin appOpenAdPlugin = new AppOpenAdPlugin();
+
+    @PluginMethod
+    public void loadAppOpen(final PluginCall call) {
+        appOpenAdPlugin.loadAppOpen(call);
+    }
+
+    @PluginMethod
+    public void showAppOpen(final PluginCall call) {
+        appOpenAdPlugin.showAppOpen(call);
+    }
+
+    @PluginMethod
+    public void isAppOpenLoaded(final PluginCall call) {
+        appOpenAdPlugin.isAppOpenLoaded(call);
+    }
+
+    // ---------------------------------------------------------
+    // MAIN METHODS
+    // ---------------------------------------------------------
+
     @PluginMethod
     public void initialize(final PluginCall call) {
         this.setRequestConfiguration(call);
@@ -93,7 +123,10 @@ public void trackingAuthorizationStatus(final PluginCall call) {
         call.resolve(response);
     }
 
-    // User Consent
+    // ---------------------------------------------------------
+    // USER CONSENT
+    // ---------------------------------------------------------
+
     @PluginMethod
     public void requestConsentInfo(final PluginCall call) {
         adConsentExecutor.requestConsentInfo(call, this::notifyListeners);
@@ -114,6 +147,10 @@ public void resetConsentInfo(final PluginCall call) {
         adConsentExecutor.resetConsentInfo(call, this::notifyListeners);
     }
 
+    // ---------------------------------------------------------
+    // APP SETTINGS
+    // ---------------------------------------------------------
+
     @PluginMethod
     public void setApplicationMuted(final PluginCall call) {
         Boolean muted = call.getBoolean("muted");
@@ -136,41 +173,48 @@ public void setApplicationVolume(final PluginCall call) {
         call.resolve();
     }
 
-    // Show a banner Ad
+    // ---------------------------------------------------------
+    // BANNER ADS
+    // ---------------------------------------------------------
+
     @PluginMethod
     public void showBanner(final PluginCall call) {
         bannerExecutor.showBanner(call);
     }
 
-    // Hide the banner, remove it from screen, but can show it later
     @PluginMethod
     public void hideBanner(final PluginCall call) {
         bannerExecutor.hideBanner(call);
     }
 
-    // Resume the banner, show it after hide
     @PluginMethod
     public void resumeBanner(final PluginCall call) {
         bannerExecutor.resumeBanner(call);
     }
 
-    // Destroy the banner, remove it from screen.
     @PluginMethod
     public void removeBanner(final PluginCall call) {
         bannerExecutor.removeBanner(call);
     }
 
+    // ---------------------------------------------------------
+    // INTERSTITIAL ADS
+    // ---------------------------------------------------------
+
     @PluginMethod
     public void prepareInterstitial(final PluginCall call) {
         adInterstitialExecutor.prepareInterstitial(call, this::notifyListeners);
     }
 
-    // Show interstitial Ad
     @PluginMethod
     public void showInterstitial(final PluginCall call) {
         adInterstitialExecutor.showInterstitial(call, this::notifyListeners);
     }
 
+    // ---------------------------------------------------------
+    // REWARDED ADS
+    // ---------------------------------------------------------
+
     @PluginMethod
     public void prepareRewardVideoAd(final PluginCall call) {
         adRewardExecutor.prepareRewardVideoAd(call, this::notifyListeners);
@@ -191,10 +235,10 @@ public void showRewardInterstitialAd(final PluginCall call) {
         adRewardInterstitialExecutor.showRewardInterstitialAd(call, this::notifyListeners);
     }
 
-    /**
-     * @see <a href="https://developers.google.com/admob/android/test-ads#enable_test_devices">Test Devices</a>
-     * @see <a href="https://developers.google.com/admob/android/targeting">Target Settings</a>
-     */
+    // ---------------------------------------------------------
+    // REQUEST CONFIGURATION
+    // ---------------------------------------------------------
+
     private void setRequestConfiguration(final PluginCall call) {
         // Testing Devices
         final boolean initializeForTesting = call.getBoolean("initializeForTesting", false);