emi-indo-cordova-plugin-admob 0.0.4 → 0.0.6

package/README.md

@@ -27,18 +27,25 @@ https://user-images.githubusercontent.com/78555833/228323239-e9e18e74-b814-4ca8-
 
 
 
-
+## 💰Sponsor this project
+  [![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/emiindo)  
+  
  ## Features
 
 - Banner Ads
 - Interstitial Ads
 - Rewarded Ads
 - Rewarded interstitial Ads
+- [Consent](https://github.com/EMI-INDO/emi-indo-cordova-plugin-consent)
+- Mediation
 
  ## Coming soon
 - App Open Ads
-- User Consent
-- Mediation ( In the process )
+- User Consent ( Finished ) [emi-indo-cordova-plugin-consent](https://github.com/EMI-INDO/emi-indo-cordova-plugin-consent)
+- Mediation ( Finished )
+
+
+
 
 
 ## Installation
@@ -55,135 +62,244 @@ cordova plugin add https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob --v
 cordova plugin rm emi-indo-cordova-plugin-admob
 ```
 
-## Upgrade Mobile Ads SDK
+## upgrade Mobile Ads SDK
 [Release Notes Mobile Ads SDK:](https://developers.google.com/admob/android/rel-notes)
 ```sh
-cordova plugin add https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob --variable APP_ID_ANDROID=ca-app-pub-3940256099942544~3347511713 --variable PLAY_SERVICES_VERSION="xxxx" 
+cordova plugin add emi-indo-cordova-plugin-admob --variable APP_ID_ANDROID=ca-app-pub-3940256099942544~3347511713 --variable PLAY_SERVICES_VERSION="xxxx" 
 ```
 
+## Response Info
+- Here is a sample output returned by responseInfo = true showing the debugging data returned for a loaded ad:
 
+```sh
+{
+  "Response ID": "COOllLGxlPoCFdAx4Aod-Q4A0g",
+  "Mediation Adapter Class Name": "com.google.ads.mediation.admob.AdMobAdapter",
+  "Adapter Responses": [
+    {
+      "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
+      "Latency": 328,
+      "Ad Source Name": "Reservation campaign",
+      "Ad Source ID": "7068401028668408324",
+      "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
+      "Ad Source Instance ID": "4665218928925097",
+      "Credentials": {},
+      "Ad Error": "null"
+    }
+  ],
+  "Loaded Adapter Response": {
+    "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
+    "Latency": 328,
+    "Ad Source Name": "Reservation campaign",
+    "Ad Source ID": "7068401028668408324",
+    "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
+    "Ad Source Instance ID": "4665218928925097",
+    "Credentials": {},
+    "Ad Error": "null"
+  },
+  "Response Extras": {
+    "mediation_group_name": "Campaign"
+  }
+}
+```
 
-## 💰Sponsor this project
-  [![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/emiindo)  
 
 ## deviceready
 
 [Example ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/index.html) - index.html:
 
 
+```sh
 
+// 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.
 
-```sh
+cordova.plugins.emiAdmobPlugin.initialize();
 
-/*
-( set banner size: )
+document.addEventListener('on.SdkInitializationComplete', () => {
 
-Anchored_adaptive
-Inline_adaptive
-BANNER
-LARGE_BANNER
-MEDIUM_RECTANGLE
-FULL_BANNER
-LEADERBOARD
-Smart Banners = DEPRECATED
-default: Anchored_adaptive
+alert("on Sdk Initialization Complete");
 
+});
 
-( set banner position )
 
-top-right
-top-center
-left
-center
-right
-bottom-center
-bottom-right
+```
 
-adaptiveWidth = 320 // default: 320
-*/
+## Banner Ads
 
+> __Note__
+### Variable name and index (final) cannot be changed.
+- bannerAdUnitId | index 0
+- position | index 1
+- size | index 2
+- adaptiveWidth | index 3
 
-var bannerAdUnitId = "ca-app-pub-3940256099942544/6300978111"
-var interstitialAdAdUnitId = "ca-app-pub-3940256099942544/1033173712"
-var rewardedInterstitialAdUnitId = "ca-app-pub-3940256099942544/5354046379"
-var rewardedAdAdUnitId = "ca-app-pub-3940256099942544/5224354917"
 
-var size = "Anchored_adaptive"     
-var position = "bottom-center"
-var adaptiveWidth = 320
+```sh
+/// setting banner size:           BANNER | LARGE_BANNER | MEDIUM_RECTANGLE | FULL_BANNER | LEADERBOARD | default: "BANNER" | (Smart Banners = DEPRECATED) | Inline_adaptive | Anchored_adaptive
 
+/// setting banner position:       top-right | top-center | left | center | right | bottom-center | bottom-right |  default: "bottom-left"
 
-// 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();
+//  Banner Adaptive
 
-document.addEventListener('on.SdkInitializationComplete', () => {
+let showBannerAdaptive = () => {
+    cordova.plugins.emiAdmobPlugin.showBannerAd(
+    bannerAdUnitId = "ca-app-pub-3940256099942544/6300978111",
+    position = "bottom-center",
+    size = "Inline_adaptive", // | Inline_adaptive | Anchored_adaptive
+    adaptiveWidth = 320,
 
-alert("on Sdk Initialization Complete");
+    (seccess) => { console.log("success") },
+    (error) => { alert(error)
 
-});
+    });
+}
 
+// call showBannerAdaptive();
 
-```
+//  not Adaptive banner
+
+let showBannerNotAdaptive = () => {
+    cordova.plugins.emiAdmobPlugin.showBannerAd(
+    bannerAdUnitId = "ca-app-pub-3940256099942544/6300978111",
+    position = "bottom-center",
+    size = "BANNER",
+    
+    (seccess) => { console.log("success") },
+    (error) => { alert(error)
+
+    });
+}
+
+// call showBannerNotAdaptive();
+
+// Remove Banner
+
+let removeBannerAd = () => {
+    cordova.plugins.emiAdmobPlugin.removeBannerAd();
+}
+
+// call removeBannerAd();
 
-## Banner Ads
-```sh
-// Load a Show BANNER   cordova.plugins.emiAdmobPlugin.showBannerAd(bannerAdUnitId, size, position);
-// Load a Show BANNER adaptive   cordova.plugins.emiAdmobPlugin.showBannerAd(bannerAdUnitId, size, position, adaptiveWidth);
-// remove cordova.plugins.emiAdmobPlugin.removeBannerAd();
 ```
  [Banner ads event](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob#-banner-ads-) - callback:
 
 
-## Interstitial ads
+## Interstitial Ads
+
+> __Note__
+### Variable name and index (final) cannot be changed.
+- interstitialAdAdUnitId | index 0
+- responseInfo | index 1
 
 ```sh
+// Load Interstitial Ad
+
+let loadInterstitialAd = () => {
+    cordova.plugins.emiAdmobPlugin.loadInterstitialAd(
+    interstitialAdAdUnitId = "ca-app-pub-3940256099942544/1033173712",
+    responseInfo = true, // boolean (debugging)
+
+    (info) => { alert(info) }, 
+    (error) => { alert(error)
+    
+    });
+}
+
+// call loadInterstitialAd();
 
-// Load cordova.plugins.emiAdmobPlugin.loadInterstitialAd(interstitialAdAdUnitId);
+// Show Interstitial Ad
+
+let showInterstitialAd = () => {
+    cordova.plugins.emiAdmobPlugin.showInterstitialAd();
+}
+
+// call showInterstitialAd();
 
-// Show  cordova.plugins.emiAdmobPlugin.showInterstitialAd();
 ```
 
  [Interstitial ads event](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob#-interstitial-ads-) - callback:
 
 
 
-## Rewarded ads
+## Rewarded Ads
+
+> __Note__
+### Variable name and index (final) cannot be changed.
+- rewardedAdAdUnitId | index 0
+- responseInfo | index 1
 
 ```sh
 
-// Load cordova.plugins.emiAdmobPlugin.loadRewardedAd(rewardedAdAdUnitId);
+// Load Rewarded Ad
+
+let loadRewardedAd = () => {
+    cordova.plugins.emiAdmobPlugin.loadRewardedAd(
+    rewardedAdAdUnitId = "ca-app-pub-3940256099942544/5224354917",
+    responseInfo = true, // boolean (debugging)
+   
+
+    (info) => { alert(info) },
+    (error) => { alert(error)
+
+    });
+}
+
+// call loadRewardedAd();
+
+// Show Rewarded Ad
+
+let showRewardedAd = () => {
+    cordova.plugins.emiAdmobPlugin.showRewardedAd();
+}
+
+// call showRewardedAd();
 
-// Show cordova.plugins.emiAdmobPlugin.showRewardedAd();
 
 ```
 
 [Rewarded ads event](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob#-rewarded-ads-) - callback:
 
 
-## Rewarded interstitial ads
+## Rewarded interstitial Ads
+
+> __Note__
+### Variable name and index (final) cannot be changed.
+- rewardedInterstitialAdUnitId | index 0
+- responseInfo | index 1
 
 ```sh
 
-// Load cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd(rewardedInterstitialAdUnitId);
+// load Rewarded Interstitial Ad
 
-// Show cordova.plugins.emiAdmobPlugin.showRewardedInterstitialAd();
+let loadRewardedInterstitialAd = () => {
+    cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd(
+    rewardedInterstitialAdUnitId = "ca-app-pub-3940256099942544/5354046379",
+    responseInfo = true, // boolean (debugging)
+   
+    (info) => { alert(info) },
+    (error) => { alert(error)
 
-```
+    });
+}
 
-[Rewarded interstitial ads event](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob#-rewarded-ads-) - callback:
+// call loadRewardedInterstitialAd();
 
+// Show Rewarded Interstitial Ad
 
-## handle success or error
+const showRewardedInterstitialAd = () => {
+    cordova.plugins.emiAdmobPlugin.showRewardedInterstitialAd();
+}
 
-[Example code ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/getMediationAdapterName.html)
-```sh
+// cal showRewardedInterstitialAd();
 
-cordova.plugins.emiAdmobPlugin.loadRewardedAd(rewardedAdAdUnitId, success, error);
 
 ```
 
+[Rewarded interstitial ads event](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob#-rewarded-ads-) - callback:
+
+
 
 # Event | callback:
 ### event code
@@ -197,12 +313,27 @@ alert("on.banner Ad Loaded");
 
 ```
 
+> __Note__
+### (final) cannot be changed.
+
 ## ( SDK )
 - on.SdkInitializationComplete
 
 
 ## ( Banner Ads )
 
+### position
+
+- top-right
+- top-center
+- left
+- center
+- right
+- bottom-center
+- bottom-right
+
+
+
 ### size
 - Anchored_adaptive
 - Inline_adaptive
@@ -211,21 +342,11 @@ alert("on.banner Ad Loaded");
 - MEDIUM_RECTANGLE
 - FULL_BANNER
 - LEADERBOARD
+- adaptiveWidth = number 
 - Smart Banners = DEPRECATED
 - default: Anchored_adaptive
 
 
-### position
-
-- top-right
-- top-center
-- left
-- center
-- right
-- bottom-center
-- bottom-right
-- adaptiveWidth = number 
-> default: 320
 
 
 ### Event Load a Show
@@ -299,7 +420,7 @@ alert("on.banner Ad Loaded");
 
 ## get Mediation Adapter Name
 
-[Example code ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/getMediationAdapterName.html) - get Mediation Adapter Name:
+responseInfo = true // (debugging)
 
 <img src="https://user-images.githubusercontent.com/78555833/230655800-0dbc3f12-72fb-4cf3-b4e6-801704fade28.png" width="250">
 
@@ -336,6 +457,39 @@ cordova plugin add emi-indo-cordova-plugin-mediation-unity
 cordova plugin add emi-indo-cordova-plugin-mediation-applovin
 ```
 
+- ================================
+
+
+## AdColony Ads
+[Integrate AdColony with Mediation :](https://developers.google.com/admob/android/mediation/adcolony)
+- (Adapter default: 4.8.0.1)
+### Installation
+```sh
+cordova plugin add emi-indo-cordova-plugin-mediation-adcolony
+```
+
+- ================================
+
+
+## Chartboost Ads
+[Integrate Chartboost with Mediation :](https://developers.google.com/admob/android/mediation/chartboost)
+- (Adapter default: 9.2.1.0)
+### Installation
+```sh
+cordova plugin add emi-indo-cordova-plugin-mediation-chartboost
+```
+
+- ================================
+
+
+## ironSource Ads
+[Integrate ironSource with Mediation :](https://developers.google.com/admob/android/mediation/ironsource)
+- (Adapter default: 7.2.7.0)
+### Installation
+```sh
+cordova plugin add emi-indo-cordova-plugin-mediation-ironsource
+```
+
 
 
 ## Variables name or preference name
@@ -356,25 +510,33 @@ cordova plugin add emi-indo-cordova-plugin-mediation-meta --variable META_ADAPTE
 - --variable META_ADAPTER_VERSION="xxxxx"
 - --variable UNITY_ADAPTER_VERSION="xxxxx"
 - --variable APPLOVIN_ADAPTER_VERSION="xxxxx"
+- --variable ADCOLONY_ADAPTER_VERSION="xxxxx"
+- --variable CHARTBOOST_ADAPTER_VERSION="xxxxx"
+- --variable IRONSOURCE_ADAPTER_VERSION="xxxxx"
 
 ### preference name
 
 - META_ADAPTER_VERSION
 - UNITY_ADAPTER_VERSION
 - APPLOVIN_ADAPTER_VERSION
-
-
+- ADCOLONY_ADAPTER_VERSION
+- CHARTBOOST_ADAPTER_VERSION
+- IRONSOURCE_ADAPTER_VERSION
 
 - ================================
 
 
+emi-indo-cordova-plugin-admob@0.0.5
 
-
-   > __Note__
+  
 > - ##  Note Release
-> emi-indo-cordova-plugin-admob@0.0.4
-
+- [emi-indo-cordova-plugin-admob@0.0.4](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/tag/%400.0.4) 
+ 
+- [emi-indo-cordova-plugin-admob@0.0.5](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/tag/v0.0.5) 
+ 
+ <img src="https://user-images.githubusercontent.com/78555833/231241800-8834ca2a-fa95-4cc2-91ca-1478c6b3c1ef.jpg" width="250">
 
+- [emi-indo-cordova-plugin-admob@0.0.6](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/tag/v0.0.6) 
 
 
 ### Platform Support

package/example/consent.html

@@ -0,0 +1,115 @@
+<html>
+<head>
+    <script type="text/javascript" src="cordova.js"></script>
+</head>
+<body>
+
+<script>
+
+// Installation
+
+// cordova plugin add emi-indo-cordova-plugin-consent
+// cordova plugin add emi-indo-cordova-plugin-admob
+
+
+let _getConsentRequest = () => {
+    cordova.plugins.emiAdmobPlugin.getConsentRequest(
+    setTagForUnderAgeOfConsent = false, // boolean
+
+    (status) => { alert(status) }, // check event code
+    (error) => { alert(error)
+
+    });
+}
+
+// call _getConsentRequest();
+
+
+
+let _consentReset = () => {
+    cordova.plugins.emiAdmobPlugin.consentReset();
+}
+
+// call _consentReset();
+
+
+
+
+document.addEventListener("deviceready", function(){
+
+
+
+
+document.addEventListener('onConsentInfoUpdateSuccess', () => {
+
+alert("on Consent Info Update Success");
+
+});
+
+document.addEventListener('onConsentInfoUpdateFailure', () => {
+
+alert("on Consen Info Update Failure");
+
+});
+
+////////////////////////////////////////////////
+
+// https://developers.google.com/admob/android/privacy/api/reference/com/google/android/ump/ConsentInformation.ConsentStatus
+
+document.addEventListener('on.ConsentStatus.NOT_REQUIRED', () => {
+// Constant Value: 1
+alert("User consent not required.");
+
+});
+
+document.addEventListener('on.ConsentStatus.OBTAINED', () => {
+// Constant Value: 3
+alert("User consent obtained. Personalized vs non-personalized undefined.");
+
+});
+
+document.addEventListener('on.ConsentStatus.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.ConsentStatus.UNKNOWN', () => {
+//Constant Value: 0
+alert("Consent status is unknown.");
+
+});
+
+
+////////////////////////////////////////////////////////////
+
+document.addEventListener('on.loadConsentFormError', () => {
+
+alert("on load Consent Form Error");
+
+});
+
+document.addEventListener('on.ConsentFormNotAvailable', () => {
+
+alert("on Consent Form Not Available");
+
+});
+
+
+
+
+}, false);
+</script>
+
+
+
+<p> <button onclick="_getConsentRequest();">get Consent Request</button></p>
+
+<p> <button onclick="_consentReset();">Consent reset</button></p>
+
+
+
+
+</body>
+</html>