Updating Your Adobe Air Plugin

To update your Adobe Air Plugin from 6.4 and below to the latest Plugin version, follow these 4 easy steps:

1. Download the ironSource Adobe Air ANE
2. Update Additional Settings for Android
3. Update SDK Methods
4. Update Events

Step 1. Download the IronSource Adobe Air ANE

First you will need to remove your integrated Adobe Air ANE from your Native Extensions.

Then add the the latest version of the Adobe Air ANE:

1. Download the Adobe Air ANE here.
2. In Flash Builder, right click your project and go to Properties ➣ Flex Build Path ➣ Native Extensions.
3. Click “Add ANE…” and add the ironSource Air Plugin ANE file.
4. Right click on your project and go to Properties ➣ Flex Build Packaging ➣ Android/iOS ➣ Native Extensions and make sure that the ironSource Air Plugin ANE file is marked as “Package”.

Step 2. Update Additional Settings for Android

1. Update your Manifest Activities on your AndroidManifest.xml
   Replace the Supersonic Manifest Activities
   

   <activity
      android:name="com.supersonicads.sdk.controller.ControllerActivity"
      android:configChanges="orientation|screenSize"
      android:hardwareAccelerated="true" />
   <activity
      android:name="com.supersonicads.sdk.controller.InterstitialActivity"
      android:configChanges="orientation|screenSize"
      android:hardwareAccelerated="true"
      android:theme="@android:style/Theme.Translucent" />
   <activity
      android:name="com.supersonicads.sdk.controller.OpenUrlActivity"
      android:configChanges="orientation|screenSize"
      android:hardwareAccelerated="true"
      android:theme="@android:style/Theme.Translucent" />
   Light theme
   Dark theme
   Copy to clipboard

   With the ironSource Manifest Activities:

   <activity
      android:name=“com.ironsource.sdk.controller.ControllerActivity”
      android:configChanges=“orientation|screenSize”
      android:hardwareAccelerated=“true” />
   <activity                       
      android:name=“com.ironsource.sdk.controller.InterstitialActivity”
      android:configChanges=“orientation|screenSize”
      android:hardwareAccelerated=“true”
      android:theme=“@android:style/Theme.Translucent” />
   <activity                        
      android:name=“com.ironsource.sdk.controller.OpenUrlActivity”
      android:configChanges=“orientation|screenSize”
      android:hardwareAccelerated=“true”
      android:theme=“@android:style/Theme.Translucent” />
   Light theme
   Dark theme
   Copy to clipboard

Step 3. Update SDK Methods

We’ve standardized and updated all of our methods according to tech conventions, and replaced all Supersonic mentions with ironSource. In addition, you can now initialize your preferred ad units with a single init, preferably on application launch.

You’ll need to review, remove and replace existing methods with the following:

General Methods (relevant for All Ad Units):

• New! setUserId
  The UserID is a unique identifier for each user. You can set the userID parameter, or let us generate one for you. If you’re serving the Offerwall ad unit or server-to-server callbacks to reward your users with our rewarded ad units, you must set the UserID. Common practice is to use the GAID (Google Advertiser ID).
  
  Note: Note: You must set the UserID parameter before the init request.

  IronSource.instance.setUserId(YOUR_USER_ID);
  Light theme
  Dark theme
  Copy to clipboard

Ad Unit Initialization

Remove the init function from each ad unit:

• Rewarded Video
  

  Supersonic.instance.initRewardedVideo("YOUR_APPLICATION_KEY", "USER_UNIQUE_ID");
  Light theme
  Dark theme
  Copy to clipboard

• Offerwall

• Supersonic.instance.initOfferwall("YOUR_APPLICATION_KEY", "USER_UNIQUE_ID");
  Light theme
  Dark theme
  Copy to clipboard

• Interstitial
  

  Supersonic.instance.initInterstitial("YOUR_APPLICATION_KEY", "USER_UNIQUE_ID");
  Light theme
  Dark theme
  Copy to clipboard

Replace the init function with the following:

New!  The new SDK 6.6 initializes all the relevant ad units based on the configurations you set up in the platform, instead of you initializing each ad unit separately.

You can initialize the SDK in two ways. We recommend the first method as it will fetch the specific ad units you define.

Init the specific ad units mentioned in the adUnits parameter, preferably on app launch:

IronSource.instance.init(YOUR_APP_KEY, [IronSource.REWARDED_VIDEO, IronSource.INTERSTITIAL, IronSource.OFFERWALL]);
Light theme
Dark theme
Copy to clipboard

Init the ad units you’ve configured on the ironSource platform SDK sync:

IronSource.instance.init(YOUR_APP_KEY);
Light theme
Dark theme
Copy to clipboard

Ad Unit Methods

• Rewarded Video
  Remove the Supersonic functions:

  Supersonic.instance.isRewardedVideoAvailable();
  Supersonic.instance.showRewardedVideo();
  Supersonic.instance.showRewardedVideo(YOUR_PLACEMENT_NAME);
  Supersonic.instance.getRewardedVideoPlacementInfo(YOUR_PLACEMENT_NAME);
  Light theme
  Dark theme
  Copy to clipboard

  Replace them with the new IronSource functions:

  IronSource.instance.isRewardedVideoAvailable()
  IronSource.instance.showRewardedVideo();
  IronSource.instance.showRewardedVideo(YOUR_PLACEMENT_NAME);
  IronSource.instance.getRewardedVideoPlacementInfo(YOUR_PLACEMENT_NAME);
  Light theme
  Dark theme
  Copy to clipboard

• Offerwall
  Remove the Supersonic functions:

  Supersonic.instance.showOfferwall();
  Supersonic.instance.getOfferwallCredits();
  Light theme
  Dark theme
  Copy to clipboard

  Replace them with the new IronSource functions:

  IronSource.instance.showOfferwall();
  IronSource.instance.getOfferwallCredits();
  Light theme
  Dark theme
  Copy to clipboard

• Interstitial
  Remove the Supersonic functions:

  Supersonic.instance.loadInterstitial();
  Supersonic.instance.showInterstitial();
  Supersonic.instance.showInterstitial(YOUR_PLACEMENT_NAME);
  Light theme
  Dark theme
  Copy to clipboard

  Replace them with the new IronSource functions:

  IronSource.instance.loadInterstitial();
  IronSource.instance.showInterstitial();
  IronSource.instance.showInterstitial(YOUR_PLACEMENT_NAME);
  Light theme
  Dark theme
  Copy to clipboard

Step 4. Update the Events

The ironSource Adobe Air Plugin fires several events to inform you of the ad unit activity. Replace the existing events with the following:

• Rewarded Video

  IronSource.instance.addEventListener(“onRewardedVideoAdOpened”, onRewardedVideoAdOpened);
  IronSource.instance.addEventListener(“onRewardedVideoAdClosed”, onRewardedVideoAdClosed);               IronSource.instance.addEventListener(“onRewardedVideoAvailabilityChanged”, onRewardedVideoAvailabilityChanged);                IronSource.instance.addEventListener(“onRewardedVideoAdStarted”, onRewardedVideoAdStarted);               IronSource.instance.addEventListener(“onRewardedVideoAdEnded”, onRewardedVideoAdEnded);               IronSource.instance.addEventListener(“onRewardedVideoAdRewarded”, onRewardedVideoAdRewarded);                IronSource.instance.addEventListener(“onRewardedVideoAdShowFailed”, onRewardedVideoAdShowFailed);
  Light theme
  Dark theme
  Copy to clipboard

• Offerwall

  IronSource.instance.addEventListener(“onOfferwallAvailable”, onOfferwallAvailable);
  IronSource.instance.addEventListener(“onOfferwallOpened”, onOfferwallOpened);
  IronSource.instance.addEventListener(“onOfferwallShowFailed”, onOfferwallShowFailed);
  IronSource.instance.addEventListener(“onOfferwallAdCredited”, onOfferwallAdCredited);                IronSource.instance.addEventListener(“onGetOfferwallCreditsFailed”, onGetOfferwallCreditsFailed);
  IronSource.instance.addEventListener(“onOfferwallClosed”, onOfferwallClosed);
  Light theme
  Dark theme
  Copy to clipboard

• Interstitial

  IronSource.instance.addEventListener(“onInterstitialAdReady”, onInterstitialAdReady);
  IronSource.instance.addEventListener(“onInterstitialAdLoadFailed”, onInterstitialAdLoadFailed);
  IronSource.instance.addEventListener(“onInterstitialAdOpened”, onInterstitialAdOpened);
  IronSource.instance.addEventListener(“onInterstitialAdClosed”, onInterstitialAdClosed);              IronSource.instance.addEventListener(“onInterstitialAdShowSucceeded”, onInterstitialAdShowSucceeded);                IronSource.instance.addEventListener(“onInterstitialAdShowFailed”, onInterstitialAdShowFailed);
  IronSource.instance.addEventListener(“onInterstitialAdClicked”, onInterstitialAdClicked);
  Light theme
  Dark theme
  Copy to clipboard

Done!
You are now ready to start working with ironSource’s Ad Units and Mediation Tools.