cordova-plugin-admob

---

This is the AdMob Cordova Plugin for Android and iOS. It provides a way to request AdMob ads natively from JavaScript.

This plugin was originally written and tested with the Google AdMob SDK version 6.4.0 for iOS, and Cordova 2.5.0.

It's now updated and enhanced to support:

• Cordova 3.0, 3.5.

Platform SDK supported:

• AdMob SDK for iOS, v6.8.4 (deprecated), v6.9.3 (SDK included)
• AdMob SDK for Android, v6.4.1 (deprecated)
• Google Play Service for Android, v4.4 (replacing AdMob SDK for Android)
• AdMob SDK for Windows Phone 8, v6.5.11 (newly added, and SDK included)

See Also

---

Besides using Google AdMob, you have some other options, all working on cordova:

• cordova-plugin-iad, Apple iAd service.
• cordova-plugin-flurry, Flurry Ads service.

How to use?

---

To install this plugin, follow the Command-line Interface Guide.

cordova plugin add https://github.com/MobileChromeApps/google-play-services.git
cordova plugin add https://github.com/floatinghotpot/cordova-plugin-admob.git

Note: ensure you have a proper AdMob account and create an Id for your app.

Quick example with cordova command line tool

---

cordova create testadmob com.rjfun.testadmob TestAdmob
cd testadmob
cordova platform add android
cordova platform add ios
cordova plugin add https://github.com/MobileChromeApps/google-play-services.git
cordova plugin add https://github.com/floatinghotpot/cordova-plugin-admob.git
mv www www.default
mkdir www
cp plugins/com.rjfun.cordova.plugin.admob/test/index.html www/
cordova build
... cordova emulate android/ios, or import the android project into eclipse or ios project into xcode

Or, just clone the testadmob project from github:

git clone [email protected]:floatinghotpot/testadmob.git

Example javascript

---

Call the following code inside onDeviceReady(), because only after device ready you will have the plugin working.

var admob_ios_key = 'ca-app-pub-6869992474017983/4806197152';
var admob_android_key = 'ca-app-pub-6869992474017983/9375997553';
var adId = (navigator.userAgent.indexOf('Android') >=0) ? admob_android_key : admob_ios_key;
    
if( window.plugins && window.plugins.AdMob ) {
    var am = window.plugins.AdMob;

    am.createBannerView( 
        {
        'publisherId': adId,
        'adSize': am.AD_SIZE.BANNER,
        'bannerAtTop': false,
        'overlap': false
        }, 
        function() {
    	    am.requestAd(
    		    { 'isTesting':true }, 
        		function(){
        			am.showAd( true );
        		}, 
        		function(){ alert('failed to request ad'); }
        	);
        }, 
        function(){ alert('failed to create banner view'); }
    );
    
    am.createInterstitialView(
          {
              'publisherId': adId
          },
          function() {
              am.requestInterstitialAd( { 'isTesting':true }, function() {}, function() { alert('failed to request ad'); });
          },
          function() {
              alert("Interstitial failed");
          }
      );
    
} else {
  alert('AdMob plugin not available/ready.');
}

More ...

---

This plugin also allows you the option to listen for ad events. The following events are supported:

	// more callback to handle Ad events
	document.addEventListener('onReceiveAd', function(){
	});
	document.addEventListener('onFailedToReceiveAd', function(data){
		// alert( data.error );
	});
	document.addEventListener('onPresentAd', function(){
	});
	document.addEventListener('onDismissAd', function(){
	});
	document.addEventListener('onLeaveToAd', function(){
	});   

See the working example code in demo under test folder, and here are some screenshots.

Screenshots (banner Ad / interstitial Ad)

---

iPhone:

iPad, landscape:

Android:

Donate

---

You can use this cordova plugin for free.

To support this project, donation is welcome.

Donation can be accepted in either of following ways:

• Keep the donation code to share 2% Ad traffic. (Just remove it, if you don't hope so)
• Donate directly via Paypal