Cordova AdMob plugin
Overview
Show admob banner, interstitial and rewarded video ad.
[android, ios, wp8] [cordova cli] [xdk] [cocoon] [phonegap build service]
Requires admob account http://www.google.com/ads/admob/
[Admob mediation networks]
adcolony
http://www.adcolony.com/
facebookads
https://developers.facebook.com/docs/audience-network
flurryads
http://www.flurry.com/
huntmads
http://huntmads.com/google
iad
http://advertising.apple.com/
inmobi
http://www.inmobi.com/
leadbolt
http://leadbolt.net/
lifestreet
http://www.lifestreet.com/
millennialmedia
http://www.millennialmedia.com/
mobfox
http://www.mobfox.com/google/
mojiva
http://welcome.mojiva.com/
mopub
http://www.mopub.com/
phunware (tapit)
http://www.phunware.com/advertising
This is open source cordova plugin.
You can see Cordova Plugins in one page: http://cranberrygame.github.io?referrer=github
Change log
2014.9.17 supports SKYSCRAPER
Install plugin
Cordova cli
https://cordova.apache.org/docs/en/edge/guide_cli_index.md.html#The Command-Line Interface - npm install -g cordova@6.0.0
cordova plugin add cordova-plugin-ad-admob(when build error, use github url: cordova plugin add https://github.com/cranberrygame/cordova-plugin-ad-admob) //If you want to mediate admob with other ad networks, then install the following additional ad networks you want to mediate with. (but too many mediations will increase app size) cordova plugin add cordova-plugin-ad-admob-adcolonycordova plugin add cordova-plugin-ad-admob-facebookadscordova plugin add cordova-plugin-ad-admob-flurryadscordova plugin add cordova-plugin-ad-admob-huntmadscordova plugin add cordova-plugin-ad-admob-iadcordova plugin add cordova-plugin-ad-admob-inmobicordova plugin add cordova-plugin-ad-admob-leadboltcordova plugin add cordova-plugin-ad-admob-lifestreetmediacordova plugin add cordova-plugin-ad-admob-millennialmediacordova plugin add cordova-plugin-ad-admob-mobfoxcordova plugin add cordova-plugin-ad-admob-mojivacordova plugin add cordova-plugin-ad-admob-mopubcordova plugin add cordova-plugin-ad-admob-phunware
Xdk
https://software.intel.com/en-us/intel-xdk - Download XDK - XDK PORJECTS - [specific project] - CORDOVA HYBRID MOBILE APP SETTINGS - Plugin Management - Add Plugins to this Project - Third Party Plugins -
Plugin Source: Cordova plugin registryPlugin ID: cordova-plugin-ad-admob //If you want to mediate admob with other ad networks, then install the following additional ad networks you want to mediate with. (but too many mediations will increase app size) Name: admob-adcolonyPlugin ID: cordova-plugin-ad-admob-adcolony[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-adcolony Name: admob-facebookadsPlugin ID: cordova-plugin-ad-admob-facebookads[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-facebookads Name: admob-flurryadsPlugin ID: cordova-plugin-ad-admob-flurryads[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-flurryads Name: admob-huntmadsPlugin ID: cordova-plugin-ad-admob-huntmads[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-huntmads Name: admob-iadPlugin ID: cordova-plugin-ad-admob-iad[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-iad Name: admob-inmobiPlugin ID: cordova-plugin-ad-admob-inmobi[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-inmobi Name: admob-leadboltPlugin ID: cordova-plugin-ad-admob-leadbolt[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-leadbolt Name: admob-lifestreetmediaPlugin ID: cordova-plugin-ad-admob-lifestreetmedia[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-lifestreetmedia Name: admob-millennialmediaPlugin ID: cordova-plugin-ad-admob-millennialmedia[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-millennialmedia Name: admob-mobfoxPlugin ID: cordova-plugin-ad-admob-mobfox[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-mobfox Name: admob-mojivaPlugin ID: cordova-plugin-ad-admob-mojiva[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-mojiva Name: admob-mopubPlugin ID: cordova-plugin-ad-admob-mopub[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-mopub Name: admob-phunwarePlugin ID: ccordova-plugin-ad-admob-phunware[Do not check] Plugin is located in the Apache Cordova Plugins RegistryRepo URL: https://github.com/cranberrygame/cordova-plugin-ad-admob-phunware
Cocoon
https://cocoon.io - Create project - [specific project] - Setting - Plugins - Custom - Git Url: https://github.com/cranberrygame/cordova-plugin-ad-admob.git - INSTALL - Save
//If you want to mediate admob with other ad networks, then install the following additional ad networks you want to mediate with. (but too many mediations will increase app size)
https://github.com/cranberrygame/cordova-plugin-ad-admob-adcolony.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-facebookads.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-flurryads.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-huntmads.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-iad.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-inmobi.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-leadbolt.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-lifestreetmedia.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-millennialmedia.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-mobfox.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-mojiva.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-mopub.git
https://github.com/cranberrygame/cordova-plugin-ad-admob-phunware.git
Phonegap build service (config.xml)
https://build.phonegap.com/ - Apps - [specific project] - Update code - Zip file including config.xml
<gap:plugin name="cordova-plugin-ad-admob" source="npm" /> //If you want to mediate admob with other ad networks, then install the following additional ad networks you want to mediate with. (but too many mediations will increase app size) <gap:plugin name="cordova-plugin-ad-admob-adcolony" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-facebookads" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-flurryads" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-huntmads" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-iad" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-inmobi" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-leadbolt" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-lifestreetmedia" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-millennialmedia" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-mobfox" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-mojiva" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-mopub" source="npm" /><gap:plugin name="cordova-plugin-ad-admob-phunware" source="npm" />
Construct2
Download construct2 plugin
https://dl.dropboxusercontent.com/u/186681453/pluginsforcordova/index.html
How to install c2 native plugins in xdk, cocoon and cordova cli
https://plus.google.com/102658703990850475314/posts/XS5jjEApJYV
//If you want to mediate admob with other ad networks, then install the following additional ad networks you want to mediate with. (but too many mediations will increase app size)
Cordova AdMobAdColony construct2 plugin
Cordova AdMobFacebookAds construct2 plugin
Cordova AdMobFlurryAds construct2 plugin
Cordova AdMobHuntMAds construct2 plugin
Cordova AdMobiAd construct2 plugin
Cordova AdMobInMobi construct2 plugin
Cordova AdMobLeadbolt construct2 plugin
Cordova AdMobLifeStreetMedia construct2 plugin
Cordova AdMobMillennialMedia construct2 plugin
Cordova AdMobMobFox construct2 plugin
Cordova AdMobMojiva construct2 plugin
Cordova AdMobMoPub construct2 plugin
Cordova AdMobPhunware construct2 plugin
Server setting
bannerAdUnit, interstitialAdUnit
admob mediation
The step to use admob mediation networks is following:
1)Just install additional ad network plugin.
2)Join mediation networks. (See Overview section)
3)Set the mediation setting in admob console.
# API # ```javascript var bannerAdUnit = "REPLACE_THIS_WITH_YOUR_BANNER_AD_UNIT"; var interstitialAdUnit = "REPLACE_THIS_WITH_YOUR_INTERSTITIAL_AD_UNIT"; var rewardedVideoAdUnit = "REPLACE_THIS_WITH_YOUR_REWARDED_VIDEO_AD_UNIT"; var isOverlap = true; //true: overlap, false: split var isTest = true; /* var bannerAdUnit; var interstitialAdUnit; var isOverlap = true; //true: overlap, false: split var isTest = true; //android if (navigator.userAgent.match(/Android/i)) { bannerAdUnit = "REPLACE_THIS_WITH_YOUR_BANNER_AD_UNIT"; interstitialAdUnit = "REPLACE_THIS_WITH_YOUR_INTERSTITIAL_AD_UNIT"; rewardedVideoAdUnit = "REPLACE_THIS_WITH_YOUR_REWARDED_VIDEO_AD_UNIT"; } //ios else if (navigator.userAgent.match(/iPhone/i) || navigator.userAgent.match(/iPad/i)) { bannerAdUnit = "REPLACE_THIS_WITH_YOUR_BANNER_AD_UNIT"; interstitialAdUnit = "REPLACE_THIS_WITH_YOUR_INTERSTITIAL_AD_UNIT"; rewardedVideoAdUnit = "REPLACE_THIS_WITH_YOUR_REWARDED_VIDEO_AD_UNIT"; } //wp8 else if( navigator.userAgent.match(/Windows Phone/i) ) { bannerAdUnit = "REPLACE_THIS_WITH_YOUR_BANNER_AD_UNIT"; interstitialAdUnit = "REPLACE_THIS_WITH_YOUR_INTERSTITIAL_AD_UNIT"; rewardedVideoAdUnit = "REPLACE_THIS_WITH_YOUR_REWARDED_VIDEO_AD_UNIT"; } */ ios submit for review survey
document.addEventListener("deviceready", function(){ //if no license key, 2% ad traffic share for dev support. //you can get paid license key: https://cranberrygame.github.io/request_cordova_ad_plugin_paid_license_key //window.admob.setLicenseKey("yourEmailId@yourEmaildDamin.com", "yourLicenseKey");
window.admob.setUp(bannerAdUnit, interstitialAdUnit, rewardedVideoAdUnit, isOverlap, isTest);
//
window.admob.onBannerAdPreloaded = function() {
alert('onBannerAdPreloaded');
};
window.admob.onBannerAdLoaded = function() {
alert('onBannerAdLoaded');
};
window.admob.onBannerAdShown = function() {
alert('onBannerAdShown');
};
window.admob.onBannerAdHidden = function() {
alert('onBannerAdHidden');
};
//
window.admob.onInterstitialAdPreloaded = function() {
alert('onInterstitialAdPreloaded');
};
window.admob.onInterstitialAdLoaded = function() {
alert('onInterstitialAdLoaded');
};
window.admob.onInterstitialAdShown = function() {
alert('onInterstitialAdShown');
};
window.admob.onInterstitialAdHidden = function() {
alert('onInterstitialAdHidden');
};
//
window.admob.onRewardedVideoAdPreloaded = function() {
alert('onRewardedVideoAdPreloaded');
};
window.admob.onRewardedVideoAdLoaded = function() {
alert('onRewardedVideoAdLoaded');
};
window.admob.onRewardedVideoAdShown = function() {
alert('onRewardedVideoAdShown');
};
window.admob.onRewardedVideoAdHidden = function() {
alert('onRewardedVideoAdHidden');
};
window.admob.onRewardedVideoAdCompleted = function() {
alert('onRewardedVideoAdCompleted');
};
}, false);
window.admob.preloadBannerAd();//option, download ad previously for fast show /* position: 'top-left', 'top-center', 'top-right', 'left', 'center', 'right', 'bottom-left', 'bottom-center', 'bottom-right' size: 'BANNER' (320x50, Phones and Tablets) 'LARGE_BANNER' (320x100, Phones and Tablets) 'MEDIUM_RECTANGLE' (300x250, Phones and Tablets) 'FULL_BANNER' (468x60, Tablets) 'LEADERBOARD' (728x90, Tablets) 'SKYSCRAPER' (120x600, Tablets, ipad only) 'SMART_BANNER' (Auto size, Phones and Tablets, recommended) */ window.admob.showBannerAd('top-center', 'SMART_BANNER'); window.admob.showBannerAd('bottom-center', 'SMART_BANNER'); window.admob.reloadBannerAd(); window.admob.hideBannerAd();
window.admob.preloadInterstitialAd();//option, download ad previously for fast show window.admob.showInterstitialAd();
window.admob.preloadRewardedVideoAd();//option, download ad previously for fast show window.admob.showRewardedVideoAd();
alert(window.admob.loadedBannerAd());//boolean: true or false alert(window.admob.loadedInterstitialAd());//boolean: true or false alert(window.admob.loadedRewardedVideoAd());//boolean: true or false
alert(window.admob.isShowingBannerAd());//boolean: true or false alert(window.admob.isShowingInterstitialAd());//boolean: true or false alert(window.admob.isShowingRewardedVideoAd());//boolean: true or false
# Examples #
<a href="https://github.com/cranberrygame/cordova-plugin-ad-admob/blob/master/example/basic/index.html">example/basic/index.html</a><br>
<a href="https://github.com/cranberrygame/cordova-plugin-ad-admob/blob/master/example/advanced/index.html">example/advanced/index.html</a><br>
<a href="https://github.com/cranberrygame/cordova-plugin-ad-admob/blob/master/example/basic_wp8/index.html">example/basic_wp8/index.html</a><br>
<a href="https://github.com/cranberrygame/cordova-plugin-ad-admob/blob/master/example/advanced_wp8/index.html">example/advanced_wp8/index.html</a>
# Test #
[![](http://img.youtube.com/vi/xXrVb8E8gMM/0.jpg)](https://www.youtube.com/watch?v=xXrVb8E8gMM&feature=youtu.be "Youtube")
You can also run following test apk.
https://dl.dropboxusercontent.com/u/186681453/pluginsforcordova/admob/apk.html
# Useful links #
Cordova Plugins<br>
http://cranberrygame.github.io?referrer=github
# Credits #