RevMob Plugin For Cordova

Adds support for RevMob Ads to your Cordova and Phonegap based mobile apps. I created this because the official Phonegap/Cordova SDK from RevMob is let's say lacking and requires too many manual steps.

How do I install it?

If you're like me and using Cordova CLI:

cordova plugin add cordova-plugin-revmob

or

phonegap local plugin add cordova-plugin-revmob

TODO: add manual installation steps

WARNING: iOS Cordova Registry

Installing this plugin directly from Cordova Registry results in Xcode using a broken RevMobAds.framework, this is because the current publish procedure to NPM breaks symlinks CB-6092. Please install the plugin through through the github url or re-add the RevMobAds.framework manually.

How do I use it?

document.addEventListener('deviceready', function() {

	window.revmob = new RevMob();

	// get things started by passing in your app id
	revmob.init('<your app id>', function() {
		console.log('super dope it worked');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// show a banner at the top the screen and resize the webview to make space for it
	revmob.showBannerAd(true, true, function() {
		console.log('oh snap I got a banner at the top');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// show a banner at the bottom of the screen and overlay the webview.  overlaying is useful if the space the banner has already been accounted for
	revmob.showBannerAd(false, false, function() {
		console.log('what what see the banner at the bottom');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// hide the banner but the keep the where it was occupied
	revmob.hideBannerAd(false, function() {
		console.log('now you see me now you do not');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// hide the banner and release the space that it occupied
	revmob.hideBannerAd(true, function() {
		console.log('now you see me now you do not');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// make space at the top of the screen for a banner that will be displayed later
	// this will resize the webview
    revmob.claimBannerAdSpace(true);

	// make space at the bottom of the screen for a banenr that will be displayed later.
	// if not argument is passed it will default to making the space at the bottom
	revmob.claimBannerAdSpace(false);

    // release the space occupied the banner
    revmob.releaseBannerAdSpace();

	// show an interstitial
	revmob.showInterstitialAd(function() {
		console.log('now that is a big ole interstitial');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// show a popup ad
	revmob.showPopupAd(function() {
		console.log('pop!');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// open an ad link (useful if want to tightly integrate ads into your UI)
	revmob.openAdLink(function() {
		console.log('we ya link bredren');
	}, function(err) {
		console.error(['oh crap', err]);
	});

	// enable test mode with ads (defaults to true if no argument is passed)
	revmob.enableTestMode(true);

	// enable test mode without ads
	revmob.enableTestMode(false);

	// enable test mode without ads
	revmob.disableTestMode();

	// change the time to wait for an add to be served (value is in seconds)
	revmob.setConnectionTimeout(90);

	// spit out a bunch data about the environment
	revmob.printEnvironmentInformation();

}, false);

For a full working example see the demo project.

Enjoy!