cordova-plugin-admob-nextgen 1.0.9 → 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
@@ -98,7 +102,7 @@ Add this to your `config.xml` to restore the plugin automatically.
 ## 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)**.
 
 ---
 
@@ -316,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
 
@@ -361,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.9",
+  "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.9" 
+        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,7 @@ public class AdMobNextGen extends CordovaPlugin {
     private NativeExecutor nativeExecutor;
 
     private BannerPreloadExecutor bannerPreloadExecutor;
+    private AppOpenAdPreloadExecutor appOpenAdPreloadExecutor;
 
     private boolean isNativeValidatorDisabled = true;
 
@@ -60,6 +61,7 @@ public class AdMobNextGen extends CordovaPlugin {
         nativeExecutor = new NativeExecutor(cordova, webView);
 
         bannerPreloadExecutor = new BannerPreloadExecutor(cordova, webView);
+        appOpenAdPreloadExecutor = new AppOpenAdPreloadExecutor(cordova, webView);
     }
 
     @Override
@@ -127,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);
@@ -203,6 +223,11 @@ 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) {

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());
+            }
+        });
+    }
+}