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

package/example/Advanced topics/{consent_GDPR_IAB_TFCv2.2.html → IABTFC.html }

@@ -15,63 +15,27 @@
 
         let cleanText = () => { event.value = '' };
 
-        let debug = false;
-
-
-
         // Load Rewarded Ad
+let loadRewardedAd = () => {
+     cordova.plugins.emiAdmobPlugin.loadRewardedAd([adUnitId = "ca-app-pub-3940256099942544/5224354917", autoShow = true ]);
+    // call loadRewardedAd();
+}
 
+// Show Rewarded Ad
+let showRewardedAd = () => {
+    cordova.plugins.emiAdmobPlugin.showRewardedAd();
+    // call showRewardedAd();
+}
 
-        let loadRewardedAd = () => {
-            cordova.plugins.emiAdmobPlugin.loadRewardedAd(
-                AdUnitId = "ca-app-pub-3940256099942544/5224354917",
-                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.rewardedInt.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
-
-                });
-        }
-
-        // Show Rewarded Ad
-
-        let showRewardedAd = () => {
-            cordova.plugins.emiAdmobPlugin.showRewardedAd();
-
-        }
-
-        // >>>>>>>>  User Messaging Platform (UMP) SDK. 
+        // >>>>>>>>  User Messaging Platform (UMP) SDK 2.1.0
 
         let getConsentRequest = () => {
             // https://developers.google.com/admob/android/privacy
             cordova.plugins.emiAdmobPlugin.getConsentRequest(
 
-                (info) => {
+                (ststus) => {
 
-                    event.value += "\n Consent Status: " + info;
+                    event.value += "\n Consent Status: " + ststus;
 
                 },
                 (error) => {
@@ -164,19 +128,18 @@
 
         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.
+            
+            const config_Targeting = [
 
-            cordova.plugins.emiAdmobPlugin.initialize(
-                // Optional
-                (info) => {
-                    event.value += (info)
-                },
-                (error) => {
+            childDirectedTreatment = 0, // value: 0 | -1 | 1
+            underAgeOfConsent = false, // default: false
+            contentRating = "G" // value: G | MA | PG | T | ""
 
-                    event.value += (error)
+             ]
 
-                });
+
+            cordova.plugins.emiAdmobPlugin.targeting(config_Targeting);
+            cordova.plugins.emiAdmobPlugin.initialize();
 
 
             // Rewarded Ad EVENT
@@ -201,62 +164,7 @@
 
             });
 
-            document.addEventListener('on.rewarded.failed.load', () => {
-
-                event.value += ("\n on.rewarded.failed.load");
-
-            });
-
-            document.addEventListener('on.rewarded.click', () => {
-
-                event.value += ("\n on.rewarded.click");
-
-            });
-
-            document.addEventListener('on.rewarded.dismissed', () => {
-
-                event.value += ("\n on.rewarded.dismissed");
-
-            });
-
-            document.addEventListener('on.rewarded.failed.show', () => {
-
-                event.value += ("\n on.rewarded.failed.show");
-
-            });
-
-            document.addEventListener('on.rewarded.impression', () => {
-
-                event.value += ("\n on.rewarded.impression");
-
-            });
-
-            document.addEventListener('on.rewarded.show', () => {
-
-                event.value += ("\n on.rewarded.show");
-
-            });
-
-            document.addEventListener('on.rewarded.revenue', () => {
-
-                event.value += ("\n on.rewarded.revenue");
-
-            });
-
-            document.addEventListener('on.rewarded.ad.skip', () => {
-
-                event.value += ("\n on.rewarded.ad.skip");
-
-            });
-
-
-            document.addEventListener('on.reward.userEarnedReward', () => {
-
-                event.value += ("\n on.reward.userEarnedReward");
-
-            });
-
-
+            
 
         }, false);
 

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', () => {