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 written and tested with the Google AdMob SDK version 6.4.0 for iOS, and Cordova 2.5.0.

Now, it's port to Cordova 3.0.0, and tested pass.

How to use?

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

It's recommended to use cordova command line tool:

cordova plugin add https://github.com/floatinghotpot/cordova-plugin-admob.git

For different platforms, please refer to the corresponding README files for Android/iOS.

And, of course, 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
... copy the test/index.html to your www/
cordova prepare
... cordova build, or import the android project into eclipse or ios project into xcode

Or, just clone the testadmob project from github:

git clone git@github.com:floatinghotpot/testadmob.git

Example javascript

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

if( window.plugins && window.plugins.AdMob ) {
	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;
    var am = window.plugins.AdMob;

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

More ...

Add more callback functions to handle success/failure events:

	// 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(){
	});