@ironsource-plus/cordova-plugin

IronSource Ads Cordova Plugin

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

History

This is a fork of cordova-plugin-ironSource. It aims to be kept up to date as well as enable ad mediation. It is planned to be a drop-in replacement and will retain the same api of that plugin.

Currently supports ironSource 8.3.0 (for both iOS and Android)

How do I install it?

Install using cordova:

cordova plugin add @ironsource-plus/cordova-plugin

How do I use it?

First, you'll need to construct a new instance of the plugin using new IronSourceAds.

The constructor can take 2-4 arguments. The first one is your AppKey from IronSource. The second is a user Identifier. This can be anything and is described in the IronSource docs.

The last two are optional. A callback to be ran after the plugin is initialized and true/false to enable the test suite (default false);

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

	var isAds = new IronSourceAds("app_key", "some_unique_userid", function(){console.log('Init has finished');}, false);

	// show a rewarded ad
	isAds.showRewardedAd();

	// show a rewarded ad for placement RightHere
	isAds.showRewardedAd("RightHere");

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

	// reward your users
	window.addEventListener("onRewardedVideoAdClosed", function(e) {

		var placement = e.placement;
		console.log(placement.placementName);
		console.log(placement.rewardName);
		console.log(placement.rewardAmount);
	}, false);

}, false);

Can I just see a working example?

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

What events are supported?

Interstitial

• onInterstitialAdClicked
• onInterstitialAdClosed
• onInterstitialAdLoadFailed
• onInterstitialAdOpened
• onInterstitialAdReady
• onInterstitialAdShowFailed
• onInterstitialAdShowSucceeded

Rewarded Video

• onRewardedVideoAdClosed
• onRewardedVideoAdOpened
• onRewardedVideoAdRewarded
• onRewardedVideoAdShowFailed
• onRewardedVideoAvailabilityChanged
• onRewardedVideoAdClicked