cordova-plugin-admob-nextgen 1.0.9 → 1.2.9

package/README.md

@@ -71,6 +71,16 @@ 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)
+---
+
+### 🎉 View all plugin release notes
+- 👉 [**Releases**](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen/releases)
+
+---
+
+
 ## 1. Cordova or Framework7
 
 ### Option A: Via CLI
@@ -98,7 +108,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)**.
 
 ---
 
@@ -224,6 +234,17 @@ Supports **Adaptive**, **Standard**, and **Collapsible** banners.
         isAutoShow: true
     });
 
+### New large banner adaptive size
+
+>  new banner size min plugin version: 1.2+
+
+- LARGE_LANDSCAPE_ANCHORED_ADAPTIVE
+- LARGE_PORTRAIT_ANCHORED_ADAPTIVE
+- CURRENT_ORIENTATION_INLINE_ADAPTIVE
+- LARGE_ANCHORED_ADAPTIVE
+- PORTRAIT_INLINE_ADAPTIVE
+
+
 ### Banner Methods
 
     admobNextGen.showBanner();
@@ -316,9 +337,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 +385,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/capacitor-hook-admob-ids.js

@@ -104,7 +104,7 @@ function updateIosInfoPlist(appIdIos) {
     setStringKey('NSUserTrackingUsageDescription', 'This identifier will be used to deliver personalized ads to you.');
     
     setBoolKey('GADDelayAppMeasurementInit', true);
-
+    // https://developers.google.com/admob/ios/quick-start
     if (!content.includes('<key>SKAdNetworkItems</key>')) {
         const skAdNetworks = [
             'cstr6suwn9.skadnetwork', '4fzdc2evr5.skadnetwork', '2fnua5tdw4.skadnetwork', 'ydx93a7ass.skadnetwork',
@@ -158,7 +158,7 @@ function run() {
             admob = {
                 APP_ID_ANDROID: appIdAndroid ? appIdAndroid[1] : "ca-app-pub-3940256099942544~3347511713",
                 APP_ID_IOS: appIdIos ? appIdIos[1] : "ca-app-pub-3940256099942544~1458002511",
-                NEXT_GEN_SDK_VERSION: sdk ? sdk[1] : "1.0.0",
+                NEXT_GEN_SDK_VERSION: sdk ? sdk[1] : "1.0.1",
                 UMP_VERSION: ump ? ump[1] : "4.0.0"
             };
         }
@@ -167,7 +167,7 @@ function run() {
         injectExclusionRules();
         if (admob?.NEXT_GEN_SDK_VERSION || admob?.UMP_VERSION) {
             updateGradleDependencies(
-                admob.NEXT_GEN_SDK_VERSION || "1.0.0",
+                admob.NEXT_GEN_SDK_VERSION || "1.0.1",
                 admob.UMP_VERSION || "4.0.0"
             );
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cordova-plugin-admob-nextgen",
-  "version": "1.0.9",
+  "version": "1.2.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.2.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" />
@@ -46,7 +47,7 @@
         
     </platform>
 
-    <preference name="NEXT_GEN_SDK_VERSION" default="1.0.0" />
+    <preference name="NEXT_GEN_SDK_VERSION" default="1.0.1" />
     <preference name="UMP_VERSION" default="4.0.0" />
     <preference name="APP_ID_ANDROID" default="ca-app-pub-3940256099942544~3347511713" />
 

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