emi-indo-cordova-plugin-admob 1.4.2 → 1.4.3

package/example/Advanced topics/consent.html

@@ -6,35 +6,50 @@
 
 <script>
 
-// Installation
 
-// cordova plugin add emi-indo-cordova-plugin-consent
-// cordova plugin add emi-indo-cordova-plugin-admob
+ // >>>>>>>>  User Messaging Platform (UMP) SDK 2.1.0
 
+ let getConsentStatus = () => {
+            // https://developers.google.com/admob/android/privacy
+            cordova.plugins.emiAdmobPlugin.getConsentRequest(
 
-let _getConsentRequest = () => {
-    cordova.plugins.emiAdmobPlugin.getConsentRequest(
-    // Setting Targeting in Device Ready
+                (ststus) => {
 
-    (status) => { alert(status) }, // check event code
-    (error) => { alert(error)
+                    event.value += "\n Consent Status: " + ststus;
 
-    });
-}
+                },
+                (error) => {
 
-// call _getConsentRequest();
+                    event.value += "\n Error: " + error
 
+                });
 
+        }
 
-let _consentReset = () => {
-    cordova.plugins.emiAdmobPlugin.consentReset();
-}
 
-// call _consentReset();
+        let consentReset = () => {
+            cordova.plugins.emiAdmobPlugin.consentReset();
+        }
 
 
 
+        // >>>>>>>>  New features (UMP) SDK v2.1.0
+        let showPrivacyOptionsForm = () => {
 
+            cordova.plugins.emiAdmobPlugin.showPrivacyOptionsForm(
+
+                (info) => {
+
+                    event.value += "\n Show Privacy Option Form: " + info;
+
+                },
+                (error) => {
+
+                    event.value += "\n Error: " + error
+
+                });
+
+        }
 
 
 
@@ -42,19 +57,20 @@ let _consentReset = () => {
 
 document.addEventListener("deviceready", function(){
 
-cordova.plugins.emiAdmobPlugin.initialize();
+// WARNING config must be an array[] not an object{}
+const config_Targeting = [
 
-cordova.plugins.emiAdmobPlugin.targeting(
-    TagForChildDirectedTreatment = 0, // value: 0 | -1 | 1
-    TagForUnderAgeOfConsent = 0, // // value: 0 | -1 | 1
-    MaxAdContentRating = "G", // value: G | MA | PG | T | ""
+    childDirectedTreatment = 0, // value: 0 | -1 | 1
+    underAgeOfConsent = false, // default: false
+    contentRating = "G" // value: G | MA | PG | T | ""
 
-    // Optional
-    (info) => { console.log(info)},
-    (error) => { console.log(error)
+]
 
-    });
-	
+
+ cordova.plugins.emiAdmobPlugin.targeting(config_Targeting);
+
+// Must be under globalSetting and targeting
+cordova.plugins.emiAdmobPlugin.initialize();
 	
 	
 	
@@ -63,10 +79,12 @@ cordova.plugins.emiAdmobPlugin.targeting(
 	
 	
 	
-	// Consent Event 
 	
+	// Optional Consent Event 
 	
 /*
+
+
 on.consent.info.update
 on.consent.info.update.failed
 
@@ -122,18 +140,12 @@ alert("Consent status is unknown.");
 
 });
 
-
-
-
-
-
-
 }, false);
 </script>
 
-
-
-<p> <button onclick="_getConsentRequest();">get Consent Request</button></p>
+<p> <button onclick="getConsentStatus();">Get Consent Status</button></p>
+<p> <button onclick="showPrivacyOptionsForm();">Show Privacy Options Form</button></p>
+<p> <button onclick="consentReset();">Consent Reset</button></p>
 
 <p> <button onclick="_consentReset();">Consent reset</button></p>
 

package/example/Advanced topics/globalSettings.html

@@ -15,21 +15,30 @@
 
 document.addEventListener("deviceready", function(){
 
-// Before loading ads, have your app initialize the Google Mobile Ads SDK by calling
-// This needs to be done only once, ideally at app launch.
 
-cordova.plugins.emiAdmobPlugin.initialize();
 
 // Instruction: https://developers.google.com/admob/android/global-settings
 
-cordova.plugins.emiAdmobPlugin.globalSettings(
+// WARNING config must be an array[] not an object{}
+const config_globalSettings = [
 
+    // DEPRECATED enableSameAppKey
     setAppMuted = false, // Type Boolean default: false
-    setAppVolume = 1.0, // Type float
-    enableSameAppKey = false // Type Boolean default: false
-	
-    });
+    setAppVolume = 1.0, // Type float default: 1
+    publisherFirstPartyIdEnabled = true, // Type Boolean default: true  // enableSameAppKey
+    npa = "1", // string "0" | "1" // DEPRECATED Beginning January 16, 2024
+    enableCollapsible = true, // (BETA) activate the collapsible banner ads
+    responseInfo = false, // For debugging and logging purposes
+
+]
+
+cordova.plugins.emiAdmobPlugin.globalSettings(config_globalSettings);
 
+// Before loading ads, have your app initialize the Google Mobile Ads SDK by calling
+// This needs to be done only once, ideally at app launch.
+
+// Must be under globalSetting and targeting
+cordova.plugins.emiAdmobPlugin.initialize();
 
 }, false);
 </script>

package/example/Advanced topics/requestIDFA.html

@@ -0,0 +1,59 @@
+<html>
+<head>
+    <script type="text/javascript" src="cordova.js"></script>
+</head>
+<body>
+
+<script>
+
+
+
+      /////  >>>>>> Device Ready <<<<<<
+
+document.addEventListener("deviceready", function(){
+
+// WARNING config must be an array[] not an object{}
+const config_Targeting = [
+
+    childDirectedTreatment = 0, // value: 0 | -1 | 1
+    underAgeOfConsent = false, // default: false
+    contentRating = "G" // value: G | MA | PG | T | ""
+
+]
+
+
+ cordova.plugins.emiAdmobPlugin.targeting(config_Targeting);
+
+// Must be under globalSetting and targeting
+cordova.plugins.emiAdmobPlugin.initialize();
+	
+
+// event 
+document.addEventListener('on.sdkInitialization', () => {
+
+cordova.plugins.emiAdmobPlugin.requestIDFA(
+
+(ststus) => {
+
+    event.value += "\n IDFA Status: " + ststus;
+
+},
+(error) => {
+
+    event.value += "\n Error: " + error
+
+});
+
+
+});
+	
+
+
+
+}, false);
+</script>
+
+
+
+</body>
+</html>

package/example/Advanced topics/targeting.html

@@ -7,36 +7,32 @@
 <script>
 
 
-// ### As suggested by Google, when the SDK initializes this plugin automatically takes the Global Settings and Targeting values.
-
 // ### Targeting
 
  /////  >>>>>> Device Ready <<<<<<
 
 document.addEventListener("deviceready", function(){
 
-// Before loading ads, have your app initialize the Google Mobile Ads SDK by calling
-// This needs to be done only once, ideally at app launch.
 
-cordova.plugins.emiAdmobPlugin.initialize();
+// Instruction: https://developers.google.com/admob/android/targeting
+// Overview: https://developers.google.com/android/reference/com/google/android/gms/ads/RequestConfiguration
 
-//(Auto Loaded during SDK initialize and ad loaded)
+// WARNING config must be an array[] not an object{}
+const config_Targeting = [
 
-// You can see the value when the ad is loaded, set responseInfo = true
+    childDirectedTreatment = 0, // value: 0 | -1 | 1
+    underAgeOfConsent = false, // default: false
+    contentRating = "G" // value: G | MA | PG | T | ""
+
+]
 
-// Instruction: https://developers.google.com/admob/android/targeting
-// Overview: https://developers.google.com/android/reference/com/google/android/gms/ads/RequestConfiguration
- 
- cordova.plugins.emiAdmobPlugin.targeting(
-    TagForChildDirectedTreatment = 0, // value: 0 | -1 | 1
-    TagForUnderAgeOfConsent = 0, // // value: 0 | -1 | 1
-    MaxAdContentRating = "G", // value: G | MA | PG | T | ""
 
-    // Optional
-    (info) => { console.log(info)},
-    (error) => { console.log(error)
+ cordova.plugins.emiAdmobPlugin.targeting(config_Targeting);
 
-    });
+
+ 
+// Must be under globalSetting and targeting
+cordova.plugins.emiAdmobPlugin.initialize();
 
 // >>>>>>>>>>>  Description   <<<<<<<<<<<<<<<
 	
@@ -49,16 +45,6 @@ cordova.plugins.emiAdmobPlugin.initialize();
 // -1 = UNSPECIFIED
 // (if else/undefined = false/0)
 
-///////////////////////////////
-
-// (TagForUnderAgeOfConsent)
-// Type number:
-// value: 0 | -1 | 1
-// (value description)
-// 0 = FALSE
-// 1 = TRUE
-// -1 = UNSPECIFIED
-// (if else/undefined = false/0)
 
 //////////////////////////////
 

package/example/app_open_ads.html

@@ -13,49 +13,26 @@
 
    let cleanText = () => { event.value = '' };
    
-   let debug = false;
+  
+   // WARNING config must be an array[] not an object{}
+   const config_AppOpenAd = [adUnitId = "ca-app-pub-3940256099942544/3419835294", autoShow = false ];
 
 
 // load App Open Ad
 
 let loadAppOpenAd = () => {
-
-    cordova.plugins.emiAdmobPlugin.loadAppOpenAd(
-    AdUnitId = "ca-app-pub-3940256099942544/3419835294",
-    npa = "1", // String | 0 | 1
-    responseInfo = debug, // boolean
-
-    (info) => {
-    
-	if (debug === true) {
-	
-    event.value += "\n ResponseInfo: " + info; // responseInfo = true
-	
-	} else 
-	if (debug === false) {
-	
-	// responseInfo = false
-	// event name: on.appOpenAd.revenue
-	
-    event.value += "\n Micros: " + info.micros;
-    event.value += "\n Currency: " + info.currency;
-    event.value += "\n Precision: " + info.precision;
-    event.value += "\n AdUnitId: " + info.adUnitId;
-	
-	   }
-
-     },
-    (error) => {
-
-    event.value += "\n Error: " + error
-
-    });
+   
+    cordova.plugins.emiAdmobPlugin.loadAppOpenAd(config_AppOpenAd);
+    // Or like this
+    // cordova.plugins.emiAdmobPlugin.loadAppOpenAd([adUnitId = "ca-app-pub-3940256099942544/3419835294", autoShow = false ]);
+    // call loadAppOpenAd();
 }
 
 // Show App Open Ad
 
 let showAppOpenAd = () => {
     cordova.plugins.emiAdmobPlugin.showAppOpenAd();
+    // call showAppOpenAd();
 }
 
 
@@ -64,20 +41,20 @@ let showAppOpenAd = () => {
 
 document.addEventListener("deviceready", function(){
 
-// Before loading ads, have your app initialize the Google Mobile Ads SDK by calling
-// This needs to be done only once, ideally at app launch.
-
-  cordova.plugins.emiAdmobPlugin.initialize(
-    // Optional
-    (info) => {
-    event.value += (info)
-    },
-    (error) => {
+  const config_globalSettings = [
 
-    event.value += (error)
+    // DEPRECATED enableSameAppKey
+    setAppMuted = false, // Type Boolean default: false
+    setAppVolume = 1.0, // Type float default: 1
+    publisherFirstPartyIdEnabled = true, // Type Boolean default: true  // enableSameAppKey
+    npa = "1", // string "0" | "1" // DEPRECATED Beginning January 16, 2024
+    enableCollapsible = true, // (BETA) activate the collapsible banner ads
+    responseInfo = false, // For debugging and logging purposes
 
-    });
+]
 
+cordova.plugins.emiAdmobPlugin.globalSettings(config_globalSettings);
+cordova.plugins.emiAdmobPlugin.initialize();
 // SDK EVENT Initialization
  
 document.addEventListener('on.sdkInitialization', () => {

package/example/banner_ads.html

@@ -12,12 +12,15 @@
    let event = document.getElementById('event');
 
    let cleanText = () => { event.value = '' };
-   
-   let debug = false;
-
 /*
->>>>>>>>>> Banner position  <<<<<<<<<<<<<<
 
+
+>>>>>>>>>>> Banner collapsible position <<<<<<<<<<<<
+top-center
+bottom-center
+
+
+ >>>>>>>>>>> Banner position <<<<<<<<<<<<
 top-right
 top-center
 left
@@ -29,10 +32,10 @@ bottom-right
  >>>>>>>>>>> Banner size <<<<<<<<<<<<
  ( Ad Size Adaptive )
  
-Anchored_adaptive
-Inline_adaptive
-default: Adaptive_FULL_WIDTH
-adaptiveWidth = number/default = 320
+ANCHORED
+IN_LINE
+FULL_WIDTH
+adaptive_Width = 320
 
 ( Ad Size not Adaptive )
 
@@ -43,99 +46,45 @@ MEDIUM_RECTANGLE
 FULL_BANNER
 LEADERBOARD
 
-Smart Banners = DEPRECATED ( Replaced by Adaptive_FULL_WIDTH )
-
 */
 
-// // Note adaptiveWidth = 320, // This is special size = "Inline_adaptive" or "Anchored_adaptive" if else this field will be ignored
-
-//   Adaptive banner
-
-let loadBannerAdaptive = () => {
-
-    cordova.plugins.emiAdmobPlugin.loadBannerAd(
-    AdUnitId = "ca-app-pub-3940256099942544/6300978111",
-    npa = "1", // String | 0 | 1
-    position = "bottom-center",
-    size = "default", // Inline_adaptive | Anchored_adaptive | default = Adaptive_FULL_WIDTH
-    adaptiveWidth = 320,
-    responseInfo = debug, // boolean
-
-    (info) => {
-    
-	if (debug === true) {
-	
-          event.value += "\n ResponseInfo: " + info; // responseInfo = true
-	
-	   } 
-
-     },
-    (error) => {
 
-    event.value += "\n Error: " + error
-
-    });
-}
-
-
-
-//  not Adaptive banner
-
-let loadBannerNotAdaptive = () => {
-    cordova.plugins.emiAdmobPlugin.loadBannerAd(
-    AdUnitId = "ca-app-pub-3940256099942544/6300978111",
-    npa = "1", // String | 0 | 1
-    position = "bottom-center",
-    size = "BANNER",
-    adaptiveWidth = 320, // Ignored
-    responseInfo = false, // boolean
+// WARNING config must be an array[] not an object{}
+const bannerConfig = [
 
+   adUnitId = "ca-app-pub-3940256099942544/6300978111",
+   position = "bottom-center",
+   size = "BANNER",
+   collapsible = "bottom", // (BETA) enable in globalSettings
+   adaptive_Width = 320, // Ignored
+   autoShow = true // boolean
 
-    (info) => {
+]
 
-    if (debug === true) {
-	
-          event.value += "\n ResponseInfo: " + info; // responseInfo = true
-	
-	   } 
 
-     },
-    (error) => {
-
-    event.value += "\n Error: " + error
-
-    });
+// load banner ad
+let loadBannerAd = () => {
+    cordova.plugins.emiAdmobPlugin.loadBannerAd(bannerConfig);
+   // call loadBannerAd();
 }
 
-
-
 // show Banner Ad
-
 let showBannerAd = () => {
 
-    cordova.plugins.emiAdmobPlugin.showBannerAd(
-
-    (info) => {
-    // event name: on.banner.revenue
-    event.value += "\n Micros: " + info.micros;
-    event.value += "\n Currency: " + info.currency;
-    event.value += "\n Precision: " + info.precision;
-    event.value += "\n AdUnitId: " + info.adUnitId;
-
-     },
-    (error) => {
-
-    event.value += "\n Error: " + error
-
-    });
-
+    cordova.plugins.emiAdmobPlugin.showBannerAd();
+    // call showBannerAd();
 }
 
+// Hide Banner Ad
+let hideBannerAd = () => {
+    cordova.plugins.emiAdmobPlugin.hideBannerAd();
+    // call hideBannerAd();
+}
 
 // Remove Banner
-
 let removeBannerAd = () => {
     cordova.plugins.emiAdmobPlugin.removeBannerAd();
+    // call removeBannerAd();
 }
 
 
@@ -144,42 +93,38 @@ let removeBannerAd = () => {
 
 document.addEventListener("deviceready", function(){
 
-// Before loading ads, have your app initialize the Google Mobile Ads SDK by calling
-// This needs to be done only once, ideally at app launch.
 
-  cordova.plugins.emiAdmobPlugin.initialize(
-    // Optional
-    (info) => {
-    event.value += (info)
-    },
-    (error) => {
+    const config_globalSettings = [
+
+
+    // DEPRECATED enableSameAppKey
+    setAppMuted = false, // Type Boolean default: false
+    setAppVolume = 1.0, // Type float default: 1
+    publisherFirstPartyIdEnabled = true, // Type Boolean default: true  // enableSameAppKey
+    npa = "1", // string "0" | "1" // DEPRECATED Beginning January 16, 2024
+    enableCollapsible = true, // (BETA) activate the collapsible banner ads
+    responseInfo = false, // For debugging and logging purposes
+
+]
+
+cordova.plugins.emiAdmobPlugin.globalSettings(config_globalSettings);
+
+
+// Must be under globalSetting and targeting
+  cordova.plugins.emiAdmobPlugin.initialize();
+
 
-    event.value += (error)
 
-    });
 
 // SDK EVENT Initialization
- 
+// Optional
 document.addEventListener('on.sdkInitialization', () => {
 
 event.value += ("\n On Sdk Initialization");
 
-
 });
 
 
-// Banner Ad EVENT
-
-/*
-on.banner.load
-on.banner.failed.load
-on.banner.click
-on.banner.close
-on.banner.impression
-on.banner.open
-on.banner.revenue
-on.banner.remove
-*/
 
 
 document.addEventListener('on.banner.load', () => {
@@ -231,18 +176,24 @@ event.value += ("\n on.banner.remove");
 });
 
 
+
 }, false);
 
 </script>
 
-<p> <button onclick="loadBannerAdaptive();">load Banner adaptive</button></p>
-<p> <button onclick="loadBannerNotAdaptive();">load Banner No Adaptive</button></p>
+
+
+<p> <button onclick="loadBannerAd();">load Banner Ad</button></p>
 <p> <button onclick="showBannerAd();">show Banner Ad</button></p>
+<p> <button onclick="hideBannerAd();">hide Banner Ad</button></p>
 <p> <button onclick="removeBannerAd();">remove Banner Ad</button></p>
+<p> <button onclick="hideBannerAd();">hide Banner Ad</button></p>
+
 
 
 <p> <button onclick="cleanText();">Clean response Text</button></p>
 
 
+
 </body>
 </html>