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

package/www/emiAdmobPlugin.js

@@ -1,16 +1,19 @@
 var exec = require('cordova/exec');
 
-exports.initialize = function (success, error) {
-    exec(success, error, 'emiAdmobPlugin', 'initialize', []);
+exports.initialize = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'initialize', [options]);
 };
-exports.loadAppOpenAd = function (arg0, success, error) {
-    exec(success, error, 'emiAdmobPlugin', 'loadAppOpenAd', arg0);
+exports.loadAppOpenAd = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'loadAppOpenAd', [options]);
 };
 exports.showAppOpenAd = function (success, error) {
     exec(success, error, 'emiAdmobPlugin', 'showAppOpenAd', []);
 };
-exports.loadBannerAd = function (arg0, success, error) {
-    exec(success, error, 'emiAdmobPlugin', 'loadBannerAd', arg0);
+exports.styleBannerAd = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'styleBannerAd', [options]); // v1.4.9 ( only Android )
+};
+exports.loadBannerAd = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'loadBannerAd', [options]);
 };
 exports.showBannerAd = function (success, error) {
     exec(success, error, 'emiAdmobPlugin', 'showBannerAd', []);
@@ -21,20 +24,20 @@ exports.hideBannerAd = function (success, error) {
 exports.removeBannerAd = function (arg0, success, error) {
     exec(success, error, 'emiAdmobPlugin', 'removeBannerAd', [arg0]);
 };
-exports.loadInterstitialAd = function (arg0, success, error) {
-    exec(success, error, 'emiAdmobPlugin', 'loadInterstitialAd', arg0);
+exports.loadInterstitialAd = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'loadInterstitialAd', [options]);
 };
 exports.showInterstitialAd = function (success, error) {
     exec(success, error, 'emiAdmobPlugin', 'showInterstitialAd', []);
 };
-exports.loadRewardedAd = function (arg0, success, error) {
-    exec(success, error, 'emiAdmobPlugin', 'loadRewardedAd', arg0);
+exports.loadRewardedAd = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'loadRewardedAd', [options]);
 };
 exports.showRewardedAd = function (success, error) {
     exec(success, error, 'emiAdmobPlugin', 'showRewardedAd', []);
 };
-exports.loadRewardedInterstitialAd = function (arg0, success, error) {
-    exec(success, error, 'emiAdmobPlugin', 'loadRewardedInterstitialAd', arg0);
+exports.loadRewardedInterstitialAd = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'loadRewardedInterstitialAd', [options]);
 };
 exports.showRewardedInterstitialAd = function (success, error) {
     exec(success, error, 'emiAdmobPlugin', 'showRewardedInterstitialAd', []);
@@ -48,8 +51,8 @@ exports.getConsentRequest = function (success, error) {
 exports.consentReset = function (success, error) {
     exec(success, error, 'emiAdmobPlugin', 'consentReset', []);
 };
-exports.targeting = function (arg0, success, error) {
-    exec(success, error, 'emiAdmobPlugin', 'targeting', arg0);
+exports.targeting = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'targeting', [options]);
 };
 exports.getIabTfc = function (success, error) {
     exec(success, error, 'emiAdmobPlugin', 'getIabTfc', []);
@@ -57,6 +60,28 @@ exports.getIabTfc = function (success, error) {
 exports.showPrivacyOptionsForm = function (success, error) {
     exec(success, error, 'emiAdmobPlugin', 'showPrivacyOptionsForm', []);
 };
-exports.globalSettings = function (arg0, success, error) {
-    exec(success, error, 'emiAdmobPlugin', 'globalSettings', arg0);
-};
+exports.globalSettings = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'globalSettings', [options]);
+};
+exports.forceDisplayPrivacyForm = function (success, error) {
+        exec(success, error, 'emiAdmobPlugin', 'forceDisplayPrivacyForm', []); // only IOS
+};
+
+    
+// v1.4.9 ( only Android )
+// only isUsingAdManagerRequest: true
+// AdManagerAdRequest.Builder
+exports.targetingAdRequest = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'targetingAdRequest', [options]);
+};
+exports.setPersonalizationState = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'setPersonalizationState', [options]);
+};
+exports.setPPS = function (options, success, error) {
+    exec(success, error, 'emiAdmobPlugin', 'setPPS', [options]);
+};
+
+
+
+
+

package/example/Advanced topics/IABTFC.html

@@ -1,187 +0,0 @@
-<html>
-
-<head>
-    <script type="text/javascript" src="cordova.js"></script>
-</head>
-
-<body>
-
-    <label for="event">Debug Event All response :</label>
-    <textarea id="event" name="event" rows="15" cols="40"></textarea>
-
-    <script>
-
-        let event = document.getElementById('event');
-
-        let cleanText = () => { event.value = '' };
-
-        // 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();
-}
-
-        // >>>>>>>>  User Messaging Platform (UMP) SDK 2.1.0
-
-        let getConsentRequest = () => {
-            // https://developers.google.com/admob/android/privacy
-            cordova.plugins.emiAdmobPlugin.getConsentRequest(
-
-                (ststus) => {
-
-                    event.value += "\n Consent Status: " + ststus;
-
-                },
-                (error) => {
-
-                    event.value += "\n Error: " + error
-
-                });
-
-        }
-
-
-        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
-
-                });
-
-        }
-
-        
-
-        /*
-        IAB Europe Transparency & Consent Framework
-        Final v.2.2 May 2023
-        */
-        // >>>>>>>>  New features (UMP) SDK v2.1.0
-        // https://developers.google.com/admob/android/privacy/gdpr
-        let getIabTfc = () => {
-
-            cordova.plugins.emiAdmobPlugin.getIabTfc(
-                /*
-                If the user chooses not to display ads, 
-                you can restrict access to the app, or ban it,
-                until they change their decision back, 
-                Just call showPrivacyOptionsForm();
-                */
-                (info) => {
-                    // How to read consent choices
-                    event.value += "\n IABTCF_gdprApplies: " + info.IABTCF_gdprApplies;
-                    event.value += "\n IABTCF_PurposeConsents: " + info.IABTCF_PurposeConsents; // In order for the ad to be displayed this must be filled in
-                    event.value += "\n IABTCF_TCString: " + info.IABTCF_TCString; // In order for the ad to be displayed this must be filled in
-                    /*
-                                        // A small example
-                                        var fundingChoices;
-                    
-                                        fundingChoices = info.IABTCF_PurposeConsents;
-                                       if (fundingChoices === "1111111111"){
-                                           
-                                       // Enable app features.
-                                        loadRewardedAd();
-                                        
-                                       } else if (fundingChoices === "") {
-                    
-                                           // disable app features.
-                    
-                                       } else {
-                    
-                                          // You have to test everything yourself.
-                    
-                                       }
-                    */
-                },
-                (error) => {
-
-                    event.value += "\n Error: " + error
-
-                });
-
-        }
-
-
-        /////  >>>>>> Device Ready <<<<<<
-
-
-        document.addEventListener("deviceready", function () {
-
-            
-            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);
-            cordova.plugins.emiAdmobPlugin.initialize();
-
-
-            // Rewarded Ad EVENT
-
-            /*
-            on.rewarded.loaded
-            on.rewarded.failed.load
-            on.rewarded.click
-            on.rewarded.dismissed
-            on.rewarded.failed.show
-            on.rewarded.impression
-            on.rewarded.show
-            on.rewarded.revenue
-            on.rewarded.ad.skip
-            on.reward.userEarnedReward
-            */
-
-
-            document.addEventListener('on.rewarded.loaded', () => {
-
-                event.value += ("\n on.rewarded.loaded");
-
-            });
-
-            
-
-        }, false);
-
-    </script>
-
-    <p> <button onclick="getConsentRequest();">Get Consent Status</button></p>
-    <p> <button onclick="showPrivacyOptionsForm();">Show Privacy Options Form</button></p>
-    <p> <button onclick="getIabTfc();">Get IAB TFC Status</button></p>
-    <p> <button onclick="consentReset();">Consent Reset</button></p>
-
-    <p> <button onclick="loadRewardedAd();">Load Rewarded Ad</button></p>
-    <p> <button onclick="showRewardedAd();">Show Rewarded Ad</button></p>
-
-
-    <p> <button onclick="cleanText();">Clean response Text</button></p>
-
-
-</body>
-
-</html>

package/example/Advanced topics/consent.html

@@ -1,156 +0,0 @@
-<html>
-<head>
-    <script type="text/javascript" src="cordova.js"></script>
-</head>
-<body>
-
-<script>
-
-
- // >>>>>>>>  User Messaging Platform (UMP) SDK 2.1.0
-
- let getConsentStatus = () => {
-            // https://developers.google.com/admob/android/privacy
-            cordova.plugins.emiAdmobPlugin.getConsentRequest(
-
-                (ststus) => {
-
-                    event.value += "\n Consent Status: " + ststus;
-
-                },
-                (error) => {
-
-                    event.value += "\n Error: " + error
-
-                });
-
-        }
-
-
-        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
-
-                });
-
-        }
-
-
-
-      /////  >>>>>> 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();
-	
-	
-	
-	
-	
-	
-	
-	
-	
-	// Optional Consent Event 
-	
-/*
-
-
-on.consent.info.update
-on.consent.info.update.failed
-
-on.consent.status.not_required
-on.consent.status.obtained
-on.consent.status.required
-on.consent.status.unknown
-
-on.consent.failed.show
-on.consent.failed.load.from
-on.consent.form.not.available
-*/
-	
-
-document.addEventListener('on.consent.info.update', () => {
-
-alert("on.consent.info.update");
-
-});
-
-document.addEventListener('on.consent.info.update.failed', () => {
-
-alert("on.consent.info.update.failed");
-
-});
-
-////////////////////////////////////////////////
-
-// https://developers.google.com/admob/android/privacy/api/reference/com/google/android/ump/ConsentInformation.ConsentStatus
-
-document.addEventListener('on.consent.status.not_required', () => {
-// Constant Value: 1
-alert("User consent not required.");
-
-});
-
-document.addEventListener('on.consent.status.obtained', () => {
-// Constant Value: 3
-alert("User consent obtained. Personalized vs non-personalized undefined.");
-
-});
-
-document.addEventListener('on.consent.status.required', () => {
-// Constant Value: 2
-// is Consent Form Available = the code auto, load Consent Form and consent Form show.
-alert("User consent required but not yet obtained.");
-
-});
-
-document.addEventListener('on.consent.status.unknown', () => {
-//Constant Value: 0
-alert("Consent status is unknown.");
-
-});
-
-}, false);
-</script>
-
-<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>
-
-
-
-
-</body>
-</html>

package/example/Advanced topics/globalSettings.html

@@ -1,49 +0,0 @@
-<html>
-<head>
-    <script type="text/javascript" src="cordova.js"></script>
-</head>
-<body>
-
-<script>
-
-
-// ### As suggested by Google, when the SDK initializes this plugin automatically takes the Global Settings and Targeting values.
-
-// ### Global Settings
-
- /////  >>>>>> Device Ready <<<<<<
-
-document.addEventListener("deviceready", function(){
-
-
-
-// Instruction: https://developers.google.com/admob/android/global-settings
-
-// 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 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
-    setDebugGeography = false // default: false
-
-]
-
-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>
-
-
-</body>
-</html>

package/example/Advanced topics/requestIDFA.html

@@ -1,59 +0,0 @@
-<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

@@ -1,64 +0,0 @@
-<html>
-<head>
-    <script type="text/javascript" src="cordova.js"></script>
-</head>
-<body>
-
-<script>
-
-
-// ### Targeting
-
- /////  >>>>>> Device Ready <<<<<<
-
-document.addEventListener("deviceready", function(){
-
-
-// Instruction: https://developers.google.com/admob/android/targeting
-// Overview: https://developers.google.com/android/reference/com/google/android/gms/ads/RequestConfiguration
-
-// 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();
-
-// >>>>>>>>>>>  Description   <<<<<<<<<<<<<<<
-	
-// (TagForChildDirectedTreatment)
-// Type number:
-// value: 0 | -1 | 1
-// (value description)
-// 0 = FALSE
-// 1 = TRUE
-// -1 = UNSPECIFIED
-// (if else/undefined = false/0)
-
-
-//////////////////////////////
-
-// (MaxAdContentRating)
-// Type String:
-// value: G | MA | PG | T | ""
-// (value description)
-// https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/max-ad-content-rating
-// (if else/undefined/"" = NULL)
-
-
-}, false);
-</script>
-
-
-</body>
-</html>