Getting Started with the ironSource Adobe Air Plugin

To begin monetizing your application with the ironSource SDK, follow these 4 easy steps:

  1. Add the ironSource AIR Plugin to Your Project
  2. SDK Imports
  3. Update AndroidManifest.xml & Google Play Services (Android Only)
  4. Apply iOS9 App Transport Security Settings (iOS Only)
  5. Verify Your Integration

Before You Start

Adobe 4.0+ and the AIR SDK 23.0 are required to be able to use the ironSource SDKIf you are using Flash Builder, you’ll need to download Air SDK 23.0 and overlay it into Flash Builder.
We support Adobe 4.0+ and Air SDK 23.0 on Android operating systems versions 3.0 (API 11) and up as well as iOS versions 7.0 and up.

Step 1. Add the ironSource AIR Plugin to your Project

Note: Note:
  • Make sure you have integrated the latest version of our Adobe Air Plugin. Find it here.
  • If you are upgrading from a previous version of the ironSource SDK, you must completely remove it from your project, otherwise it will cause issues with the update. We also recommend erasing older builds from test devices and making a new build.

Download the ironSource AIR ANE and then complete the following steps to include it in your project:

  1. In Flash Builder, right click your project and go to Properties ➣ Flex Build Path  Native Extensions.
  2. Click “Add ANE...” and add the ironSource Air Plugin ANE file unzipped previously.
  3. 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”.
Note: Note:
If you are using Flash Professional in your project, go to:
File ➣ ActionScript SettingsLibrary Path and add ironSource’s Air Plugin ANE file.

Step 2. Add onPause/onResume & SDK Imports

  1. During the Flex Application Lifecycle, listen for application activation and deactivation by adding onResume and onPause on the top of the file where you define all of the properties:
    activate= "onResume()" deactivate="onPause()"
    1. Implement the two functions as follows:
      function onResume():void {
        Supersonic.instance.onResume(); 
      }
      function onPause():void {
        Supersonic.instance.onPause(); 
      }

      You should call onPause/onResume each time the app is activated or deactivated.

  2. Import the following in your scripts to use the ironSource SDK:
com.supersonic.adobeair.Supersonic

Step 3. Update AndroidManifest.xml & Google Play Services (For Android Only)

To use the ironSource SDK on Android, add relevant code to the AndroidManifest.xml and integrate Google Play Services:

  1. Add the following to your AndroidManifest.xml:
    • Manifest Permissions:
      Add the following permissions to your Application Descriptor.xml file inside the manifestAdditions tag but outside the <application> tag:
      <uses-permission android:name="android.permission.INTERNET" />
      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    • Manifest Activities:
      Add the following activities inside the <application> tag on your manifestAdditions:
      <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" />
    • Google Play Services
      The ironSource Plugin requires Google Play Services to make use of the Android Advertising Identifier. The easiest way to do this is to include ironSource’s Google play services ANE. Make sure to add Google Play Services info to your manifestAdditions:
      <meta-data android:name="com.google.android.gms.version"
      android:value="@integer/google_play_services_version" />

Step 4. Apply iOS9 App Transport Security Settings (iOS Only)

Important! In iOS9, Apple has added in controls around ‘ATS’. In order to ensure uninterrupted support for ironSource Ad delivery across all Mediation Networks, it’s important to make the following changes in your info.plist:

  1. Add in a dictionary called ‘NSAppTransportSecurity‘. Make sure you add this dictionary on the ‘Top Level Key‘.
  2. Inside this dictionary, add a Boolean called ‘NSAllowsArbitraryLoads‘ and set it to YES.
    Supersonic iOS9 ATS Support
    Note: Note: Make sure that your info.plist does not contain any other exceptions besides ‘NSAllowsArbitraryLoads‘, as this might create a conflict.

Step 5. Verify Your Integration

The ironSource SDK provides an easy way to verify that your Rewarded Video Mediation integration was completed successfully. To verify your ironSource SDK integration as well as any additional Ad Networks you may have implemented, navigate to this article.

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


What’s Next?

Once you’ve verified your integration with the Integration Helper, follow our integration guides and implement our Ad Units:

Interested in Mediation? Integrate our Rewarded Video or Interstitial Ads in your app and follow our Mediation Docs.