Kongregate Advertising API

Kongregate's Advertising API allows you to request and display interstitial ads during pauses in gameplay. The ads are incentivized with in-game rewards, which increases engagement and revenue.

The Advertising API is available via the AS3 and Javascript interfaces.

Overview

The advertising API can be accessed via the mtx object on the Kongregate API. Once initialized, events will be generated to notify your application about the availability of advertisements, the state of any ad being displayed, and whether or not in-game rewards should be given.

Initializing

Once your game is ready to display ads, you can set up your event listeners for various events and then call kongregate.mtx.initializeIncentivizedAds(). The initializeIncentivizedAds() function only needs to be called once.

kongregate.mtx.addEventListener("adsAvailable", function(e:Event):void{
  // Ads are now available, calls to kongregate.mtx.showIncentivizedAd() will work
});

kongregate.mtx.addEventListener("adsUnavailable", function(e:Event):void{
  // Ads are no longer available, calls to kongregate.mtx.showIncentivizedAd() will fail
});

kongregate.mtx.addEventListener("adOpened", function(e:Event):void{
  // An ad is being displayed
});

kongregate.mtx.addEventListener("adCompleted", function(e:Event):void{
  // An ad has completed successfully, and the player should be rewarded
});

kongregate.mtx.addEventListener("adAbandoned", function(e:Event):void{
  // Ad ad has been closed before completion, the player should not be rewarded
});

kongregate.mtx.initializeIncentivizedAds();

Displaying Incentivized Ads