emi-indo-cordova-plugin-admob 1.4.8 → 1.5.1

package/README.md

@@ -3,19 +3,28 @@
 # emi-indo-cordova-plugin-admob
  Cordova Plugin Admob Android and IOS
 
-### Mobile Ads SDK (Android: 22.6.0) [Release Notes:](https://developers.google.com/admob/android/rel-notes)
+### Mobile Ads SDK (Android: 23.4.0) [Release Notes:](https://developers.google.com/admob/android/rel-notes)
+
+### Mobile Ads SDK (IOS: 11.5.0) [Release Notes:](https://developers.google.com/admob/ios/rel-notes)
+
+### User Messaging Platform (UMP: 3.0.0) [Release Notes:](https://developers.google.com/admob/android/privacy/release-notes)
+### IAB Europe Transparency & Consent Framework (CPM: 2.2.0)
+
+
 
-### Mobile Ads SDK (IOS: 10.14.0) [Release Notes:](https://developers.google.com/admob/ios/rel-notes)
 
 ## Minimum Cordova Engines
 - cordova-android version = 12.0.0
 - cordova-ios version = 7.0.0
 
+> [!WARNING]  
+> - Minimum supported Xcode version to 14.3
+> - Maximum supported Xcode version up to 15.2
 ## Minimum macOS | Xcode, and others
 - Monterey
-- Xcode 14.1 or higher
+- Xcode min 14.3 > max 15.2
 - Command Line Tools 14.1 or higher
-- Target iOS 11.0 or higher
+- Target iOS 12.0
 https://developers.google.com/admob/ios/quick-start
 
 <details>
@@ -53,7 +62,9 @@ https://developers.google.com/admob/ios/quick-start
 [![Video](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEiCMj8HrgSvO8WYm8wjv5KsM1CCmcX-w472iRZ0ynW715Pj0hMrTlCDLYxhLHme3oFowVW9ap7pQZqosXBDWWQ_SMuqw2g_Beh1CX0igO7jY7KCvBCXbQCqyFekgI9bKIl92opoucOkXbqsgRhBTeB41ho5l_0tx-YVfKt9jrbONt_nv080beeaYOmoN4w7/s320/mq3%20%281%29.webp)](https://youtu.be/YYMJuf7gIsg)
 
 
+## VIDEO Test Collapsible banner autoResize with Xcode/IOS
 
+[![Video](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEhLhjgjUkLSlagAcfz_0KwNXLLfvZnkrs8YG4PAUo9y5e0kyTDwUYAHATmWzyF0ZkJ7EWCsvsJIhP-rIDPnAMrrQKkmuZxM38lW4JIzzfb0LZWTh0q9FCbEPEZBjbgkZbzsFlI23Y30uTPR-TEiVpt9w5gFUQXrep0_Tlyj_koRJUhc66zxE2UUJPsejEE/s320/mq2.webp)](https://youtu.be/sLXHKdU6DAg)
 
 
 
@@ -62,6 +73,18 @@ https://developers.google.com/admob/ios/quick-start
   
 ##  [Check all release notes:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/)
 
+> [!WARNING]  
+> WARNING options configuration was previously an array [], now v.1.4.9 or later must be an object{}
+> example
+```
+previous example 
+[ adUnitId = App_Open_ID, autoShow = true ] // Deprecated
+now
+{ adUnitId: App_Open_ID, autoShow: true }
+
+ cordova.plugins.emiAdmobPlugin.loadAppOpenAd({ adUnitId: App_Open_ID, autoShow: true }); 
+ ```
+
 ## Features
 <details>
 <summary>Features #1</summary>
@@ -86,10 +109,7 @@ https://developers.google.com/admob/ios/quick-start
 ```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
 ```
-### Or
-```sh
-cordova plugin add https://github.com/EMI-INDO/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
@@ -110,15 +130,38 @@ cordova plugin rm emi-indo-cordova-plugin-admob
 <details>
 <summary>Methods: #2</summary>
 <pre> 
+
+cordova.plugins.emiAdmobPlugin.initialize({
+
+  isUsingAdManagerRequest: true, // true = AdManagerAdRequest.Builder | false = AdRequest.Builder (Default true)
+  isResponseInfo: true, // Default false (Debug true)
+  isConsentDebug: true, // Default false (Debug true)
+
+  }
+
+document.addEventListener('on.sdkInitialization', (data) => {
+// JSON.stringify(data)
+   const sdkVersion = data.version;
+// const adAdapter = data.adapters;
+// const conStatus = data.consentStatus;
+// const gdprApplie = data.gdprApplies;
+// const purposeConsent = data.purposeConsents;
+// const vendorConsents = data.vendorConsents;
+// const conTCString = data.consentTCString;
+// const additionalConsent = data.additionalConsent;
+console.log("On Sdk Initialization version: " + sdkVersion);
+
+});
+ 
  // Support Platform: Android | IOS
-cordova.plugins.emiAdmobPlugin.globalSettings([config_globalSettings]);
-cordova.plugins.emiAdmobPlugin.targeting([config_Targeting]);
-cordova.plugins.emiAdmobPlugin.initialize();
+cordova.plugins.emiAdmobPlugin.globalSettings({config_globalSettings}); // Optional
+cordova.plugins.emiAdmobPlugin.targeting({config_Targeting}); // Optional
 // UMP SDK 2.1.0
-cordova.plugins.emiAdmobPlugin.getConsentRequest(); // (Platform: Both)
-cordova.plugins.emiAdmobPlugin.consentReset(); // (Platform: Both)
-cordova.plugins.emiAdmobPlugin.showPrivacyOptionsForm(); // (Platform: Both)
+cordova.plugins.emiAdmobPlugin.getConsentRequest(); // (Platform: Both)  // Deprecated
+cordova.plugins.emiAdmobPlugin.consentReset(); // (Platform: Both) // Optional
+cordova.plugins.emiAdmobPlugin.showPrivacyOptionsForm(); // (Platform: Both) // Optional
 // CMP SDK 2.2.0
+ // Optional
 cordova.plugins.emiAdmobPlugin.requestIDFA(); // UMP SDK to handle Apple's App Tracking Transparency (ATT) (Platform: IOS)
 cordova.plugins.emiAdmobPlugin.getIabTfc((IABTFC) => { console.log(JSONstringify(IABTFC)) }); // CMP SDK 2.2 (Platform: Both)
 
@@ -131,7 +174,7 @@ must be false if the application is released to the play store / app store.
 consent from will continue to be called regardless of its status 0,1,2,3, 
 until the value is changed to false.
 
-setDebugGeography = true | false
+isConsentDebug: true | false
 </details>
 <li>example</li></ul>
 <pre> 
@@ -139,28 +182,25 @@ setDebugGeography = true | false
 
 document.addEventListener("deviceready", function(){
 
-    const config_globalSettings = [
-    
-    setAppMuted = false, //  default: false
-    setAppVolume = 1, //  float: default: 1
-    enableSameAppKey = false, // default: false
-    npa = "1", // string "0" | "1"
-    enableCollapsible = true, // (BETA) activate the collapsible banner ads
-    responseInfo = false, // default: false
-    setDebugGeography = false // default: false
-    
-    ]
+document.addEventListener('on.sdkInitialization', (data) => {
+// JSON.stringify(data)
+   const sdkVersion = data.version;
+// const adAdapter = data.adapters;
+// const conStatus = data.consentStatus;
+// const gdprApplie = data.gdprApplies;
+// const purposeConsent = data.purposeConsents;
+// const vendorConsents = data.vendorConsents;
+// const conTCString = data.consentTCString;
+// const additionalConsent = data.additionalConsent;
+console.log("On Sdk Initialization version: " + data.consentStatus);
 
-cordova.plugins.emiAdmobPlugin.getConsentRequest( (ststus) => { console.log("Consent Status: " + ststus) });
-cordova.plugins.emiAdmobPlugin.globalSettings(config_globalSettings);
- 
- document.addEventListener('on.get.consent.status', () => {
-  // Regardless of the state, call SDK initialize
-   
-   cordova.plugins.emiAdmobPlugin.initialize();
-   cordova.plugins.emiAdmobPlugin.getIabTfc((IABTFC) => { console.log(JSONstringify(IABTFC)) }); 
 });
 
+// cordova.plugins.emiAdmobPlugin.getConsentRequest( (ststus) => { console.log("Consent Status: " + ststus) }); // Deprecated
+// cordova.plugins.emiAdmobPlugin.showPrivacyOptionsForm();
+
+
+
 }, false);
 
 </pre>
@@ -212,11 +252,11 @@ document.addEventListener('on.TCString.expired', () => {
 
 
 - [AppTrackingTransparency (ATT) framework:](https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/authorizationstatus) 
-- [Consent Management Platform API:](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20CMP%20API%20v2.md#in-app-details)
+- [Consent Management Platform API:](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20CMP%20API%20v2.md#in-app-details) 
 
-- [Example Get Consent Status:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/consent.html) index.html
-- [Example requestIDFA:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/requestIDFA.html) index.html
-- [Example IABTFC:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/IABTFC.html) index.html
+- [Example Get Consent Status:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/consent.html) index.html (Not yet updated)
+- [Example requestIDFA:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/requestIDFA.html) index.html (Not yet updated)
+- [Example IABTFC:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/IABTFC.html) index.html (Not yet updated)
 
 
 
@@ -250,6 +290,62 @@ if (window.cordova.platformId === 'ios') {
     Rewarded_ID = 'ca-app-pub-3940256099942544/5224354917';
     Rewarded_Interstitial_ID = 'ca-app-pub-3940256099942544/5354046379';
 }
+
+
+  cordova.plugins.emiAdmobPlugin.initialize({
+  isUsingAdManagerRequest: true, // true = AdManagerAdRequest.Builder | false = AdRequest.Builder (Default true)
+  isResponseInfo: true, // Default false
+  isConsentDebug: true, // Default false
+ });
+
+
+ document.addEventListener('on.sdkInitialization', (data) => {
+// JSON.stringify(data)
+   const sdkVersion = data.version;
+// const adAdapter = data.adapters;
+// const conStatus = data.consentStatus;
+// const gdprApplie = data.gdprApplies;
+// const purposeConsent = data.purposeConsents;
+// const vendorConsents = data.vendorConsents;
+// const conTCString = data.consentTCString;
+// const additionalConsent = data.additionalConsent;
+console.log("On Sdk Initialization version: " + sdkVersion);
+
+
+cordova.plugins.emiAdmobPlugin.loadInterstitialAd({
+adUnitId: "ca-app-pub-3940256099942544/1033173712", 
+autoShow: true
+});
+
+});
+
+
+document.addEventListener('on.interstitial.loaded', () => {
+
+   console.log("on interstitial Ad loaded");
+
+});
+
+// all events that contain the keyword dismissed there is a block to load the ad after it is closed by the user.
+// 'on.interstitial.dismissed' | 'on.rewardedInt.dismissed' | 'on.rewarded.dismissed'
+document.addEventListener('on.interstitial.dismissed', () => {
+
+   console.log("on interstitial Ad dismissed");
+   console.log("you can load ads automatically after the ads are closed by users");
+   // loadInterstitialAd();
+
+});
+
+function loadInterstitialAd(){
+
+cordova.plugins.emiAdmobPlugin.loadInterstitialAd({
+adUnitId: "ca-app-pub-3940256099942544/1033173712", 
+autoShow: false
+});
+
+}
+
+
  </script>
 ```
 
@@ -260,17 +356,42 @@ if (window.cordova.platformId === 'ios') {
 <summary>Methods:</summary>
 <pre> 
  // Support Platform: Android | IOS
- cordova.plugins.emiAdmobPlugin.loadAppOpenAd([config_AppOpenAd]);
- cordova.plugins.emiAdmobPlugin.showAppOpenAd();
+ cordova.plugins.emiAdmobPlugin.loadAppOpenAd({config});
+ cordova.plugins.emiAdmobPlugin.showAppOpenAd(); // default
+
+//  Advanced Show (Optional)
+    cordova.plugins.emiAdmobPlugin.showAppOpenAd(
+
+    (data) => {
+
+    console.log("Micros: " + data.micros);
+    console.log("Currency: " + data.currency);
+    console.log("Precision: " + data.precision);
+    console.log("AdUnitId: " + data.adUnitId};
+
+     },
+    (error) => {
+
+     console.error("Error: " + error);
+
+    });
+
+ 
  <br> 
 </pre>
  <li>example:</li></ul>
 <pre> 
+ 
+WARNING options configuration was previously an array [], now v.1.4.9 or later must be an object{}
+example
+```
+previous example 
+[ adUnitId = App_Open_ID, autoShow = true ] // Deprecated
+now
+{ adUnitId: App_Open_ID, autoShow: true }
 
-// WARNING config must be an array[] not an object{}
-// adUnitId = call Global Variable
-
- cordova.plugins.emiAdmobPlugin.loadAppOpenAd([ adUnitId = App_Open_ID, autoShow = true ]);
+ cordova.plugins.emiAdmobPlugin.loadAppOpenAd({ adUnitId: App_Open_ID, autoShow: true }); 
+ ```
 </pre>
 </details>
 
@@ -292,10 +413,11 @@ document.addEventListener('on.appOpenAd.loaded', () => {
    console.log("On App Open Ad loaded");
 
 });
+
 </pre>
 </details>
 
-- [FULL AppOpenAd basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/app_open_ads.html) -index.html
+- [FULL AppOpenAd basic: Not yet updated](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/app_open_ads.html) -index.html
 
 
 
@@ -305,16 +427,18 @@ document.addEventListener('on.appOpenAd.loaded', () => {
 <details>
 <summary>Methods:</summary>
 <pre> 
-cordova.plugins.emiAdmobPlugin.loadBannerAd([bannerConfig]);
-cordova.plugins.emiAdmobPlugin.showBannerAd();
-cordova.plugins.emiAdmobPlugin.hideBannerAd();
-cordova.plugins.emiAdmobPlugin.removeBannerAd();
+cordova.plugins.emiAdmobPlugin.styleBannerAd({ padding: 50, margins: 50 });  // (Optional)
+cordova.plugins.emiAdmobPlugin.loadBannerAd({config});
+cordova.plugins.emiAdmobPlugin.showBannerAd(); // default
+cordova.plugins.emiAdmobPlugin.hideBannerAd(); // default
+cordova.plugins.emiAdmobPlugin.removeBannerAd(); // default
 </pre>
   <li>example:</li></ul>
 <pre> 
- // WARNING config must be an array[] not an object{}
- // adUnitId = call Global Variable
+ WARNING options configuration was previously an array [], now v.1.4.9 or later must be an object{}
 
+// Deprecated
+/*
 const bannerConfig = [
 
    adUnitId = Banner_ID,
@@ -323,11 +447,42 @@ const bannerConfig = [
    collapsible = "bottom", // (BETA) enable in globalSettings
    adaptive_Width = 320, // Ignored
    autoShow = true // boolean
-
 ]
+*/
+
+// NEW
+
+const bannerConfig = {
+
+   adUnitId: "ca-app-pub-3940256099942544/9214589741", //Banner_ID,
+   position: "bottom-center",
+   size: "responsive_adaptive", // autoResize: true (only responsive_adaptive)
+   collapsible: "bottom", // position: top | bottom (disable, empty string)
+   autoResize: true, // on.screen.rotated === orientation.portrait || on.screen.rotated === orientation.landscape
+   autoShow: true, // boolean
+
+}
 
 cordova.plugins.emiAdmobPlugin.loadBannerAd(bannerConfig);
 
+
+    //  Advanced Show (Optional)
+    cordova.plugins.emiAdmobPlugin.showBannerAd(
+
+    (data) => {
+
+    console.log("Micros: " + data.micros);
+    console.log("Currency: " + data.currency);
+    console.log("Precision: " + data.precision);
+    console.log("AdUnitId: " + data.adUnitId};
+
+     },
+    (error) => {
+
+     console.error("Error: " + error);
+
+    });
+
 </pre>
 </details>
 
@@ -347,16 +502,28 @@ bottom-right
 <details>
 <summary>Size type string</summary>
 <pre>
-ANCHORED
-IN_LINE
-FULL_WIDTH
-BANNER
-FLUID
-LARGE_BANNER
-MEDIUM_RECTANGLE
-FULL_BANNER
-LEADERBOARD
-adaptive_Width = number
+
+responsive_adaptive
+anchored_adaptive
+full_width_adaptive
+in_line_adaptive
+banner
+large_banner
+medium_rectangle
+full_banner
+leaderboard
+fluid
+ 
+ANCHORED // Deprecated
+IN_LINE // Deprecated
+FULL_WIDTH // Deprecated
+BANNER // Deprecated
+FLUID // Deprecated
+LARGE_BANNER // Deprecated
+MEDIUM_RECTANGLE // Deprecated
+FULL_BANNER // Deprecated
+LEADERBOARD // Deprecated
+adaptive_Width = number // Deprecated
 </pre>
 </details>
 
@@ -373,6 +540,8 @@ on.banner.open
 on.banner.revenue
 on.banner.remove
 on.banner.hide
+ // new
+ on.is.collapsible
 </pre>
  <li>example:</li></ul>
 <pre> 
@@ -380,10 +549,17 @@ document.addEventListener('on.banner.load', () => {
 
    console.log("on banner load");
 
-});</pre>
+});
+
+document.addEventListener('on.is.collapsible', function(event) {
+// bannerConfig collapsible: "bottom", // position: top | bottom (disable, empty string)
+console.log("Collapsible Status: " + event.collapsible);
+
+});
+</pre>
 </details>
 
- [FULL Banner basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/banner_ads.html) index.html
+ [FULL Banner basic: Not yet updated](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/banner_ads.html) index.html
 
 
 ## Interstitial ADS
@@ -393,17 +569,42 @@ document.addEventListener('on.banner.load', () => {
 <summary>Methods:</summary>
 <pre> 
  // Support Platform: Android | IOS
-cordova.plugins.emiAdmobPlugin.loadInterstitialAd([config_Interstitial]);
-cordova.plugins.emiAdmobPlugin.showInterstitialAd();
+cordova.plugins.emiAdmobPlugin.loadInterstitialAd({config});
+cordova.plugins.emiAdmobPlugin.showInterstitialAd(); // default
+
+ //  Advanced Show (Optional)
+    cordova.plugins.emiAdmobPlugin.showInterstitialAd(
+
+    (data) => {
+
+    console.log("Micros: " + data.micros);
+    console.log("Currency: " + data.currency);
+    console.log("Precision: " + data.precision);
+    console.log("AdUnitId: " + data.adUnitId};
+
+     },
+    (error) => {
+
+     console.error("Error: " + error);
+
+    });
  <br> 
 </pre>
  <li>example:</li></ul>
 <pre> 
 
-// WARNING config must be an array[] not an object{}
-// adUnitId = call Global Variable
+WARNING options configuration was previously an array [], now v.1.4.9 or later must be an object{}
+example
+```
+/*
+previous example 
+[ adUnitId = Interstitial_ID, autoShow = true ] // Deprecated
+
+{ adUnitId: Interstitial_ID, autoShow: true } // NEW
+*/
+ cordova.plugins.emiAdmobPlugin.loadInterstitialAd({ adUnitId: "ca-app-pub-3940256099942544/1033173712", autoShow: true });
+ ```
 
- cordova.plugins.emiAdmobPlugin.loadInterstitialAd([ adUnitId = Interstitial_ID, autoShow = true ]);
 </pre>
 </details>
 
@@ -428,11 +629,23 @@ document.addEventListener('on.interstitial.loaded', () => {
    console.log("on interstitial Ad loaded");
 
 });
+
+// all events that contain the keyword dismissed there is a block to load the ad after it is closed by the user.
+// 'on.interstitial.dismissed' | 'on.rewardedInt.dismissed' | 'on.rewarded.dismissed'
+document.addEventListener('on.interstitial.dismissed', () => {
+
+   console.log("on interstitial Ad dismissed");
+   console.log("you can load ads automatically after the ads are closed by users");
+   // loadInterstitialAd();
+
+});
+
+
 </pre>
 </details>
 
 
-[FULL Interstitial basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/interstitial_ads.html) index.html
+[FULL Interstitial basic: Not yet updated](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/interstitial_ads.html) index.html
 
 
 
@@ -445,17 +658,34 @@ document.addEventListener('on.interstitial.loaded', () => {
 <summary>Methods:</summary>
 <pre> 
  // Support Platform: Android | IOS
-cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd([config_rewardedInt]);
-cordova.plugins.emiAdmobPlugin.showRewardedInterstitialAd();
+cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd({config});
+cordova.plugins.emiAdmobPlugin.showRewardedInterstitialAd(); // default
  <br> 
 </pre>
  <li>example:</li></ul>
 <pre> 
 
-// WARNING config must be an array[] not an object{}
-// adUnitId = call Global Variable
+ cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd({ adUnitId: Rewarded_Interstitial_ID, autoShow: true });
+
+    //  Advanced Show (Optional)
+    cordova.plugins.emiAdmobPlugin.showRewardedInterstitialAd(
 
- cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd([ adUnitId = Rewarded_Interstitial_ID, autoShow = true ]);
+    (data) => {
+
+    console.log("Micros: " + data.micros);
+    console.log("Currency: " + data.currency);
+    console.log("Precision: " + data.precision);
+    console.log("AdUnitId: " + data.adUnitId};
+
+     },
+    (error) => {
+
+     console.error("Error: " + error);
+
+    });
+
+
+ 
 </pre>
 </details>
 
@@ -482,10 +712,22 @@ document.addEventListener('on.rewardedInt.loaded', () => {
    console.log("on rewarded Interstitial load");
 
 });
+
+// all events that contain the keyword dismissed there is a block to load the ad after it is closed by the user.
+// 'on.interstitial.dismissed' | 'on.rewardedInt.dismissed' | 'on.rewarded.dismissed'
+document.addEventListener('on.rewardedInt.dismissed', () => {
+
+   console.log("on interstitial Ad dismissed");
+   console.log("you can load ads automatically after the ads are closed by users");
+   // loadRewardedInterstitialAd();
+
+});
+
+
 </pre>
 </details>
 
-[FULL Rewarded Interstitial basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_interstitial_ads.html) index.html
+[FULL Rewarded Interstitial basic: Not yet updated](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_interstitial_ads.html) index.html
 
 
 
@@ -497,15 +739,33 @@ document.addEventListener('on.rewardedInt.loaded', () => {
 <summary>Methods:</summary>
 <pre> 
  // Support Platform: Android | IOS
-cordova.plugins.emiAdmobPlugin.loadRewardedAd([config_rewarded]);
-cordova.plugins.emiAdmobPlugin.showRewardedAd();
+cordova.plugins.emiAdmobPlugin.loadRewardedAd({config});
+cordova.plugins.emiAdmobPlugin.showRewardedAd(); // default
  <br> 
 </pre>
  <li>example:</li></ul>
 <pre> 
-// adUnitId = call Global Variable
 
- cordova.plugins.emiAdmobPlugin.loadRewardedAd([ adUnitId = Rewarded_ID, autoShow = true ]);
+ cordova.plugins.emiAdmobPlugin.loadRewardedAd({ adUnitId: Rewarded_ID, autoShow: true });
+
+//  Advanced Show (Optional)
+    cordova.plugins.emiAdmobPlugin.showRewardedAd(
+
+    (data) => {
+
+    console.log("Micros: " + data.micros);
+    console.log("Currency: " + data.currency);
+    console.log("Precision: " + data.precision);
+    console.log("AdUnitId: " + data.adUnitId};
+
+     },
+    (error) => {
+
+     console.error("Error: " + error);
+
+    });
+
+ 
 </pre>
 </details>
 
@@ -533,19 +793,202 @@ document.addEventListener('on.rewarded.loaded', () => {
    console.log("on rewarded Ad loaded");
 
 });
+
+// all events that contain the keyword dismissed there is a block to load the ad after it is closed by the user.
+// 'on.interstitial.dismissed' | 'on.rewardedInt.dismissed' | 'on.rewarded.dismissed'
+document.addEventListener('on.rewarded.dismissed', () => {
+
+   console.log("on interstitial Ad dismissed");
+   console.log("you can load ads automatically after the ads are closed by users");
+   // loadRewardedAd();
+
+});
+
+
+</pre>
+</details>
+
+[FULL Rewarded basic: Not yet updated](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_ads.html) index.html
+
+
+
+
+## New Method (Only Android)
+### Ad Request Control
+> [!WARNING]  
+> - isUsingAdManagerRequest: true 
+> - Must run before ad load
+
+- cordova.plugins.emiAdmobPlugin.targetingAdRequest({configAdRequest});
+- cordova.plugins.emiAdmobPlugin.setPersonalizationState({config});
+- cordova.plugins.emiAdmobPlugin.setPPS({config});
+
+<details>
+<summary>targetingAdRequest</summary>
+<pre> 
+
+
+// Check documentation:  https://developers.google.com/ad-manager/mobile-ads-sdk/android/targeting
+
+```
+const configAdRequest = {
+
+// enabled, disabled
+customTargetingEnabled: false,
+categoryExclusionsEnabled: false,
+ppIdEnabled: false,
+contentURLEnabled: false,
+brandSafetyEnabled: false,
+
+// set Value
+customTargetingValue:  ["24", "25", "26"],     // age 
+categoryExclusionsValue: "automobile",       // automobile or boat
+ppIdValue: "AB123456789",    
+contentURLValue: "https://www.example.com",
+brandSafetyArr: ["https://www.mycontenturl1.com", "https://www.mycontenturl2.com"],
+
+}
+
+cordova.plugins.emiAdmobPlugin.targetingAdRequest(configAdRequest);
+```
+
+</pre>
+</details>
+
+
+
+
+<details>
+<summary>setPersonalizationState</summary>
+<pre>
+
+// Check documentation:  https://developers.google.com/ad-manager/mobile-ads-sdk/android/targeting
+
+cordova.plugins.emiAdmobPlugin.setPersonalizationState({
+
+setPersonalizationState: "disabled" // type string: disabled | enabled
+
+});
+
+</pre>
+</details>
+
+
+
+
+<details>
+<summary>setPPS</summary>
+<pre>
+
+// Check documentation:  https://developers.google.com/ad-manager/mobile-ads-sdk/android/targeting
+
+```
+cordova.plugins.emiAdmobPlugin.setPPS({
+
+ppsEnabled: false, // enabled, disabled
+iabContent: "IAB_AUDIENCE_1_1",  // Type string value: IAB_AUDIENCE_1_1 or IAB_CONTENT_2_2
+ppsArrValue: [6,284],  // type arr 
+
+});
+
+```
+
+</pre>
+</details>
+
+
+<details>
+<summary>Example:</summary>
+<pre>
+
+// Check documentation:  https://developers.google.com/ad-manager/mobile-ads-sdk/android/targeting
+
+```
+function callSetPPS(){
+
+cordova.plugins.emiAdmobPlugin.setPPS({
+
+ppsEnabled: true, // enabled, disabled
+iabContent: "IAB_AUDIENCE_1_1",  // Type string value: IAB_AUDIENCE_1_1 or IAB_CONTENT_2_2
+ppsArrValue: [6,284],  // type arr 
+
+});
+
+}
+
+if (callSetPPS()){
+
+   cordova.plugins.emiAdmobPlugin.loadRewardedAd({ adUnitId: Rewarded_ID, autoShow: true });
+
+}
+
+```
+
+
+
+
+
 </pre>
 </details>
 
-[FULL Rewarded basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_ads.html) index.html
 
 
 
+ ## New Method (Only IOS)
+- You will see higher earnings.
+> [!NOTE]  
+> - Is forcing the consent form to be displayed against admob policy? (I DON'T KNOW)
+> 
+<details>
+<summary>Method:</summary>
+<pre> 
+
+/*
+
+Sometimes the consent form in IOS is difficult to display, 
+because ATT has been set by the user, 
+The problem is TCString null,
+causing very few admob ads to load,
+This method will force the consent form to be displayed, whatever the user's decision TCString will not be null.
+
+*/
+```
+// Use your own logic, this is just an example
+
+  let userGdpr = null; // global Variable
+  let userTCString = null; // global Variable
+
+  document.addEventListener('on.sdkInitialization', (data) => {
+  userGdpr = data.gdprApplies;
+  userTCString = data.consentTCString;
+ });
+
+
+ if (userGdpr === 1 && userTCString === null){
+ 
+  cordova.plugins.emiAdmobPlugin.forceDisplayPrivacyForm();
+
+}
+```
+ 
+</pre>
+</details>
+
 
 
 
 
 
+ ## GLOBAL EVENT Screen (Optional)
 
+<details>
+<summary>Event:</summary>
+<pre> 
+on.screen.rotated
+on.orientation.portrait
+on.orientation.landscape
+</pre>
+</details>
 
 
 
@@ -565,7 +1008,7 @@ document.addEventListener('on.rewarded.loaded', () => {
 - Interstitial Ads
 - Rewarded Ads
 - Rewarded interstitial Ads
-- [Consent](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/consent.html)
+- [Consent Not yet updated](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/consent.html)
 - Mediation
 - impression-level-ad-revenue
 - GDPR IAB TFCv2.2