ONE by AOL: Mobile Integration Guide for SDK 6.4 and Below

This guide will instruct you step-by-step on how to set ONE by AOL: Mobile live as an Ad Network on the Unity LevelPlay. The integration process is completed in a few simple steps:

  1. Create an ONE by AOL: Mobile Account
  2. Create an Application and Ad Zone in ONE by AOL: Mobile
  3. Activate ONE by AOL: Mobile in Your ironSource Network Setup Module
  4. Add the ONE by AOL: Mobile Adapter to Your Build
  5. Update AndroidManifest.xml
Before You Start
  • Make sure you have correctly integrated ironSource’s Interstitial into your application.
  • The ONE by OAL adapter requires Android version 4.1 and up (API level 16+).

Step 1. Create a ONE by AOL: Mobile Account

Create an account with ONE by AOL: Mobile Media by signing up here. You’ll have to provide your company and country. ONE by AOL: Mobile will verify your information and will send you a confirmation email once your account has been enabled.  Once your account has been verified, you can log in as a new customer here.

If you already have an account with this ad network, log into your dashboard here.

Step 2. Create an Application and Ad Zone in ONE by AOL: Mobile

To gain access to ONE by AOL: Mobile’s inventory within Unity LevelPlay, you must first add your app and set up placements on your ONE by AOL: Mobile account.

  1. New User: Add Your App and Placement
    1. Go to the main dashboard: in the left side menu, go to Dashboard Applications and Sites.
      ironsource-mediation-millenial-media-1
    2. In the ‘Applications and Sites‘ tab, click on the  ‘+‘ to add your app.
      ironsource-mediation-millenial-media
    3. Define your app’s platform and then fill in its name, URL, App Store ID, Domain as well as the relevant devices and app category.  Click ‘Save and Add Placement‘.
      ironsource-mediation-millenial-media
    4. Add Interstitial Placement: If you completed the above steps successfully, the below window will appear and you’ll need to define the following:
      1. Placement Type: Interstitial
      2. Placement Name: Enter a placement name that is intuitive for this placement
      3. Allowed Ad Formats: Leave Static Images and Video checked
      4. Ad Size: Keep the default size
        Note: Note: Reserve Placement ID for later use on the ironSource platform.
        ironsource-mediation-millennial-media-placement-details
  2. Existing User: Add Placement to App  
    1. If you already added your app to ONE by AOL: Mobile, define a placement for the app you’d like to serve ONE by AOL: Mobile’s ads with through the ironSource. Go to the relevant app on the main dashboard (Dashboard Applications and Sites) and then in the far right column click on the set of dots and select ‘+Add Placement‘.
      ironsource-mediation-millennial-media-add-placements
    2. The following popup will appear. Enter a name for this placement, select Interstitial and leave the boxes checked under Allowed Ad Formats and the default size under Ad Size. Then select ‘Save & Monetize‘.
      Note: Note: Reserve Placement ID for later use on the ironSource platform.

      ironsource-mediation-millenial-placement-details

Step 3. Activate ONE by AOL: Mobile in Your ironSource Network Setup Module

There are a few parameters from your ONE by AOL: Mobile account which need to be inserted into your ironSource Network Setup Module in order for ONE by AOL: Mobile to work correctly in connection with ironSource:

Company ID This is the unique identifier of your company in ONE by AOL: Mobile’s system.
Access Key This is the unique identifier of your ONE by AOL: Mobile account.
Secret Key This is the unique identifier that specifies the relationship between your account and the ad unit set up on the ONE by AOL: Mobile dashboard.
Site/App ID This is the unique identifier of your application in ONE by AOL: Mobile’s system.
Placement ID This is the unique placement to which ONE by AOL: Mobile will deliver ads to through Unity LevelPlay.

These are the parameters from the ONE by AOL: Mobile dashboard that you’ll need to add to the ironSource platform in order to activate the ad network.

  1. Company ID, Access Key and Secret Key
    On the left menubar, go to Account Settings Reporting Credentials. You will find all three parameters on the Reporting Credentials page.
    ironsource-mediation-millennial-media-reporting-creds
  2. Site/App ID and Placement ID
    On the left menu bar, go to Dashboard Applications and Sites.
    ironsource-mediation-millenial-media-1Click on relevant app and you will see the placement you configured to run on Unity LevelPlay.
    Select the placement name and you will be directed to a page with the placement details.
    ironsource-mediation-mm-site-placement-id
    On the top of the page you will see the SiteID and on the left side, you will see the Placement ID.
    ironsource-mediation-mm-siteid-and-placement-id

Once you obtain this information, you must configure ONE by AOL: Mobile’s parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of ONE by AOL: Mobile’s ad inventory and reporting data on the ironSource platform.

  • Once you have all of these parameters, log in to your ironSource account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘SDK Networks
    ironsource-mediation-platform-navigate-sdk-networks
  • Select Millennial Media (ONE by AOL: Mobile) from the list of Available Ad Networks and enter the ‘Company ID’, ‘Company Access Key‘ and ‘Secret Key‘. Click ‘Save‘.
    ironsource-mediation-platform-mm-account-settings
  • Millennial Media (ONE by AOL: Mobile) will then be enabled in the Available Ad Networks table.
    ironsource-mediation-mm-activated
  • Make sure to define the app on which you’d like to run interstitial ads from ONE by AOL: Mobile through Unity LevelPlay. Go to the Millennial Media row on the Setup list of Ad Networks and click on the ‘Define‘ icon.
    ironsource-platform-mm-define-ad-networks
  • Insert the Application/Site ID‘ and the ‘Placement ID in the relevant fields. Set status to Active and click ‘Save’.
    ironsource-mediation-platform-app-settings
  • You will then see Millennial Media (ONE by AOL: Mobile) as Active for Interstitial on your Setup list.
    ironsource-mediation-platform-mm-activated
  • New! Verify your integration with the Reporting API; this column will check your integration through the Reporting API and return three possible responses: Verified, Failed and No Response. Double check your integration and the information you entered above; then click ‘Retry‘ until you see ‘Verified’.

Step 4. Add the ONE by AOL: Mobile Adapter to Your Build

Android

 ironSource supports both Gradle dependencies and manual download mechanisms.

Gradle:

  1. Make sure the following Maven URL exist in your build.gradle script of your app module (should appear only once for all the adapters). Add the adapter’s Maven name to your build.gradle script of your app module.
    repositories {
        maven {
            url "https://millennialmedia.bintray.com/Millennialmedia"
        }
        maven {
            url "https://dl.bintray.com/supersonic/android-adapters"
        }
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    dependencies {                                                                                          compile 'com.supersonic.adapters:millennialmediaadapter:2.1.0@jar'
    }

Manual download:

  1. Download the ONE by AOL: Mobile Adapter:
    Add the ONE by AOL: Mobile Adapter to your build. You can find the latest ONE by AOL: Mobile Adapter here.
    Important! The ONE by AOL: MobileAdapter also contains the ONE by AOL: Mobile jar. You don’t need to additionally add the ONE by AOL: Mobile jar directly.
  2. Add the ONE by AOL: Mobile Adapter to your Project:
    After you download the adapter; drop the MillennialMediaAdapter jar into the libs folder in your Android Project.
  3. Make sure you add the following to your Gradle build file under the dependencies section:
    compile fileTree(dir: 'libs', include: ['*.jar'])
  4. Download the ONE by AOL .AAR file
    1. If using Eclipse: Import the .AAR file as a library project.
    2. If using Android Studio: Download the .AAR file and add as a dependency to your own module.
      In Android Studio go to File ➣ New ➣ New Module ➣ Import .AAR and navigate to the location where the  .AAR file has been downloaded.
      android-studio-aar-integration

Step 5. Update AndroidManifest.xml

 Manifest Permissions
Add the following permissions before the <application> tag on your manifest:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission-sdk-23 android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="22"/>
<uses-permission android:name="android.permission.WRITE_CALENDAR"/>
<uses-permission android:name="android.permission.NFC"/>
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.VIBRATE"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>

Verify Your Ad-Network Integration

The ironSource SDK provides an easy way to verify that your mediation integration was completed successfully. To verify your ironSource and any additional Ad Networks’ integration, follow this document.

Done!
You are now all set to deliver ONE by AOL: Mobile Ads within your application!


What’s Next?

To add additional Ad networks, follow the integration guides on our Supported Ad Networks list.