cordova-plugin-admob-nextgen 1.0.8 → 1.1.9

package/README.md

@@ -71,6 +71,10 @@ We prioritize the safety of your AdMob account and the stability of your app.
 
 ## Cordova/Capacitor/Framework7 AdMob Next-Gen: Installation & Usage Guide
 
+---
+> Fastest test (APK Debug): **[⚡ With github action ](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen/discussions/4)** (Optional)
+---
+
 ## 1. Cordova or Framework7
 
 ### Option A: Via CLI
@@ -86,13 +90,19 @@ Add this to your `config.xml` to restore the plugin automatically.
         <variable name="APP_ID_IOS" value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy" />
     </plugin>
 
+---
 
-## Supporting Mediation: **[⚡ admob-mediation-suite ](https://github.com/swaplab-engine/admob-mediation-suite)** (Optional)
+## (Optional)
+
+### Supporting Mediation: **[⚡ admob-mediation-suite ](https://github.com/swaplab-engine/admob-mediation-suite)** (Optional)
+### Supporting Native ads: **[⚡ cordova-plugin-admob-nextgen-native ](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen-native)** (Optional)
+
+---
 
 ## For Capacitor users
 **[⚡ Capacitor Integration: Automated Setup for AdMob Next Gen ](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen/discussions/3)**.
 
-**[⚡ AdMob Next Gen - Starter Templates 🚀 ](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen-template)**.
+**[⚡ AdMob Next Gen - Starter Capacitor Templates 🚀 ](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen-template)**.
 
 ---
 
@@ -141,9 +151,10 @@ Add this to your `config.xml` to restore the plugin automatically.
     // 3. Initialize the SDK
     function startSdk() {
         admobNextGen.initialize({
-            maxAdContentRating: 'G',  // 'G' || 'PG' || 'T' || 'MA' || ""
-            tagForChildDirectedTreatment: false,
-            tagForUnderAgeOfConsent: false
+            maxAdContentRating: 'G',  // 'G' | 'PG' | 'T' | 'MA' | ""
+            tagForChildDirectedTreatment: false, // true | false | null
+            tagForUnderAgeOfConsent: false, // true | false | null
+            // isNativeValidatorDisabled: false // optional param for: cordova-plugin-admob-nextgen-native
         }, function() {
             console.log(">>> AdMob SDK Initialized & Ready <<<");
         }, function(err) {
@@ -247,10 +258,12 @@ Supports **Adaptive**, **Standard**, and **Collapsible** banners.
 
 ## 4. Native Ads (Advanced Overlay) - Android Only
 
+- Recommended: **[⚡ cordova-plugin-admob-nextgen-native ](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen-native)** (Android | IOS)
+
 High-performance native templates.
 
 ### Example A: Using Templates (Recommended)
-
+    // Android Only
     admobNextGen.createNativeAd({
         adUnitId: 'ca-app-pub-xxx/xxx',
         view: 'banner_bottom',    // Presets: 'banner_top', 'banner_bottom', 'modal_center'
@@ -259,7 +272,7 @@ High-performance native templates.
     });
 
 ### Example B: Custom Position (Manual Coordinates)
-
+    // Android Only
     admobNextGen.createNativeAd({
         adUnitId: 'ca-app-pub-xxx/xxx',
         view: 'custom',
@@ -271,7 +284,7 @@ High-performance native templates.
     });
 
 ### Native Methods & Events
-
+    // Android Only
     admobNextGen.removeNativeAd();
 
     document.addEventListener('on.native.loaded', () => console.log("Native Loaded"));
@@ -307,9 +320,12 @@ Use the background engine to pool ads for 0ms latency.
     // 2. Show Instantly (from pool)
     admobNextGen.showPreloadedBanner();
 
-    // 3. Stop Engine
+    // 3. Stop/Remove Engine
     admobNextGen.stopBannerPreload();
 
+    // 4. Hide Engine
+    admobNextGen.hideBannerPreload() 
+
 
     ### Banner Events
 
@@ -352,6 +368,9 @@ Supports Auto-Resume logic.
 
     admobNextGen.showAppOpenAd();
 
+### With App Open Ad Preload
+> App Open Ad Preload **[⚡ Modern ](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen/tree/main/simple-example/www/js/AppOpenAdPreload.js)** 
+
 ### App Open Events
 
     document.addEventListener('on.appopen.revenue', (data) => console.log(data));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cordova-plugin-admob-nextgen",
-  "version": "1.0.8",
+  "version": "1.1.9",
   "description": "Google Mobile Ads Next Gen SDK for Cordova. High performance and modular architecture. ",
   "cordova": {
     "id": "cordova-plugin-admob-nextgen",

package/plugin.xml

@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='utf-8'?>
 <plugin id="cordova-plugin-admob-nextgen" 
-        version="1.0.8" 
+        version="1.1.9" 
         xmlns="http://apache.org/cordova/ns/plugins/1.0" 
         xmlns:android="http://schemas.android.com/apk/res/android">
 
@@ -36,6 +36,7 @@
         <source-file src="src/android/AdMobNextGen.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />
         <source-file src="src/android/BannerExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />
         <source-file src="src/android/BannerPreloadExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />
+        <source-file src="src/android/AppOpenAdPreloadExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />
         <source-file src="src/android/NativeExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />
         <source-file src="src/android/AppOpenAdExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />
         <source-file src="src/android/InterstitialExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />

package/src/android/AdMobNextGen.java

@@ -39,6 +39,9 @@ public class AdMobNextGen extends CordovaPlugin {
     private NativeExecutor nativeExecutor;
 
     private BannerPreloadExecutor bannerPreloadExecutor;
+    private AppOpenAdPreloadExecutor appOpenAdPreloadExecutor;
+
+    private boolean isNativeValidatorDisabled = true;
 
     @Override
     public void pluginInitialize() {
@@ -58,6 +61,7 @@ public class AdMobNextGen extends CordovaPlugin {
         nativeExecutor = new NativeExecutor(cordova, webView);
 
         bannerPreloadExecutor = new BannerPreloadExecutor(cordova, webView);
+        appOpenAdPreloadExecutor = new AppOpenAdPreloadExecutor(cordova, webView);
     }
 
     @Override
@@ -125,12 +129,30 @@ public class AdMobNextGen extends CordovaPlugin {
             return true;
         }
 
+        if ("hideBannerPreload".equals(action)) {
+            bannerPreloadExecutor.hideBanner(callbackContext);
+            return true;
+        }
+
         if ("removeBanner".equals(action)) {
             bannerExecutor.destroy();
             callbackContext.success();
             return true;
         }
 
+        if ("startAppOpenPreload".equals(action)) {
+            appOpenAdPreloadExecutor.startPreload(args, callbackContext);
+            return true;
+        }
+        if ("showPreloadedAppOpenAd".equals(action)) {
+            appOpenAdPreloadExecutor.showPolledAd(args, callbackContext);
+            return true;
+        }
+        if ("isAppOpenAdAvailable".equals(action)) {
+            appOpenAdPreloadExecutor.checkAdAvailable(args, callbackContext);
+            return true;
+        }
+
         if ("loadAppOpenAd".equals(action)) {
             if (appOpenAdExecutor != null) {
                 appOpenAdExecutor.loadAd(args, callbackContext);
@@ -201,41 +223,53 @@ public class AdMobNextGen extends CordovaPlugin {
         if (appOpenAdExecutor != null && appOpenAdExecutor.shouldAutoShow()) {
             appOpenAdExecutor.showAdIfAvailable(cordova.getActivity());
         }
+        if (appOpenAdPreloadExecutor != null && appOpenAdPreloadExecutor.shouldAutoShow()) {
+            if (appOpenAdPreloadExecutor.hasAvailableAd()) {
+                appOpenAdPreloadExecutor.showPolledAd(null, null);
+            }
+        }
     }
 
     private void initializeSDK(JSONArray args, CallbackContext callbackContext) {
-        String appId = getAppIdFromManifest();
-        if (appId == null) {
-            callbackContext.error("AdMob App ID missing");
-            return;
-        }
-
-        cordova.getThreadPool().execute(() -> {
-            try {
-                InitializationConfig.Builder initConfigBuilder = new InitializationConfig.Builder(appId);
+    String appId = getAppIdFromManifest();
+    if (appId == null) {
+        callbackContext.error("AdMob App ID missing");
+        return;
+    }
 
-                JSONObject configJson = args.optJSONObject(0);
+    cordova.getThreadPool().execute(() -> {
+        try {
+            InitializationConfig.Builder initConfigBuilder = new InitializationConfig.Builder(appId);
 
-                if (configJson != null) {
+            JSONObject configJson = args.optJSONObject(0);
 
-                    RequestConfiguration requestConfig = GlobalSettingsExecutor.buildRequestConfiguration(configJson);
-                    initConfigBuilder.setRequestConfiguration(requestConfig);
-                }
+            if (configJson != null) {
+                RequestConfiguration requestConfig = GlobalSettingsExecutor.buildRequestConfiguration(configJson);
+                initConfigBuilder.setRequestConfiguration(requestConfig);
 
-                InitializationConfig config = initConfigBuilder.build();
+                this.isNativeValidatorDisabled = configJson.optBoolean("isNativeValidatorDisabled", true);
+            } else {
+                this.isNativeValidatorDisabled = false;
+            }
 
-                MobileAds.initialize(
-                        cordova.getActivity(),
-                        config,
-                        initializationStatus -> {
-                            cordova.getActivity().runOnUiThread(() -> callbackContext.success("Initialized"));
-                        }
-                );
-            } catch (Exception e) {
-                cordova.getActivity().runOnUiThread(() -> callbackContext.error(e.getMessage()));
+            if (this.isNativeValidatorDisabled) {
+                initConfigBuilder.setNativeValidatorDisabled();
             }
-        });
-    }
+
+            InitializationConfig config = initConfigBuilder.build();
+
+            MobileAds.initialize(
+                    cordova.getActivity(),
+                    config,
+                    initializationStatus -> {
+                        cordova.getActivity().runOnUiThread(() -> callbackContext.success("Initialized"));
+                    }
+            );
+        } catch (Exception e) {
+            cordova.getActivity().runOnUiThread(() -> callbackContext.error(e.getMessage()));
+        }
+    });
+}
 
     private String getAppIdFromManifest() {
         try {

package/src/android/AppOpenAdPreloadExecutor.java

@@ -0,0 +1,285 @@
+package com.emi.cordova.admob.nextgen;
+
+import android.util.Log;
+
+import androidx.annotation.NonNull;
+
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.CordovaInterface;
+import org.apache.cordova.CordovaWebView;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.Date;
+
+import com.google.android.libraries.ads.mobile.sdk.appopen.AppOpenAd;
+import com.google.android.libraries.ads.mobile.sdk.appopen.AppOpenAdEventCallback;
+import com.google.android.libraries.ads.mobile.sdk.appopen.AppOpenAdPreloader;
+import com.google.android.libraries.ads.mobile.sdk.common.AdRequest;
+import com.google.android.libraries.ads.mobile.sdk.common.AdValue;
+import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError;
+import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError;
+import com.google.android.libraries.ads.mobile.sdk.common.PreloadCallback;
+import com.google.android.libraries.ads.mobile.sdk.common.PreloadConfiguration;
+import com.google.android.libraries.ads.mobile.sdk.common.ResponseInfo;
+
+public class AppOpenAdPreloadExecutor {
+
+    private static final String TAG = "AdMobAppOpenPreload";
+
+    private CordovaInterface cordova;
+    private CordovaWebView webView;
+
+    private String currentAdUnitId = null;
+
+    private boolean isAutoShow = false;
+    private long retryInterval = 5000;
+
+    private long lastLoadTime = 0;
+
+    private boolean isShowingAd = false;
+    private long lastAdDismissTime = 0;
+
+    public AppOpenAdPreloadExecutor(CordovaInterface cordova, CordovaWebView webView) {
+        this.cordova = cordova;
+        this.webView = webView;
+    }
+
+    public void startPreload(JSONArray args, CallbackContext callbackContext) {
+        try {
+            long currentTime = new Date().getTime();
+            String adUnitId = null;
+
+            if (args != null && args.length() > 0) {
+                JSONObject options = args.optJSONObject(0);
+                if (options != null) {
+                    if (options.has("adUnitId")) {
+                        adUnitId = options.getString("adUnitId");
+                    }
+                    if (options.has("isAutoShow")) {
+                        this.isAutoShow = options.getBoolean("isAutoShow");
+                    }
+                    if (options.has("retryInterval")) {
+                        this.retryInterval = options.getLong("retryInterval");
+                    }
+                } else {
+                    adUnitId = args.getString(0);
+                }
+            } else {
+
+                if (callbackContext != null) callbackContext.error("adUnitId is required");
+                return;
+            }
+
+            if (adUnitId != null) {
+                this.currentAdUnitId = adUnitId;
+            }
+
+            if ((currentTime - lastLoadTime) < retryInterval) {
+                if (callbackContext != null) {
+                    callbackContext.success("Preload request debounced.");
+                }
+                return;
+            }
+
+            lastLoadTime = currentTime;
+
+            PreloadCallback preloadCallback = new PreloadCallback() {
+                @Override
+                public void onAdFailedToPreload(@NonNull String preloadId, @NonNull LoadAdError loadAdError) {
+                    try {
+                        JSONObject errData = new JSONObject();
+                        errData.put("preloadId", preloadId);
+                        errData.put("code", loadAdError.getCode());
+                        errData.put("message", loadAdError.getMessage());
+                        fireEvent("on.appopen.preload.failed", errData);
+                    } catch (JSONException ignored) {}
+                }
+
+                @Override
+                public void onAdsExhausted(@NonNull String preloadId) {
+                    try {
+                        JSONObject data = new JSONObject();
+                        data.put("preloadId", preloadId);
+                        fireEvent("on.appopen.preload.exhausted", data);
+                    } catch (JSONException ignored) {}
+                }
+
+                @Override
+                public void onAdPreloaded(@NonNull String preloadId, @NonNull ResponseInfo responseInfo) {
+                    try {
+                        JSONObject data = new JSONObject();
+                        data.put("preloadId", preloadId);
+                        fireEvent("on.appopen.preload.loaded", data);
+                    } catch (JSONException ignored) {}
+                }
+            };
+
+            AdRequest adRequest = new AdRequest.Builder(this.currentAdUnitId).build();
+            PreloadConfiguration preloadConfiguration = new PreloadConfiguration(adRequest);
+
+            cordova.getActivity().runOnUiThread(() -> {
+                AppOpenAdPreloader.start(this.currentAdUnitId, preloadConfiguration, preloadCallback);
+                if (callbackContext != null) {
+                    callbackContext.success("App open preload started");
+                }
+            });
+
+        } catch (Exception e) {
+            if (callbackContext != null) {
+                callbackContext.error("Exception: " + e.getMessage());
+            }
+        }
+    }
+
+    public void showPolledAd(JSONArray args, CallbackContext callbackContext) {
+        if (isShowingAd) {
+
+            if (callbackContext != null) callbackContext.error("Ad already showing.");
+            return;
+        }
+
+        if (new Date().getTime() - lastAdDismissTime < 1000) {
+
+            if (callbackContext != null) callbackContext.error("Ad in cooldown period.");
+            return;
+        }
+
+        try {
+            String adUnitId = this.currentAdUnitId;
+
+            if (args != null && args.length() > 0) {
+                JSONObject options = args.optJSONObject(0);
+                if (options != null && options.has("adUnitId")) {
+                    adUnitId = options.getString("adUnitId");
+                } else {
+                    String stringArg = args.optString(0, null);
+                    if (stringArg != null && !stringArg.isEmpty() && !stringArg.equals("null")) {
+                        adUnitId = stringArg;
+                    }
+                }
+            }
+
+            if (adUnitId == null) {
+                if (callbackContext != null) callbackContext.error("No Ad Unit ID available.");
+                return;
+            }
+
+            final String finalAdUnitId = adUnitId;
+
+            this.isShowingAd = true;
+
+            cordova.getActivity().runOnUiThread(() -> {
+                AppOpenAd ad = AppOpenAdPreloader.pollAd(finalAdUnitId);
+
+                if (ad == null) {
+
+                    this.isShowingAd = false;
+
+                    try {
+                        JSONObject errData = new JSONObject();
+                        errData.put("message", "No preloaded app open ads available.");
+                        fireEvent("on.appopen.preload.failed.show", errData);
+                    } catch (JSONException ignored) {}
+
+                    if (callbackContext != null) {
+                        callbackContext.error("No preloaded app open ads available.");
+                    }
+                    return;
+                }
+
+                ad.setAdEventCallback(new AppOpenAdEventCallback() {
+                    @Override
+                    public void onAdPaid(@NonNull AdValue adValue) {
+                        try {
+                            JSONObject data = new JSONObject();
+                            data.put("value", adValue.getValueMicros());
+                            data.put("currency", adValue.getCurrencyCode());
+                            data.put("precision", adValue.getPrecisionType());
+                            fireEvent("on.appopen.preload.revenue", data);
+                        } catch (JSONException ignored) {}
+                    }
+
+                    @Override
+                    public void onAdShowedFullScreenContent() {
+                        fireEvent("on.appopen.preload.shown", null);
+                    }
+
+                    @Override
+                    public void onAdDismissedFullScreenContent() {
+                        isShowingAd = false;
+                        lastAdDismissTime = new Date().getTime();
+                        fireEvent("on.appopen.preload.dismissed", null);
+                    }
+
+                    @Override
+                    public void onAdFailedToShowFullScreenContent(@NonNull FullScreenContentError error) {
+                        isShowingAd = false;
+                        try {
+                            JSONObject errData = new JSONObject();
+                            errData.put("code", error.getCode());
+                            errData.put("message", error.getMessage());
+                            fireEvent("on.appopen.preload.failed.show", errData);
+                        } catch (JSONException ignored) {}
+                    }
+
+                    @Override
+                    public void onAdImpression() {
+                        fireEvent("on.appopen.preload.impression", null);
+                    }
+
+                    @Override
+                    public void onAdClicked() {
+                        fireEvent("on.appopen.preload.clicked", null);
+                    }
+                });
+
+                ad.show(cordova.getActivity());
+
+                if (callbackContext != null) {
+                    callbackContext.success("Showing preloaded app open ad");
+                }
+            });
+
+        } catch (Exception e) {
+            this.isShowingAd = false; 
+
+            if (callbackContext != null) callbackContext.error("Exception: " + e.getMessage());
+        }
+    }
+
+    public void checkAdAvailable(JSONArray args, CallbackContext callbackContext) {
+        boolean available = hasAvailableAd();
+        if (callbackContext != null) {
+            callbackContext.success(available ? 1 : 0);
+        }
+    }
+
+    public boolean shouldAutoShow() {
+        return this.isAutoShow;
+    }
+
+    public boolean hasAvailableAd() {
+        if (this.currentAdUnitId == null) return false;
+        return AppOpenAdPreloader.isAdAvailable(this.currentAdUnitId);
+    }
+
+    private void fireEvent(String eventName, JSONObject data) {
+        if (cordova == null) return;
+        cordova.getActivity().runOnUiThread(() -> {
+            StringBuilder js = new StringBuilder();
+            js.append("javascript:cordova.fireDocumentEvent('");
+            js.append(eventName);
+            js.append("'");
+            if (data != null) {
+                js.append(", ");
+                js.append(data.toString());
+            }
+            js.append(");");
+            if (webView != null && webView.getView() != null) {
+                webView.loadUrl(js.toString());
+            }
+        });
+    }
+}