emi-indo-cordova-plugin-admob 0.0.9 → 1.1.9

package/README.md

@@ -1,7 +1,7 @@
 # emi-indo-cordova-plugin-admob
  Cordova Plugin Admob Android and IOS
 
-### Mobile Ads SDK (Android: 22.0.0) [Release Notes:](https://developers.google.com/admob/android/rel-notes)
+### Mobile Ads SDK (Android: 22.2.0) [Release Notes:](https://developers.google.com/admob/android/rel-notes)
 
 ### Mobile Ads SDK (IOS: 10.3.0) [Release Notes:](https://developers.google.com/admob/ios/rel-notes)
 
@@ -10,13 +10,6 @@
 -
 
 
-> __Warning__
-> Updating the Mobile Ads SDK version may cause some code to malfunction, as the latest version usually deprecates some older code, [scrrenshot](https://drive.google.com/file/d/1UKaEjdmGRXgdZ2DKfOne8BSq13IUY14_/view) Current plugin code SDK 22.0.0
-
-> __Warning__
-> If the cordova admob plugin using Mobile Ads SDK code version 20.6.0 is upgraded to Mobile Ads SDK version 22.0.0, some of the old plugin code will not work.
-
-
   > __Note__
 > - ## It's Not a fork, it's purely rewritten, clean of 3rd party code.
 
@@ -30,8 +23,19 @@
 ## 💰Sponsor this project
   [![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/emiindo)  
   
- ## Features
+##  [Check all release notes:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/)
+
+
+## Minimum Cordova Engines
+- cordova version = 10.0.0
+- cordova-android version = 11.0.0
+- cordova-ios version = 6.0.0
 
+## Features
+
+- SDK initialize
+- targeting
+- globalSettings
 - App Open Ads
 - Banner Ads
 - Interstitial Ads
@@ -44,6 +48,11 @@
 - App Open Ads ( Finished )
 - User Consent ( Finished ) [emi-indo-cordova-plugin-consent](https://github.com/EMI-INDO/emi-indo-cordova-plugin-consent)
 - Mediation ( Finished )
+- https://developers.google.com/admob/android/native/start
+- https://developers.google.com/admob/android/impression-level-ad-revenue ( Finished ) v1.1.9
+- https://developers.google.com/admob/android/ssv
+
+
 
 
 ## Installation
@@ -66,318 +75,31 @@ cordova plugin rm emi-indo-cordova-plugin-admob
 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"
-  }
-}
-```
-
-
-## 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.
-
-cordova.plugins.emiAdmobPlugin.initialize();
-
-document.addEventListener('on.SdkInitializationComplete', () => {
-
-alert("on Sdk Initialization Complete");
-
-});
-
-
-```
-
-
-## App Open Ads
-
-> __Note__
-### Variable name and index (final) cannot be changed.
-- appOpenAdUnitId | index 0
-- npa | index 1
-- responseInfo | index 2
-
-```sh
-// load App Open Ad
-
-let loadAppOpenAd = () => {
-    cordova.plugins.emiAdmobPlugin.loadAppOpenAd(
-    appOpenAdUnitId = "ca-app-pub-3940256099942544/3419835294",
-    npa = "1", // String | 0 | 1
-    responseInfo = true, // boolean
-
-    (info) => { alert(info) },
-    (error) => { alert(error)
-
-    });
-}
-
-// call loadAppOpenAd();
-
-// Show App Open Ad
-
-let showAppOpenAd = () => {
-    cordova.plugins.emiAdmobPlugin.showAppOpenAd();
-}
-
-// call showAppOpenAd();
-
-```
-
-
-## Banner Ads
-
-> __Note__
-### Variable name and index (final) cannot be changed.
-- bannerAdUnitId | index 0
-- npa | index 1
-- position | index 2
-- size | index 3
-- adaptiveWidth | index 4
-
-
-
-```sh
-/// setting banner size: 
-/*          
-BANNER
-FLUID 
-LARGE_BANNER
-MEDIUM_RECTANGLE
-FULL_BANNER
-LEADERBOARD
-(Smart Banners = DEPRECATED)
-Inline_adaptive
-Anchored_adaptive
-default: Anchored_FULL_WIDTH
-
-adaptiveWidth = 320 // number (only adaptive banner)
-
-*/
-/// setting banner position:  
-/*     
-top-right
-top-center
-left
-center
-right
-bottom-center
-bottom-right
-default: "bottom-left"
-*/
-
-
-//  Banner Adaptive
-
-let showBannerAdaptive = () => {
-    cordova.plugins.emiAdmobPlugin.showBannerAd(
-    bannerAdUnitId = "ca-app-pub-3940256099942544/6300978111",
-    npa = "1", // String | 0 | 1
-    position = "bottom-center",
-    size = "Anchored_FULL_WIDTH", // | Inline_adaptive | Anchored_adaptive
-    adaptiveWidth = 320,
-    responseInfo = true, // boolean (debugging)
-    
-    (info) => { alert(info) },
-    (error) => { alert(error)
-
-    });
-}
-
-// call showBannerAdaptive();
-
-//  not Adaptive banner
-
-let showBannerNotAdaptive = () => {
-    cordova.plugins.emiAdmobPlugin.showBannerAd(
-    bannerAdUnitId = "ca-app-pub-3940256099942544/6300978111",
-    npa = "1", // String | 0 | 1
-    position = "bottom-center",
-    size = "FLUID",
-    responseInfo = true, // boolean (debugging)
-    
-    (info) => { alert(info) },
-    (error) => { alert(error)
 
-    });
-}
-
-// call showBannerNotAdaptive();
-
-// Remove Banner
-
-let removeBannerAd = () => {
-    cordova.plugins.emiAdmobPlugin.removeBannerAd();
-}
-
-// call removeBannerAd();
-
-```
- [Banner ads event](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob#-banner-ads-) - callback:
-
-
-## Interstitial Ads
-
-> __Note__
-### Variable name and index (final) cannot be changed.
-- interstitialAdAdUnitId | index 0
-- npa | index 1
-- responseInfo | index 2
 
-```sh
-// Load Interstitial Ad
-
-let loadInterstitialAd = () => {
-    cordova.plugins.emiAdmobPlugin.loadInterstitialAd(
-    interstitialAdAdUnitId = "ca-app-pub-3940256099942544/1033173712",
-    npa = "1", // String | 0 | 1
-    responseInfo = true, // boolean (debugging)
-
-    (info) => { alert(info) }, 
-    (error) => { alert(error)
-    
-    });
-}
-
-// call loadInterstitialAd();
-
-// Show Interstitial Ad
-
-let showInterstitialAd = () => {
-    cordova.plugins.emiAdmobPlugin.showInterstitialAd();
-}
-
-// call showInterstitialAd();
-
-```
-
- [Interstitial ads event](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob#-interstitial-ads-) - callback:
-
-
-
-## Rewarded Ads
-
-> __Note__
-### Variable name and index (final) cannot be changed.
-- rewardedAdAdUnitId | index 0
-- npa | index 1
-- responseInfo | index 2
-
-```sh
-
-// Load Rewarded Ad
-
-let loadRewardedAd = () => {
-    cordova.plugins.emiAdmobPlugin.loadRewardedAd(
-    rewardedAdAdUnitId = "ca-app-pub-3940256099942544/5224354917",
-    npa = "1", // String | 0 | 1
-    responseInfo = true, // boolean (debugging)
-
-    (info) => { alert(info) },
-    (error) => { alert(error)
-
-    });
-}
-
-// call loadRewardedAd();
-
-// Show Rewarded Ad
-
-let showRewardedAd = () => {
-    cordova.plugins.emiAdmobPlugin.showRewardedAd();
-}
-
-// call showRewardedAd();
-
-
-```
-
-[Rewarded ads event](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob#-rewarded-ads-) - callback:
-
-
-## Rewarded interstitial Ads
-
-> __Note__
-### Variable name and index (final) cannot be changed.
-- rewardedInterstitialAdUnitId | index 0
-- npa | index 1
-- responseInfo | index 2
-
-```sh
-
-// load Rewarded Interstitial Ad
-
-let loadRewardedInterstitialAd = () => {
-    cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd(
-    rewardedInterstitialAdUnitId = "ca-app-pub-3940256099942544/5354046379",
-    npa = "1", // String | 0 | 1
-    responseInfo = true, // boolean (debugging)
-   
-    (info) => { alert(info) },
-    (error) => { alert(error)
-
-    });
-}
-
-// call loadRewardedInterstitialAd();
-
-// Show Rewarded Interstitial Ad
-
-const showRewardedInterstitialAd = () => {
-    cordova.plugins.emiAdmobPlugin.showRewardedInterstitialAd();
-}
-
-// cal showRewardedInterstitialAd();
+  > __Note__
+> - # Plugin version @1.1.9
 
+ [FULL Example ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/) - index.html:
 
-```
+ ###  [ App Open Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/app_open_ads.html)
+ ###  [ Banner Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/banner_ads.html)
+ ###  [ Interstitial Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/interstitial_ads.html)
+ ###  [ Rewarded interstitial Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_interstitial_ads.html)
+ ###  [ Rewarded Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_ads.html)
 
-[Rewarded interstitial ads event](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob#-rewarded-ads-) - callback:
+ ###  [ Advanced topics: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/tree/main/example/Advanced%20topics)
 
+ 
 
 
 # Event | callback:
-### event code
+### Example event code
 
 ```sh
-document.addEventListener('on.bannerAdLoaded', () => {
+document.addEventListener('on.appOpenAd.loaded', () => {
 
-alert("on.banner Ad Loaded");
+alert("On App Open Ad loaded");
 
 });
 
@@ -387,21 +109,22 @@ alert("on.banner Ad Loaded");
 ### (final) cannot be changed.
 
 ## ( SDK )
-- on.SdkInitializationComplete
-
+- on.sdkInitialization
 
 ## ( App Open Ads )
 
 ### Event Load
 
-- on.open.loaded
-- on.open.failed.loaded
+- on.appOpenAd.loaded
+- on.appOpenAd.failed.loaded
 
 ### Event Show
 
-- on.open.dismissed
-- on.open.failed.show
-- on.open.show
+- on.appOpenAd.dismissed
+- on.appOpenAd.failed.show
+- on.appOpenAd.show
+ ### NEW
+- on.appOpenAd.revenue
 
 
 ## ( Banner Ads )
@@ -430,20 +153,26 @@ alert("on.banner Ad Loaded");
 - LEADERBOARD
 - adaptiveWidth = number 
 - Smart Banners = DEPRECATED
-- default: Anchored_FULL_WIDTH
+- default: Adaptive_FULL_WIDTH
 
+Note: Smart Banners = DEPRECATED ( Replaced by Adaptive_FULL_WIDTH )
 
 
+### Event Load
 
-### Event Load a Show
+- on.banner.load
+- on.banner.failed.load
 
-- on.bannerAdClicked
-- on.bannerAdClosed
-- on.bannerAdFailedToLoad
-- on.bannerAdImpression
-- on.bannerAdLoaded
-- on.bannerAdOpened
+### Event Show
 
+- on.banner.click
+- on.banner.close
+- on.banner.impression
+- on.banner.open
+### NEW
+- on.banner.revenue
+- on.banner.remove
+  
 
 
 
@@ -451,16 +180,19 @@ alert("on.banner Ad Loaded");
 
 ### Event Load
 
-- on.InterstitialAdLoaded
-- on.InterstitialAdFailedToLoad
+- on.interstitial.loaded
+- on.interstitial.failed.load
 
 ### Event Show
 
-- on.InterstitialAdClicked
-- on.InterstitialAdDismissedFullScreenContent
-- on.InterstitialAdFailedToShowFullScreenContent
-- on.InterstitialAdImpression
-- on.InterstitialAdShowedFullScreenContent
+- on.interstitial.click
+- on.interstitial.dismissed
+- on.interstitial.failed.show
+- on.interstitial.impression
+- on.interstitial.show
+### NEW
+- on.interstitial.revenue
+
 
 
 
@@ -469,18 +201,21 @@ alert("on.banner Ad Loaded");
 
 ### Event Load
 
-- on.RewardedAdFailedToLoad
-- on.RewardedAdLoaded
+- on.rewarded.loaded
+- on.rewarded.failed.load
 
 
 ### Event Show
 
-- on.rewardedAdClicked
-- on.rewardedAdDismissedFullScreenContent
-- on.rewardedAdFailedToShowFullScreenContent
-- on.rewardedAdImpression
-- on.rewardedAdShowedFullScreenContent
-- on.rewarded.rewarded
+- on.rewarded.click
+- on.rewarded.dismissed
+- on.rewarded.failed.show
+- on.rewarded.impression
+- on.rewarded.show
+### NEW
+- on.rewarded.revenue
+- on.rewarded.ad.skip
+- on.reward.userEarnedReward
 
 
 
@@ -488,22 +223,70 @@ alert("on.banner Ad Loaded");
 
 ### Event Load
 
-- on.RewardedInterstitialAdLoaded
-- on.RewardedInterstitialAdFailedToLoad
+- on.rewardedInt.loaded
+- on.rewardedInt.failed.load
 
 
 ### Event Show
 
-- on.rewardedInterstitialAdClicked
-- on.rewardedInterstitialAdDismissedFullScreenContent
-- on.rewardedInterstitialAdFailedToShowFullScreenContent
-- on.rewardedInterstitialAdImpression
-- on.rewardedInterstitialAdShowedFullScreenContent
-- on.rewardedInterstitial.rewarded
+- on.rewardedInt.click
+- on.rewardedInt.dismissed
+- on.rewardedInt.failed.show
+- on.rewardedInt.impression
+- on.rewardedInt.showed
+### NEW
+- on.rewardedInt.revenue
+- on.rewardedInt.ad.skip
+- on.rewardedInt.userEarnedReward
 
 
 
 
+## 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"
+  }
+}
+
+
+Bundle[{max_ad_content_rating=G, 
+npa=1, 
+is_designed_for_families=0, 
+under_age_of_consent=0] 
+
+
+```
+
+
+
 
 # Admob Mediation
 <img src="https://user-images.githubusercontent.com/78555833/229587307-91a7e380-aa2d-4140-a62d-fa8e6a8dd153.png" width="500">
@@ -653,4 +436,11 @@ emi-indo-cordova-plugin-admob@0.0.5
  - ### emi-indo-cordova-plugin-open-ai
   
   [Cordova Plugin Open Ai:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-open-ai) - Open AI:
+  
+  
+   ## New Firebase Analytics
+ 
+ - ### emi-indo-cordova-plugin-fanalytics
+  
+  [Cordova Plugin Firebase Analytics:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-fanalytics) - Firebase Analytics:
                              

package/example/Advanced topics/auto_load_and_show.html

@@ -0,0 +1,94 @@
+<html>
+<head>
+    <script type="text/javascript" src="cordova.js"></script>
+</head>
+<body>
+
+<script>
+
+
+// For example automatically load Interstitial Ad
+
+// Load Interstitial Ad
+
+let loadInterstitialAd = () => {
+    cordova.plugins.emiAdmobPlugin.loadInterstitialAd(
+    AdUnitId = "ca-app-pub-3940256099942544/1033173712",
+	npa = "1", // String | 0 | 1
+    responseInfo = true, // boolean
+
+    // Optional
+	(info) => { alert(info) }, 
+    (error) => { alert(error)
+    
+    });
+
+    // call loadInterstitialAd();
+}
+
+// Show Interstitial Ad
+
+let showInterstitialAd = () => {
+    cordova.plugins.emiAdmobPlugin.showInterstitialAd();
+
+    // call showInterstitialAd();
+}
+
+
+
+
+// deviceready
+
+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();
+
+
+// auto load call loadInterstitialAd();
+
+ loadInterstitialAd();
+
+
+
+
+// Interstitial EVENT
+
+/*
+on.interstitial.loaded
+on.interstitial.failed.load
+on.interstitial.click
+on.interstitial.dismissed
+on.interstitial.failed.show
+on.interstitial.impression
+on.interstitial.show
+on.interstitial.revenue
+*/
+
+document.addEventListener('on.interstitial.loaded', () => {
+
+    // auto show call showInterstitialAd();
+
+    showInterstitialAd();
+
+    console.log("on Interstitial Ad Loaded");
+
+});
+
+
+
+
+}, false);
+
+</script>
+
+
+<p> <button onclick="loadInterstitialAd();">Load Interstitial Ad</button></p>
+<p> <button onclick="showInterstitialAd();">Show Interstitial Ad</button></p>
+
+
+
+</body>
+</html>