emi-indo-cordova-plugin-admob 2.0.6 → 2.0.8

package/README.md

@@ -1,3 +1,132 @@
+### emi-indo-cordova-plugin-admob@2.0.8
+
+
+## Features/method
+- initialize
+- targeting
+- globalSettings
+- AppTrackingTransparency (ATT)
+- CMP SDK
+- UMP SDK
+- CustomConsentManager
+- App Open Ads
+- Banner Ads including (Collapsible)
+- Interstitial Ads
+- Rewarded Ads
+- Adsense
+- Mediation
+- impression-level-ad-revenue
+- targetingAdRequest
+- setPersonalizationState
+- setPPS
+
+## new version of the plugin @2.0.8 or higher
+- Migrate from Mobile Ads SDK (Android) v23 to v24
+- Migrate from Mobile Ads SDK (iOS) SDK version v11 to v12
+- Migrate from Cordova Android 13.0.0 to 14.0.0
+- And maybe some APIs are re-signed, the old api will not be disturbed.
+- https://cordova.apache.org/announcements/2025/03/26/cordova-android-14.0.0.html
+- Full of simple examples: https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/tree/main/example/www/js
+- Check all release notes: https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/
+ ```
+config.xml
+<preference name="fullscreen" value="false | true" />
+<preference name="android-minSdkVersion" value="23" />
+<preference name="android-targetSdkVersion" value="35" />
+  ```
+
+- VIDEO banner top-center: https://www.youtube.com/watch?v=uQrC0k3-VU8
+- VIDEO banner bottom-center: https://www.youtube.com/watch?v=qqxxa2gi7OU
+
+<h3>Screenshots banner ad no overlapping</h3>
+
+<table>
+  <tr>
+    <td align="left"><strong>Banner Ad</strong></td>
+    <td align="center"><strong>Collapsible, no overlapping, non full-screen</strong></td>
+    <td align="center"><strong>Collapsible close, no overlapping, non full-screen</strong></td>
+    <td align="center"><strong>Collapsible, no overlapping, full-screen</strong></td>
+    <td align="center"><strong>Collapsible close, no overlapping, full-screen</strong></td>
+  </tr>
+ 
+  The height of the body is reduced by the height of the banner, || Auto-detect whether it is in full-screen mode or not.
+  
+  <tr>
+    <td></td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/53b832d2-8d15-4450-919b-9833569d0ffb" alt="Banner Ad" />
+    </td>
+   <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/80ebf83f-b8fd-4a4c-8121-e2088005399d" alt="Banner Ad" />
+    </td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/13c3333f-b612-426e-8c3a-1e31695dc548" alt="Banner Ad" />
+    </td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/f4583d93-5764-4d24-a11c-ffdf623cb50a" alt="Banner Ad" />
+    </td>
+  </tr>
+</table>
+
+
+<h3>Screenshots banner ad overlapping</h3>
+
+<table>
+  <tr>
+    <td align="left"><strong>Banner Ad</strong></td>
+    <td align="center"><strong>Collapsible, overlapping, full-screen</strong></td>
+    <td align="center"><strong>Collapsible close, overlapping, full-screen</strong></td>
+    <td align="center"><strong>Collapsible, overlapping, non full-screen</strong></td>
+    <td align="center"><strong>Collapsible close, overlapping, full-screen</strong></td>
+  </tr>
+ 
+  The body height is not reduced, the banner overlaps on top of the body, || Auto-detect whether it is in full-screen mode or not.
+  
+  <tr>
+    <td></td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/14646090-bbc8-4c31-812b-f945faaadd06" alt="Banner Ad" />
+    </td>
+   <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/c78e7879-cab6-4963-ad72-4a68316d7181" alt="Banner Ad" />
+    </td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/840ce3ef-60bb-4f74-9705-61d511d964f0" alt="Banner Ad" />
+    </td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/9342fb3b-bb38-4681-a794-44e25d6b9bd8" alt="Banner Ad" />
+    </td>
+  </tr>
+</table>
+
+
+<h3>Screenshots</h3>
+
+<table>
+  <tr>
+    <td align="left"><strong>Non banner</strong></td>
+    <td align="center"><strong>App Open Ad</strong></td>
+    <td align="center"><strong>Interstitial Ad</strong></td>
+    <td align="center"><strong>Rewarded video or Rewarded Interstitial</strong></td>
+    <td align="center"><strong>Adsense</strong></td>
+  </tr>
+  <tr>
+    <td></td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/fc641c56-5219-4f02-8122-6a42a51f0853" alt="App Open Ad" />
+    </td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/7a5c68f2-18f9-4e23-9464-4a4c307f06ae" alt="Interstitial Ad" />
+    </td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/2d87f85e-5fb7-4bf4-8b86-c2411c35fdcf" alt="Rewarded Ad" />
+    </td>
+    <td align="center">
+      <img width="200" src="https://github.com/user-attachments/assets/14b289c4-74f7-45a7-9a8a-52df8859afec" alt="AdSense" />
+    </td>
+  </tr>
+</table>
+
 
 
 
@@ -11,6 +140,9 @@
  ## Support framework
  - Quasar: https://github.com/quasarframework/quasar/discussions/17706
  - Capacitor: https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/discussions/29
+ - Jquery mobile: https://jquerymobile.com/
+
+
 
 > [!NOTE]  
 > - To maintain this plugin in the long run, 
@@ -20,15 +152,16 @@
  ## 💰Sponsor this project
   [![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/emiindo)  
   [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/F1F16NI8H)
-##  [Check all release notes:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/)
+  
+### Check all release notes: https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/
 
 
-### Mobile Ads SDK (Android: 23.6.0) [Release Notes:](https://developers.google.com/admob/android/rel-notes)
-### User Messaging Platform (UMP Android: 3.1.0) [Release Notes:](https://developers.google.com/admob/android/privacy/release-notes)
+### Mobile Ads SDK (Android: 24.1.0) [Release Notes:](https://developers.google.com/admob/android/rel-notes)
+### User Messaging Platform (UMP Android: 3.2.0) [Release Notes:](https://developers.google.com/admob/android/privacy/release-notes)
 
-### Mobile Ads SDK (IOS: 11.13.0) [Release Notes:](https://developers.google.com/admob/ios/rel-notes)
+### Mobile Ads SDK (IOS: 12.2.0) [Release Notes:](https://developers.google.com/admob/ios/rel-notes)
 
-### User Messaging Platform (UMP IOS: 2.7.0) [Release Notes:](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/privacy/download)
+### User Messaging Platform (UMP IOS: 3.0.0) [Release Notes:](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/privacy/download)
 ### IAB Europe Transparency & Consent Framework (CMP: 2.2.0)
 
 
@@ -36,19 +169,67 @@
 ## Documentation Capacitor example
 -  [Documentation Capacitor example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/discussions/29)
 
-### This is not a dependency, it's a separate plugin but highly recommended.
-https://github.com/EMI-INDO/emi-indo-cordova-plugin-fanalytics
+
 
 ## New example 
 - https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/tree/main/example/www
 
+## Version locking the plugin during production is highly recommended.
+
+- Example cordova plugin add emi-indo-cordova-plugin-admob@1.6.0 --save --variable APP_ID_ANDROID=ca-app-pub-xxx~xxx
+- View plugin version: https://www.npmjs.com/package/emi-indo-cordova-plugin-admob?activeTab=versions
+- Release notes: https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases
+
+## Installation
+- Only platform Android
+```sh
+cordova plugin add emi-indo-cordova-plugin-admob --save --variable APP_ID_ANDROID=ca-app-pub-xxx~xxx
+```
+
+- Only platform IOS
+```sh
+cordova plugin add emi-indo-cordova-plugin-admob --save --variable APP_ID_IOS=ca-app-pub-xxx~xxx
+```
 
-## Minimum Cordova Engines
-- cordova-android version = 12.0.0
+- Platform Both
+```sh
+cordova plugin add emi-indo-cordova-plugin-admob --save --variable APP_ID_ANDROID=ca-app-pub-xxx~xxx --variable APP_ID_IOS=ca-app-pub-xxx~xxx
+```
+
+## Remove
+```sh
+cordova plugin rm emi-indo-cordova-plugin-admob
+```
+
+## Note IOS
+> [!NOTE]  
+> - To prevent some warnings or errors in xcode later, it is best after adding platforms and plugins cd/project root/command line run cordova prepare.
+> - after that just cd platform/ios command line run pod install --repo-update
+
+## Import the Mobile Ads SDK IOS
+### Then from the command line run:
+- cd platforms/ios 
+- Then run cordova prepare
+### Then from the command line run:
+- pod install --repo-update
+
+
+### This is not a dependency, it's a separate plugin but highly recommended.
+https://github.com/EMI-INDO/emi-indo-cordova-plugin-fanalytics
+
+
+## Older versions of plugins
+
+<details>
+<summary>Older versions of plugins</summary>
+
+
+### Minimum Cordova Engines
+- cordova-android version = 13.0.0
 - cordova-ios version = 7.0.0
 
 
-## IOS Ad Support IOS 18 *
+### IOS Ad Support IOS 18 *
 - Fix error build IOS: https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/discussions/42
 - Mobile Ads SDK (IOS: 11.12.0)
 - emi-indo-cordova-plugin-admob@1.6.3 or higher requires cocoapods 1.16.2 or higher
@@ -57,7 +238,7 @@ https://github.com/EMI-INDO/emi-indo-cordova-plugin-fanalytics
 > - emi-indo-cordova-plugin-admob@1.5.2 or higher
 > - Minimum supported Xcode version up to 15.3 or higher
 > - minimum deployment-target: 12.2
-## Minimum macOS | Xcode, and others
+### Minimum macOS | Xcode, and others
 - minimum macOS 14.4 or higher
 - Xcode min 15.3 > or higher
 - Command Line Tools 15.3 or higher
@@ -67,7 +248,7 @@ https://github.com/EMI-INDO/emi-indo-cordova-plugin-fanalytics
 - Dependency: pod MerchantKit (not needed)
 
 
-## IOS
+### IOS
 > [!WARNING]
 > - emi-indo-cordova-plugin-admob@1.5.1
 > - Minimum supported Xcode version to 14.3
@@ -78,6 +259,8 @@ https://github.com/EMI-INDO/emi-indo-cordova-plugin-fanalytics
 - Command Line Tools 14.1 or higher
 https://developers.google.com/admob/ios/quick-start
 
+</details>
+
 <details>
 <summary>Guaranteed income using this plugin #14</summary>
 
@@ -92,6 +275,11 @@ https://developers.google.com/admob/ios/quick-start
 > - 
 </details>
 
+
+## Video test of the old version of the plugin
+<details>
+<summary>Video test of the old version of the plugin</summary>
+
 ## VIDEO Test Collapsible banner ads
 - Test Plugin with construct 3
   
@@ -117,7 +305,7 @@ https://developers.google.com/admob/ios/quick-start
 
 [![Video](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhLhjgjUkLSlagAcfz_0KwNXLLfvZnkrs8YG4PAUo9y5e0kyTDwUYAHATmWzyF0ZkJ7EWCsvsJIhP-rIDPnAMrrQKkmuZxM38lW4JIzzfb0LZWTh0q9FCbEPEZBjbgkZbzsFlI23Y30uTPR-TEiVpt9w5gFUQXrep0_Tlyj_koRJUhc66zxE2UUJPsejEE/s320/mq2.webp)](https://youtu.be/sLXHKdU6DAg)
 
-
+</details>
 
 
 
@@ -139,45 +327,6 @@ https://developers.google.com/admob/ios/quick-start
 <li> impression-level-ad-revenue</li>
 </ul>
 </details>
-## Version locking the plugin during production is highly recommended.
-
-- Example cordova plugin add emi-indo-cordova-plugin-admob@1.6.0 --save --variable APP_ID_ANDROID=ca-app-pub-xxx~xxx
-- View plugin version: https://www.npmjs.com/package/emi-indo-cordova-plugin-admob?activeTab=versions
-- Release notes: https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases
-
-## Installation
-- Only platform Android
-```sh
-cordova plugin add emi-indo-cordova-plugin-admob --save --variable APP_ID_ANDROID=ca-app-pub-xxx~xxx
-```
-
-- Only platform IOS
-```sh
-cordova plugin add emi-indo-cordova-plugin-admob --save --variable APP_ID_IOS=ca-app-pub-xxx~xxx
-```
-
-- Platform Both
-```sh
-cordova plugin add emi-indo-cordova-plugin-admob --save --variable APP_ID_ANDROID=ca-app-pub-xxx~xxx --variable APP_ID_IOS=ca-app-pub-xxx~xxx
-```
-
-## Remove
-```sh
-cordova plugin rm emi-indo-cordova-plugin-admob
-```
-
-## Note IOS
-> [!NOTE]  
-> - To prevent some warnings or errors in xcode later, it is best after adding platforms and plugins cd/project root/command line run cordova prepare.
-> - after that just cd platform/ios command line run pod install --repo-update
-
-## Import the Mobile Ads SDK IOS
-### Then from the command line run:
-- cd platforms/ios 
-- Then run cordova prepare
-### Then from the command line run:
-- pod install --repo-update
-
 
 
 ## >>> Device Ready <<<

package/example/capacitor.config.json

@@ -7,7 +7,7 @@
     "AdMob": {
       "APP_ID_ANDROID": "ca-app-pub-3940256099942544~3347511713", 
       "APP_ID_IOS": "ca-app-pub-3940256099942544~1458002511",
-      "USE_LITE_ADS": "lite"
+      "USE_LITE_ADS": ""
     }
   }
 }

package/example/config.xml

@@ -8,4 +8,11 @@
     <content src="index.html" />
     <allow-intent href="http://*/*" />
     <allow-intent href="https://*/*" />
+    <preference name="GradlePluginKotlinVersion" value="2.1.0" />
+    <preference name="AndroidXEnabled" value="true" />
+    <preference name="GradlePluginKotlinEnabled" value="true" />
+    <preference name="orientation" value="portrait" />
+    <preference name="fullscreen" value="false" />
+    <preference name="android-minSdkVersion" value="23" />
+    <preference name="android-targetSdkVersion" value="35" />
 </widget>

package/example/package.json

@@ -14,7 +14,7 @@
   "author": "Apache Cordova Team",
   "license": "Apache-2.0",
   "devDependencies": {
-    "emi-indo-cordova-plugin-admob": "^1.8.9"
+    "emi-indo-cordova-plugin-admob": "^2.0.8"
   },
   "cordova": {
     "plugins": {

package/example/www/js/bannerAd.js

@@ -1,4 +1,4 @@
-// ccordova.plugins.emiAdmobPlugin.styleBannerAd({isOverlapping: true, overlappingHeight: 0, padding: 0, margins: 0 });  // ( only android)
+// cordova.plugins.emiAdmobPlugin.styleBannerAd({isOverlapping: true, overlappingHeight: 0, padding: 0, margins: 0 });  // ( only android)
 //cordova.plugins.emiAdmobPlugin.loadBannerAd({config});
 //cordova.plugins.emiAdmobPlugin.showBannerAd(); // default
 //cordova.plugins.emiAdmobPlugin.hideBannerAd(); // default
@@ -8,45 +8,27 @@
 
 function loadBanner() {
 
-    if (typeof cordova !== 'undefined') {
-
-        // IOS Still under development
+        // Optional Only IOS
         if (isPlatformIOS){
-            // If there is a problem isOverlapping: false
             cordova.plugins.emiAdmobPlugin.styleBannerAd({
-                isOverlapping: true, // default false IOS | Android
-                paddingWebView: 1.0 // Only IOS
+                isOverlapping: true, // default false 
+                paddingWebView: 1.0 
             });
             
-        } else {
-
-         // Android
-
-         cordova.plugins.emiAdmobPlugin.styleBannerAd({
-            isOverlapping: true, // default false IOS | Android
-            isStatusBarShow: true, // default true Only Android
-            overlappingHeight: 0, // default 0 (Automatic) Only Android
-            padding: 0, // default 0 Only Android
-            margins: 0 // default 0 (Automatic) Only Android
-        });
-
-
         }
 
         
         
-    
-
         cordova.plugins.emiAdmobPlugin.loadBannerAd({
             adUnitId: Banner_ID, //Banner_ID,
-            position: "bottom-center", // "Recommended: bottom-center"
-            size: "banner", // autoResize: true (only responsive_adaptive)
+            position: "bottom-center", //  bottom-center | top-center
+            size: "banner",
             collapsible: "", // position: top | bottom (disable, empty string)
-            autoResize: true, // default false
             autoShow: true, // default false
-
+            isOverlapping: false // The height of the body is reduced by the height of the banner.
+         // isOverlapping: true // The body height is not reduced, the banner overlaps on top of the body
         });
-    }
+
 
 }
 
@@ -80,18 +62,6 @@ function removeBanner() {
 
 /* ///////<<<<  bannerAd position  >>>>>>\\\\\\\
 
-(ANDROID)
-
-top-right
-top-center
-left
-center
-right
-bottom-center
-bottom-right
-
-(IOS)
-
 bottom-center
 top-center
 
@@ -141,8 +111,6 @@ on.banner.revenue
 on.banner.remove
 on.banner.hide
 
- // New event plugin v1.5.5 or higher
-
  on.is.collapsible
  on.bannerAd.responseInfo
 
@@ -151,33 +119,6 @@ on.banner.hide
 
 
 
-// EVENT For example
-
-
-// (Optional)
-// This is only triggered when cordova.plugins.emiAdmobPlugin.styleBannerAd
-document.addEventListener('on.style.banner.ad', (data) => {
-    console.log("on.style.banner.ad: " + JSON.stringify(data));
-/*  (ANDROID)
-    const navBarHeight = data.navBarHeight;
-    const screenHeight = data.screenHeight;
-    const usableHeight = data.usableHeight;
-    const isOverlapping = data.isOverlapping;
-    const overlappingHeight = data.overlappingHeight;
-    const paddingInPx = data.paddingInPx;
-    const marginsInPx = data.marginsInPx;
-*/
-
-/*  (IOS)
-    const screenHeight = data.screenHeight;
-    const screenWidth = data.screenWidth;
-    const safeAreaTop = data.safeAreaTop;
-    const safeAreaBottom = data.safeAreaBottom;
-*/
-
-});
-
-
 
 
 

package/example/www/js/deviceready.js

@@ -67,7 +67,7 @@ document.addEventListener("deviceready", function () {
 
 
 
-    // globalSettings 
+    // globalSettings Optional
     cordova.plugins.emiAdmobPlugin.globalSettings({
         setAppMuted: false, // Type Boolean default: false
         setAppVolume: 1.0, // Type float

package/example/www/js/interstitialAd.js

@@ -33,8 +33,6 @@ on.interstitial.failed.show
 on.interstitial.impression
 on.interstitial.show
 
-// New event plugin v1.5.5 or higher
-
 on.interstitial.revenue
 on.interstitialAd.responseInfo
 

package/example/www/js/optionalFirebaseAnalytics.js

@@ -41,8 +41,6 @@ on.interstitial.failed.show
 on.interstitial.impression
 on.interstitial.show
 
-// New event plugin v1.5.5 or higher
-
 on.interstitial.revenue
 on.interstitialAd.responseInfo
 

package/example/www/js/rewardedAd.js

@@ -32,8 +32,6 @@ on.rewarded.show
 on.reward.userEarnedReward
 on.rewarded.ad.skip
 
-// New event plugin v1.5.5 or higher
-
 on.rewarded.revenue
 on.rewardedAd.responseInfo
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emi-indo-cordova-plugin-admob",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "Cordova/Quasar/Capacitor Plugin Admob Android IOS",
   "cordova": {
     "id": "emi-indo-cordova-plugin-admob",

package/plugin.xml

@@ -1,6 +1,6 @@
 <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
   xmlns:android="http://schemas.android.com/apk/res/android"
-  id="emi-indo-cordova-plugin-admob" version="2.0.6">
+  id="emi-indo-cordova-plugin-admob" version="2.0.8">
 
   <name>emiAdmobPlugin</name>
   <description>Cordova/Quasar/Capacitor Plugin Admob Android IOS</description>
@@ -18,7 +18,6 @@
       version=">=11.0.0" />
     <engine name="cordova-ios"
       version=">=5.0.0" />
-
   </engines>
 
 
@@ -33,12 +32,11 @@
     <config-file parent="/*" target="config.xml">
       <preference name="AndroidXEnabled" value="true" />
       <preference name="GradlePluginKotlinEnabled" value="true" />
-      <preference name="GradlePluginKotlinVersion" value="1.9.24" />
+      <preference name="GradlePluginKotlinVersion" value="2.1.0" />
     </config-file>
 
     <config-file parent="/*" target="AndroidManifest.xml">
       <uses-permission android:name="android.permission.INTERNET" />
-      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     </config-file>
 
     <config-file target="AndroidManifest.xml" parent="/manifest/application">
@@ -61,11 +59,11 @@
     <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
 
     <preference name="APP_ID_ANDROID" default="ca-app-pub-3940256099942544~3347511713" />
-    <preference name="PLAY_SERVICES_VERSION" default="23.6.0" />
+    <preference name="PLAY_SERVICES_VERSION" default="24.1.0" />
 
     <framework src="com.google.android.gms:play-services-ads:$PLAY_SERVICES_VERSION" />
 
-    <preference name="UMP" default="3.1.0" />
+    <preference name="UMP" default="3.2.0" />
     <framework src="com.google.android.ump:user-messaging-platform:$UMP" />
 
     <!-- Dependency Consent status will automatically reset after 12 months -->
@@ -302,9 +300,9 @@
         <source url="https://cdn.cocoapods.org/" />
       </config>
       <pods use-frameworks="true">
-		<!--minimum macOS 14.4 > Xcode 15.3 -->
-		 <pod name="GoogleUserMessagingPlatform" spec="~> 2.7.0" />
-     <pod name="Google-Mobile-Ads-SDK" spec="~> 11.13.0" />
+		<!--minimum macOS 14.4 > Xcode 16.0 -->
+		 <pod name="GoogleUserMessagingPlatform" spec="~> 3.0.0" />
+     <pod name="Google-Mobile-Ads-SDK" spec="~> 12.2.0" />
 		
       </pods>
     </podspec>