Skip to content

tedyk/cordova-plugin-amazonmobileads

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Amazon Ads Cordova Plugin

Add support for Amazon Mobile Ads to your Cordova and Phonegap based mobile apps.

How do I install it?

  • If you're like me and using CLI:
cordova plugin add https://github.com/blakgeek/cordova-plugin-amazonmobileads

or

phonegap local plugin add https://github.com/blakgeek/cordova-plugin-amazonmobileads

WARNING: iOS Cordova Registry

Installing this plugin directly from Cordova Registry results in Xcode using a broken AmazonAd.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 AmazonAd.framework manually.

How do I use it?

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

	window.amazonads = new AmazonMobileAds();

	// get things started by passing in your app key
	amazonads.init('<your app key>', 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
	amazonads.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
	amazonads.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
	amazonads.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
	amazonads.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
    amazonads.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
	amazonads.claimBannerAdSpace(false);

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

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

	// enable test mode without ads
	amazonads.enableTestMode(function() {
		console.log('testing 1 2 1 2');
	}, function(err) {
		console.error('this will never ever happen');
	});

	// enable test mode without ads
	amazonads.disableTestMode(function() {
		console.log('shit just got real');
	}, function(err) {
		console.error('this will never ever happen');
	});

	// enable test mode without ads
	amazonads.enableLogging(function() {
		console.log('messages are being logged');
	}, function(err) {
		console.error('this will never ever happen');
	});

	// enable test mode without ads
	amazonads.enableTestMode(function() {
		console.log('no mo loggin');
	}, function(err) {
		console.error('this will never ever happen');
	});
}, false);

For complete working example checkout the demo project

About

Add Amazon Mobile Ad support to Cordova apps.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 78.8%
  • Java 17.3%
  • JavaScript 3.9%