cordova-plugin-admob-nextgen 1.3.9 → 1.4.9

package/README.md

@@ -11,7 +11,9 @@
 
 **The Ultimate AdMob Monetization Solution for Cordova/Capacitor/Framework7.**
 
-This plugin is a complete **rewrite and re-architecture** of the classic AdMob integration, built specifically for the **[Google Mobile Ads Next Generation SDK](https://ads-developers.googleblog.com/2026/01/announcing-google-mobile-ads-next-gen.html)**. It moves away from legacy implementations to modern `SurfaceControl`, optimized layouts, and background threading, ensuring maximum performance, stability, and revenue.
+This plugin is a complete **rewrite and re-architecture** of the classic AdMob integration, built specifically for the **[Google Mobile Ads Next Generation SDK](https://ads-developers.googleblog.com/2026/01/announcing-google-mobile-ads-next-gen.html)**. 
+
+It moves away from legacy implementations to modern `SurfaceControl`, optimized layouts, and background threading, ensuring maximum performance, stability, and revenue.
 
 > **Maintained by the original creator of [EMI-INDO/emi-indo-cordova-plugin-admob](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob).** This is not just an update; it is a brand new engine designed for 2026 and beyond.
 
@@ -19,64 +21,105 @@ This plugin is a complete **rewrite and re-architecture** of the classic AdMob i
 
 ## 🚀 Why Next-Gen?
 
-Google has introduced a fundamental shift in how ads are rendered on Android. This plugin aligns perfectly with those changes to solve the most critical issues developers face today:
+Google has introduced a fundamental shift in how ads are rendered on Android. 
 
-1.  **Lifecycle Stability:** Solves the notorious issue where Full-Screen Ads (Interstitial, Rewarded, App Open) would crash or disappear when the app goes to the background and returns to the foreground.
-2.  **Android 15+ Compatibility:** Includes a built-in workaround for the [Android 15 Edge-to-Edge enforcement](https://groups.google.com/g/google-admob-ads-sdk/c/WyGsRV--EoE). It ensures the "Close/X" buttons on full-screen ads are never hidden behind the system navigation bar (API Level 35 fix).
-3.  **Clean Architecture:** Written from scratch using the official [Next Gen SDK Examples](https://github.com/googleads/gma-next-gen-sdk-android-examples), ensuring long-term compliance with Google Policies.
+This plugin aligns perfectly with those changes to solve the most critical issues developers face today:
+
+1. **ANR Error Elimination:** 
+   The legacy SDK is notorious for causing ANR (Application Not Responding) errors in the Google Play Console. This Next-Gen architecture fully resolves these threading bottlenecks. 
+   *(See [Google's Next-Gen Announcement](https://ads-developers.googleblog.com/2026/01/announcing-google-mobile-ads-next-gen.html))*
+
+2. **Lifecycle Stability:** 
+   Solves the notorious issue where Full-Screen Ads (Interstitial, Rewarded, App Open) would crash or disappear when the app goes to the background and returns to the foreground.
+
+3. **Smart Runtime Engine (Android 15 Edge-to-Edge):** 
+   Intelligently detects and handles Android 14 (API 35) vs Android 15 (API 36) edge-to-edge conditions at runtime.
+   * Automatically secures the "Close/X" buttons on full-screen ads.
+   * When using the banner parameter `isOverlapping: false`, it intelligently calculates the system safe bottom insets to push the WebView content up perfectly.
+   * Ensures neither the ad nor your app UI is hidden behind the system navigation bar.
+   * Requires **zero** manual configuration from the user. 
+   *(See [Release v1.3.9-beta.1](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen/releases/tag/v1.3.9-beta.1))*
+
+4. **Cordova & Capacitor Agnostic:** 
+   Intelligently identifies whether the runtime environment is Cordova or Capacitor (including deep native Java logic adjustments) to provide seamless compatibility.
+
+5. **Clean Architecture:** 
+   Written from scratch using the official [Next Gen SDK Examples](https://github.com/googleads/gma-next-gen-sdk-android-examples), ensuring long-term compliance with Google Policies.
 
----
 
 ## 💰 Mission: Revenue Maximization
 
-This plugin is designed with one goal: **increasing your eCPM and fill rates**. We have implemented advanced formats and technologies that are proven to outperform standard implementations.
+This plugin is designed with one goal: 
+
+**increasing your eCPM and fill rates**. 
+
+ It incorporates advanced formats and technologies that are proven to outperform standard implementations.
 
 ### 1. True Next-Gen Speed: Ad Preloading API ⚡
-This is the **real** Next-Gen feature. We have implemented the specific Preload API methods: `startBannerPreload` and `showPreloadedBanner`.
+This is the **real** Next-Gen feature, this plugin implements the specific Preload API methods: `startBannerPreload` and `showPreloadedBanner`.
 * **Zero Latency:** Instead of loading an ad when you need it, the plugin maintains a "pool" of ready-to-show ads in the background.
 * **Instant Show:** When you call `showPreloadedBanner`, the ad appears instantly (0ms delay) from the pool.
 
 ### 2. Collapsible Banners (The Revenue Booster)
-Standard banners are often ignored by users. This plugin supports **Collapsible Banners** natively.
-* **Impact:** Typically delivers **3-5% higher revenue** than standard banners.
+Standard banners are often ignored by users. 
+
+This plugin supports **Collapsible Banners** natively.
+* **Impact:** Typically delivers **3-5% higher revenue** than standard or large adaptive banners.
 * **Mechanism:** Shows a larger ad initially (anchored top/bottom) that can be collapsed by the user, drastically increasing visibility and click-through rates (CTR).
 
 ### 3. Native Advanced Overlay (The Banner Killer)
-Move beyond simple 320x50 banners. The Native Overlay feature allows you to render high-performance Native Ads that look like system notifications.
+Move beyond simple 320x50 banners. 
+
+The Native Overlay feature allows you to render high-performance Native Ads that look like system notifications.
 * **Impact:** Can yield **5-10% higher revenue** compared to standard banners due to higher advertiser demand for Native assets.
 * **Smart Templates:**
     * `banner_bottom`: A sleek, notification-style ad docked at the bottom.
     * `banner_top`: Docked at the top.
     * `modal_center`: A popup-style native ad.
-    * **Policy Safe:** Includes an `isOverlapping` parameter. You can choose to overlay the ad (float) or push the webview content (safe layout), preventing accidental clicks.
-
----
+* **Policy Safe:** Includes an `isOverlapping` parameter.
+* You can choose to overlay the ad (float) or push the webview content (safe layout), preventing accidental clicks.
 
 
 ## 🛡️ Safety & Reliability
 
-We prioritize the safety of your AdMob account and the stability of your app.
+This plugin prioritizes the safety of your AdMob account and the stability of your app.
 
-* **Smart Throttling (`retryInterval`)**: Prevents accidental spamming of ad requests using a global interval validation.
+* **Smart Throttling (`retryInterval`)**: Solves the dreaded "high requests, low impressions" (Invalid Traffic / IVT) issue.
 
-- If the loadAd or showAd function is called repeatedly accidentally by JavaScript (for example because it is tied to a scroll event or application loop), the system will continuously call loadAd or showAd.
-### This will cause two fatal problems:
-1. Banner Ad Flickering: Ads are constantly being destroyed and redrawn.
-2. Account Ban: Aggressively pulling ads (spamming impressions) is a serious violation of AdMob's Invalid Traffic (IVT) policy.
+* This parameter acts as a strict anti-spam safeguard.
+* If an ad load is accidentally triggered repeatedly by an app logic error (e.g., game loop, tick, or scroll event) before the ad surfaces and is viewed by the user, the `retryInterval` automatically blocks the redundant requests.
+  
+  **Without this safeguard, you face two fatal problems:**
+  1. **Banner Ad Flickering:** Ads are constantly being destroyed and redrawn before becoming visible.
+  2. **Account Ban:** Aggressively pulling ads (spamming requests without impressions) is a serious violation of AdMob's Invalid Traffic policy.
 
 * **Background Thread Loading**: All ad requests are dispatched on background threads, ensuring your app's UI never freezes.
 
+
 ---
 
 
-## Cordova/Capacitor/Framework7 AdMob Next-Gen: Installation & Usage Guide
+## 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)
 ---
 
+### 📦 Current SDK Versions (Maintained & Up-to-Date)
+
+This plugin is regularly updated to support the latest standards.
+
+| Component | Platform | Version | Release Notes |
+| :--- | :--- | :--- | :--- |
+| **GMA Next-Gen SDK** | Android | **1.1.0** | [View Notes](https://developers.google.com/admob/android/next-gen/rel-notes) |
+| **UMP SDK** | Android | **4.0.0** | [View Notes](https://developers.google.com/admob/android/privacy/release-notes) |
+| **Mobile Ads SDK** | iOS | **13.3.0** | [View Notes](https://developers.google.com/admob/ios/rel-notes) |
+| **UMP SDK** | iOS | **3.1.0** | [View Notes](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/privacy/download) |
+
 ### 🎉 View all plugin release notes
-- 👉 [**Releases**](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen/releases)
+- 👉 [**Releases notes**](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen/releases)
 
 ---
 
@@ -84,14 +127,14 @@ We prioritize the safety of your AdMob account and the stability of your app.
 ## 1. Cordova or Framework7
 
 ### Option A: Via CLI
-Install the plugin directly using the Cordova CLI. You must provide your AdMob App ID.
+Install the plugin directly using the Cordova CLI, You must provide your AdMob App ID.
 
     cordova plugin add cordova-plugin-admob-nextgen --save --variable APP_ID_ANDROID="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy" --variable APP_ID_IOS="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"
 
 ### Option B: Via config.xml
 Add this to your `config.xml` to restore the plugin automatically.
 
-    <plugin name="cordova-plugin-admob-nextgen" spec="latest">
+    <plugin name="cordova-plugin-admob-nextgen">
         <variable name="APP_ID_ANDROID" value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy" />
         <variable name="APP_ID_IOS" value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy" />
     </plugin>
@@ -318,57 +361,6 @@ High-performance native templates.
 
 ---
 
-## 5. Ad Preloading (Banner) - Android Only
-
-Use the background engine to pool ads for 0ms latency.
-
-### Usage
-
-    // 1. Start Engine
-    admobNextGen.startBannerPreload({
-        adUnitId: 'ca-app-pub-xxx/xxx',
-        size: 'ADAPTIVE',     // 'BANNER', 'LARGE_BANNER', 'MEDIUM_RECTANGLE', 'ADAPTIVE', 'FULL_BANNER', 'LEADERBOARD'
-        position: 'bottom',   // 'top' or 'bottom'
-        collapsible: false,   // true = Enable Collapsible Format (High Revenue)
-        isOverlapping: false, 
-        retryInterval: 5000   // Anti-spam delay (ms)
-    });
-
-    // 2. Show Instantly (from pool)
-    admobNextGen.showPreloadedBanner();
-
-    // 3. Stop/Remove Engine
-    admobNextGen.stopBannerPreload();
-
-    // 4. Hide Engine
-    admobNextGen.hideBannerPreload() 
-
-
-    ### Banner Events
-
-    document.addEventListener('on.banner.load', (data) => {
-        console.log("Banner Loaded: " + data.width + "x" + data.height);
-        console.log("Collapsible: " + data.isCollapsible);
-    });
-    document.addEventListener('on.preload.failed', (err) => console.error(err));
-    document.addEventListener('on.banner.revenue', (data) => {
-        console.log("Revenue: " + data.value + " " + data.currency);
-    });
-    document.addEventListener('on.banner.clicked', () => console.log("Clicked"));
-    document.addEventListener('on.banner.impression', () => console.log("Impression"));
-
-    // else
-    on.preload.available
-    on.preload.failed
-    on.preload.exhausted
-    on.banner.opened
-    on.banner.closed
-    on.banner.failed.show
-    on.banner.refreshed
-    on.banner.refresh.failed
-
----
-
 ## 6. App Open Ads
 
 Supports Auto-Resume logic.
@@ -385,9 +377,6 @@ 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));
@@ -504,12 +493,89 @@ Auto-showing rewarded format (no opt-in).
 
 ---
 
+
+## 10. Preloader Engine (Android Only - Next-Gen SDK)
+
+The AdMob Next-Gen SDK introduces a powerful background Preloader Engine that caches ads in a buffer pool, enabling zero-latency ad rendering.
+
+> **⚠️ IMPORTANT WARNING & BEST PRACTICES:**
+> * **Android Only:** The Preloader engine is currently an exclusive feature of the Android Next-Gen SDK.
+> * **Strict Method Separation:** NEVER mix Classic methods with Preloader methods to avoid logic conflicts. 
+>   * If you use `createBanner`, you MUST use `showBanner`. 
+>   * If you use `startBannerPreload`, you MUST use `showPreloadedBanner`.
+> * **Cross-Platform (iOS) Consideration:** Events are unified. A `source` flag (`data.source === "preloader"`) is injected into the event data on Android. However, it is highly recommended to maintain a single unified logic flow. Relying strictly on the `source === "preloader"` condition will cause issues on iOS, as iOS relies entirely on the Classic implementation.
+
+### Method Mapping (Classic vs Preloader)
+
+| Ad Format | Start Preload | Show Polled Ad | Other Preload Methods |
+| :--- | :--- | :--- | :--- |
+| **Banner** | `startBannerPreload(obj)` | `showPreloadedBanner()` | `stopBannerPreload()`, `hideBannerPreload()` |
+| **App Open** | `startAppOpenPreload(obj)` | `showPreloadedAppOpenAd()` | `isAppOpenAdAvailable()` |
+| **Interstitial** | `startInterstitialPreload(obj)` | `showPreloadedInterstitial()` | `stopInterstitialPreload()`, `isInterstitialAdAvailable()` |
+| **Rewarded** | `startRewardedPreload(obj)` | `showPreloadedRewarded()` | `stopRewardedPreload()`, `isRewardedAdAvailable()` |
+| **Rewarded Interstitial** | `startRewardedInterstitialPreload(obj)` | `showPreloadedRewardedInterstitial()` | `stopRewardedInterstitialPreload()`, `isRewardedInterstitialAdAvailable()` |
+
+### Implementation Example
+
+- [⚡ Example preloading ](https://github.com/swaplab-engine/cordova-plugin-admob-nextgen/tree/main/simple-example/www/js/preloading)
+
+**1. Start the Preloader**
+Run this once (e.g., after SDK initialization). The engine will automatically maintain the buffer in the background.
+
+```javascript
+admobNextGen.startRewardedPreload({
+    adUnitId: 'ca-app-pub-xxx/xxx',
+    bufferSize: 2,         // (Optional) Number of ads to cache. Default: 1 max 3
+    isAutoShow: false,     // (Optional) Show immediately when the first ad is ready
+    retryInterval: 5000    // (Optional) Anti-spam protection in ms
+});
+```
+
+**2. Show the Preloaded Ad**
+Call this when the user interacts with your app. It will render instantly from the local buffer.
+
+```javascript
+admobNextGen.showPreloadedRewarded();
+```
+
+### Unified Events & Preloader Exclusives
+
+To streamline development, the Preloader triggers the **exact same lifecycle events** as the Classic mode (e.g., `on.rewarded.loaded`, `on.rewarded.dismissed`). You only need to write one event listener for both modes.
+
+**Preloader Exclusive Event:**
+The only event strictly unique to the Preloader is the `exhausted` event. This fires when the buffer pool is completely empty and the SDK stops trying to fetch new ads.
+
+```javascript
+// Example: Unique Preloader Event
+document.addEventListener('on.rewarded.exhausted', () => {
+    console.warn("Background ad buffer is empty!");
+});
+```
+
+**Optional: Checking the Event Source**
+If you need to execute specific conditional logic for the preloader, you can check `data.source`. *(Remember: This flag is Android-only).*
+
+```javascript
+document.addEventListener('on.rewarded.loaded', (e) => {
+    let data = e.data || e;
+    
+    if (data && data.source === "preloader") {
+        console.log("Ad loaded via Android Preloader Engine");
+    } else {
+        console.log("Ad loaded via Classic Engine (or iOS)");
+    }
+});
+```
+
+---
+
+
 ## ⚖️ Revenue Policy
 
 **No Ad-Sharing. No Hidden Fees.**
 
 Unlike many other free plugins, this project is clean:
-* **0% Revenue Share:** We do not inject our own Ad Unit IDs into your traffic.
+* **0% Revenue Share:** This plugin do not inject our own Ad Unit IDs into your traffic.
 * **100% Control:** Every impression and click goes directly to your AdMob account.
 * **Transparent Source:** The code is open source. You can verify that no third-party SDKs or hidden backdoors exist.
 
@@ -517,7 +583,8 @@ Unlike many other free plugins, this project is clean:
 
 ## ❤️ Support the Project
 
-This plugin is developed and maintained in my free time. If it saved you hours of work, consider supporting the development!
+This plugin is developed and maintained in my free time. 
+If it saved you hours of work, consider supporting the development!
 
 <a href="https://www.buymeacoffee.com/emi.indo" target="_blank">
   <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" >

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cordova-plugin-admob-nextgen",
-  "version": "1.3.9",
+  "version": "1.4.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.3.9" 
+        version="1.4.9" 
         xmlns="http://apache.org/cordova/ns/plugins/1.0" 
         xmlns:android="http://schemas.android.com/apk/res/android">
 
@@ -28,15 +28,15 @@
             <uses-permission android:name="android.permission.INTERNET" />
         </config-file>
 
+        <!-- hooks: Prevent conflicts with legacy SDKs when using mediation -->
         <framework src="src/android/hooks/admob-nextgen.gradle" custom="true" type="gradleReference" />
 
         <framework src="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:$NEXT_GEN_SDK_VERSION" />
         <framework src="com.google.android.ump:user-messaging-platform:$UMP_VERSION" />
 
+        <!-- Android | IOS -->
         <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" />
@@ -44,11 +44,18 @@
         <source-file src="src/android/RewardedInterstitialExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />
         <source-file src="src/android/ConsentExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />
         <source-file src="src/android/GlobalSettingsExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen" />
+        <!-- Only Android -->
+        <source-file src="src/android/preloading/AppOpenAdPreloadExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen/preloading" />
+        <source-file src="src/android/preloading/BannerPreloadExecutor.java" target-dir="app/src/main/java/com/emi/cordova/admob/nextgen/preloading" />
+        <source-file src="src/android/preloading/InterstitialPreloadExecutor.java" target-dir="src/com/emi/cordova/admob/nextgen/preloading" />
+        <source-file src="src/android/preloading/RewardedPreloadExecutor.java" target-dir="src/com/emi/cordova/admob/nextgen/preloading" />
+        <source-file src="src/android/preloading/RewardedInterstitialPreloadExecutor.java" target-dir="src/com/emi/cordova/admob/nextgen/preloading" />
         
     </platform>
 
-    <preference name="NEXT_GEN_SDK_VERSION" default="1.0.1" />
+    <preference name="NEXT_GEN_SDK_VERSION" default="1.1.0" />
     <preference name="UMP_VERSION" default="4.0.0" />
+    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
     <preference name="APP_ID_ANDROID" default="ca-app-pub-3940256099942544~3347511713" />
 
    <platform name="ios">
@@ -152,7 +159,7 @@
         <header-file src="src/ios/RewardedInterstitialExecutor.h" />
         <source-file src="src/ios/RewardedInterstitialExecutor.m" />
     </platform>
-
+    <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~1458002511 -->
     <preference name="APP_ID_IOS" default="ca-app-pub-3940256099942544~1458002511" />
 
 </plugin>

package/src/android/AdMobNextGen.java

@@ -1,5 +1,11 @@
 package com.emi.cordova.admob.nextgen;
 
+import com.emi.cordova.admob.nextgen.preloading.AppOpenAdPreloadExecutor;
+import com.emi.cordova.admob.nextgen.preloading.BannerPreloadExecutor;
+import com.emi.cordova.admob.nextgen.preloading.InterstitialPreloadExecutor;
+import com.emi.cordova.admob.nextgen.preloading.RewardedPreloadExecutor;
+import com.emi.cordova.admob.nextgen.preloading.RewardedInterstitialPreloadExecutor;
+
 import android.app.Activity;
 import android.app.Application; 
 import android.content.Context;
@@ -40,8 +46,12 @@ public class AdMobNextGen extends CordovaPlugin {
 
     private BannerPreloadExecutor bannerPreloadExecutor;
     private AppOpenAdPreloadExecutor appOpenAdPreloadExecutor;
+    private InterstitialPreloadExecutor interstitialPreloadExecutor;
+    private RewardedPreloadExecutor rewardedPreloadExecutor;
+    private RewardedInterstitialPreloadExecutor rewardedInterstitialPreloadExecutor;
 
     private boolean isNativeValidatorDisabled = true;
+    public static boolean isInitialized = false;
 
     @Override
     public void pluginInitialize() {
@@ -49,19 +59,24 @@ public class AdMobNextGen extends CordovaPlugin {
 
         applyAdMobAPI35WorkaroundIfNeeded(cordova.getActivity().getApplication());
 
+        globalSettingsExecutor = new GlobalSettingsExecutor(cordova);
+        consentExecutor = new ConsentExecutor(cordova, webView);
+        appOpenAdExecutor = AppOpenAdExecutor.getInstance();
+        appOpenAdExecutor.initialize(cordova, webView);
+
         bannerExecutor = new BannerExecutor(cordova, webView);
         interstitialExecutor = new InterstitialExecutor(cordova, webView);
         rewardedExecutor = new RewardedExecutor(cordova, webView);
         rewardedInterstitialExecutor = new RewardedInterstitialExecutor(cordova, webView);
-        consentExecutor = new ConsentExecutor(cordova, webView);
-        globalSettingsExecutor = new GlobalSettingsExecutor(cordova);
 
-        appOpenAdExecutor = AppOpenAdExecutor.getInstance();
-        appOpenAdExecutor.initialize(cordova, webView);
         nativeExecutor = new NativeExecutor(cordova, webView);
 
-        bannerPreloadExecutor = new BannerPreloadExecutor(cordova, webView);
         appOpenAdPreloadExecutor = new AppOpenAdPreloadExecutor(cordova, webView);
+        bannerPreloadExecutor = new BannerPreloadExecutor(cordova, webView);
+        interstitialPreloadExecutor = new InterstitialPreloadExecutor(cordova, webView);
+        rewardedPreloadExecutor = new RewardedPreloadExecutor(cordova, webView);
+        rewardedInterstitialPreloadExecutor = new RewardedInterstitialPreloadExecutor(cordova, webView);
+
     }
 
     @Override
@@ -115,44 +130,12 @@ public class AdMobNextGen extends CordovaPlugin {
             return true;
         }
 
-        if ("startBannerPreload".equals(action)) {
-            bannerPreloadExecutor.startPreload(args, callbackContext);
-            return true;
-        }
-        if ("showPreloadedBanner".equals(action)) {
-            bannerPreloadExecutor.showPolledAd(args, callbackContext);
-            return true;
-        }
-        if ("stopBannerPreload".equals(action)) {
-            bannerPreloadExecutor.stopPreloadAndClear();
-            callbackContext.success();
-            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);
@@ -181,6 +164,7 @@ public class AdMobNextGen extends CordovaPlugin {
             nativeExecutor.createNativeAd(args, callbackContext);
             return true;
         }
+
         if ("removeNativeAd".equals(action)) {
             nativeExecutor.removeNativeAd();
             callbackContext.success();
@@ -189,6 +173,7 @@ public class AdMobNextGen extends CordovaPlugin {
 
         if ("createInterstitial".equals(action)) {
             interstitialExecutor.createInterstitial(args, callbackContext);
+            callbackContext.success();
             return true;
         }
         if ("showInterstitial".equals(action)) {
@@ -200,6 +185,7 @@ public class AdMobNextGen extends CordovaPlugin {
             rewardedExecutor.createRewarded(args, callbackContext);
             return true;
         }
+
         if ("showRewarded".equals(action)) {
             rewardedExecutor.showRewarded(callbackContext);
             return true;
@@ -209,11 +195,101 @@ public class AdMobNextGen extends CordovaPlugin {
             rewardedInterstitialExecutor.createRewardedInterstitial(args, callbackContext);
             return true;
         }
+
         if ("showRewardedInterstitial".equals(action)) {
             rewardedInterstitialExecutor.showRewardedInterstitial(callbackContext);
             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 ("startBannerPreload".equals(action)) {
+            bannerPreloadExecutor.startPreload(args, callbackContext);
+            return true;
+        }
+        if ("showPreloadedBanner".equals(action)) {
+            bannerPreloadExecutor.showPolledAd(args, callbackContext);
+            return true;
+        }
+        if ("stopBannerPreload".equals(action)) {
+            bannerPreloadExecutor.stopPreloadAndClear();
+            callbackContext.success();
+            return true;
+        }
+
+        if ("hideBannerPreload".equals(action)) {
+            bannerPreloadExecutor.hideBanner(callbackContext);
+            return true;
+        }
+
+        if ("startInterstitialPreload".equals(action)) {
+            interstitialPreloadExecutor.startPreload(args, callbackContext);
+            return true;
+        }
+        if ("showPreloadedInterstitial".equals(action)) {
+            interstitialPreloadExecutor.showPolledAd(args, callbackContext);
+            return true;
+        }
+        if ("isInterstitialAdAvailable".equals(action)) {
+            interstitialPreloadExecutor.checkAdAvailable(args, callbackContext);
+            return true;
+        }
+        if ("stopInterstitialPreload".equals(action)) {
+            interstitialPreloadExecutor.stopPreloadAndClear(callbackContext);
+            return true;
+        }
+
+        if ("startRewardedPreload".equals(action)) {
+            rewardedPreloadExecutor.startPreload(args, callbackContext);
+            return true;
+        }
+
+        if ("showPreloadedRewarded".equals(action)) {
+            rewardedPreloadExecutor.showPolledAd(args, callbackContext);
+            return true;
+        }
+
+        if ("isRewardedAdAvailable".equals(action)) {
+            rewardedPreloadExecutor.checkAdAvailable(args, callbackContext);
+            return true;
+        }
+
+        if ("stopRewardedPreload".equals(action)) {
+            rewardedPreloadExecutor.stopPreloadAndClear(callbackContext);
+            return true;
+        }
+
+        if ("startRewardedInterstitialPreload".equals(action)) {
+            rewardedInterstitialPreloadExecutor.startPreload(args, callbackContext);
+            return true;
+        }
+
+        if ("showPreloadedRewardedInterstitial".equals(action)) {
+            rewardedInterstitialPreloadExecutor.showPolledAd(args, callbackContext);
+            return true;
+        }
+
+        if ("isRewardedInterstitialAdAvailable".equals(action)) {
+            rewardedInterstitialPreloadExecutor.checkAdAvailable(args, callbackContext);
+            return true;
+        }
+
+        if ("stopRewardedInterstitialPreload".equals(action)) {
+            rewardedInterstitialPreloadExecutor.stopPreloadAndClear(callbackContext);
+            return true;
+        }
+
         return false;
     }
 
@@ -262,6 +338,7 @@ public class AdMobNextGen extends CordovaPlugin {
                     cordova.getActivity(),
                     config,
                     initializationStatus -> {
+                        isInitialized = true;
                         cordova.getActivity().runOnUiThread(() -> callbackContext.success("Initialized"));
                     }
             );

package/src/android/AppOpenAdExecutor.java

@@ -1,5 +1,7 @@
 package com.emi.cordova.admob.nextgen;
 
+import static com.emi.cordova.admob.nextgen.AdMobNextGen.isInitialized;
+
 import android.app.Activity;
 import android.util.Log;
 
@@ -56,6 +58,10 @@ public class AppOpenAdExecutor {
     }
 
     public void loadAd(JSONArray args, CallbackContext callbackContext) {
+        if (!isInitialized) {
+            callbackContext.error("SDK not initialized");
+            return;
+        }
         try {
             JSONObject options = args.optJSONObject(0);
             String adUnitId;
@@ -89,6 +95,7 @@ public class AppOpenAdExecutor {
         }
 
         if ((currentTime - lastLoadTime) < minLoadInterval) {
+            if (callbackContext != null) callbackContext.error("Request too fast. Please wait " + minLoadInterval + " ms to prevent invalid traffic.");
             return;
         }