IronSource Ads Cordova Plugin

![Greenkeeper badge](https://greenkeeper.io/)

Add support for IronSource 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 cordova-plugin-ironsource`

or

`cordova plugin add https://github.com/blakgeek/cordova-plugin-ironSource`

or

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

`How do I use it? ##`

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

var isAds = new IronSourceAds("yo_app_key", "some_unique_userid"); // show a rewarded ad isAds.showRewardedAd(); // show a rewarded ad for placement RightHere isAds.showRewardedAd("RightHere"); // show an offerwall isAds.showOfferWall(); // show an interstitial isAds.showInterstitial();

// launch in Android Studio/Xcode mediation integration verification isAds.validateIntegration();

// Check is a rewarded video is available to show isAds.isRewardedVideoAvailable(function () { alert('Yes'); }, function () { alert('No'); });

// Check is an interstitial is available to show isAds.isInterstitialAdAvailable(function () { alert('Yes'); }, function () { alert('No'); }); // give em some credit window.addEventListener("offerwallCreditReceived", function(e) { var credit = e.credit; // The number of credits the user has earned. console.log(credit.amount); // The total number of credits ever earned by the user. console.log(credit.total): // estimated flag is the same as totalCreditsFlag // In some cases, we won’t be able to provide the exact // amount of credits since the last event (specifically if the user clears // the app’s data). In this case the ‘credits’ will be equal to the ‘totalCredits’, // and this flag will be ‘true’. console.log(credit.estimated); }, false); // reward your users window.addEventListener("rewardedVideoRewardReceived", function(e) { var placement = e.placement; console.log(placement.id); // only available on android console.log(placement.name); console.log(placement.reward); console.log(placement.amount); }, false); }, false);``

Can I just see a working example?

Yep. Check out the demo project. It runs on both Android and iOS.

What other events are supported?

$3

1. interstitialInitialized
1. interstitialInitializationFailed
1. interstitialAvailabilityChanged
1. interstitialShown
1. interstitialShowFailed
1. interstitialClicked
1. interstitialClosed

$3

1. offerwallClosed
1. offerwallCreditFailed
1. offerwallCreditReceived
1. offerwallShowFailed
1. offerwallOpened
1. offerwallInitializationFailed
1. offerwallInitialized

$3

1. rewardedVideoRewardReceived
1. rewardedVideoEnded
1. rewardedVideoStarted
1. rewardedVideoAvailabilityChanged
1. rewardedVideoClosed
1. rewardedVideoOpened
1. rewardedVideoInitializationFailed
1. rewardedVideoInitialized
1. rewardedVideoFailed

How do I use it? ##

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

	var isAds = new IronSourceAds("yo_app_key", "some_unique_userid");
	
	// show a rewarded ad
	isAds.showRewardedAd();
    	
	// show a rewarded ad for placement RightHere
	isAds.showRewardedAd("RightHere");
    
	// show an offerwall
    isAds.showOfferWall();
    
    // show an interstitial
    isAds.showInterstitial();

    // launch in Android Studio/Xcode mediation integration verification
    isAds.validateIntegration();

    // Check is a rewarded video is available to show
    isAds.isRewardedVideoAvailable(function () {
    	alert('Yes');
	}, function () {
		alert('No');
	});

	// Check is an interstitial is available to show
    isAds.isInterstitialAdAvailable(function () {
    	alert('Yes');
	}, function () {
		alert('No');	
	});
    
    // give em some credit
	window.addEventListener("offerwallCreditReceived", function(e) {
	    
	    var credit = e.credit;
	    
	    // The number of credits the user has earned.
	    console.log(credit.amount);
	    
	    // The total number of credits ever earned by the user.
	    console.log(credit.total):
	    
	    // estimated flag is the same as totalCreditsFlag 
	    // In some cases, we won’t be able to provide the exact
        // amount of credits since the last event (specifically if the user clears
        // the app’s data). In this case the ‘credits’ will be equal to the ‘totalCredits’,
        // and this flag will be ‘true’.
	    console.log(credit.estimated);
	    
	}, false);
	
	// reward your users
	window.addEventListener("rewardedVideoRewardReceived", function(e) {
		
		var placement = e.placement;
		console.log(placement.id); // only available on android
		console.log(placement.name);
		console.log(placement.reward);
		console.log(placement.amount);
	}, false);
    
}, false);