Mediation SDK Networks Setup

ironSource mediation platform allows you to tap into the ad inventory of the industry’s leading ad networks. Once you’ve integrated the network adapter in your code, you’ll need to set up the networks on the ironSource platform.

Before you start

Step 1. Navigate to the SDK Networks Setup page

Log in to your ironSource account and go to MonetizeMediation SDK Networks Setup:ironsource-sdk-networks-setup-1

Step 2. Configure the ad network account settings

Click on Available Networks and select the ad networks you’d like to configure for ironSource mediation.

ironsource-sdk-networks-setup-2

Enter the required account information for the selected ad network. You must have an active account with this network to serve their ad inventory in your app. This data input is required so that the ad network can recognize ironSource mediation and your specific settings for the ad delivery.

Every ad network has slightly different requirements. Read the ironSource mediation guides for each ad network to learn how to find the specific data necessary for every ad network.

Configured ad networks will appear in blue:

ironsource-sdk-networks-setup-3

Step 3. Select the app intended for mediation

On the left-hand side of the Setup page you will see the list of the apps that you added to your ironSource account. Select the relevant app:

ironsource-sdk-networks-setup-4

Step 4. Set up the ad network

If you entered the data correctly in step 2, you will see the ad network in the Setup section.

  1. Select Setup for the ad network:
    ironsource-sdk-networks-setup-5
  2. You’ll see the following window. The required input differs based on the ad network.
    Enter the information for the app and the unique identifier for the ad unit you want to serve:
    ironsource-app-settings-sdk-networks-setup-6
  3. Then click Save.

Step 5. Set up additional instances (optional)

You can leverage additional ad delivery instances of AdColony, Facebook, Tapjoy, UnityAdsVungle and AppLovin. ironSource supports multiple network instances for rewarded videos and interstitials.
To set up additional instances of ironSource network, go to the Ad Units & Placements page.

Multiple placements in the waterfall for these ad networks help optimize ad revenue. You can choose to position one instance in the Manual section with an exclusive deal with the ad network, while also serving another instance of this ad network in the Auto Optimization section; thus expanding your revenue opportunities from a single network.

Add Network Instances

To set up an additional instance for the above mentioned ad networks, simply go to the ad network in the Setup table and click on the Edit icon to open the App Settings window:
ironsource-ad-networks-click-on-edit
You’ll see the Default Instance you set up in the earlier step.  To add an additional instance for this network click on + Add Network Instance:
ironsource-app-settings-sdk-networks

To add a network instance:

  1. Enter a unique name for the instance
  2. Set up a unique placement for the instance in the ad network’s dashboard. Make sure to complete all the relevant fields for each instance. The value you enter must be unique for the instance.
  3. To add multiple instances of the ironSource network, you’ll simply be required to enter a unique name for the instance.
    ironsource-app-settings-instances
  4. Click Save.

    Step 6. Activate ad delivery

    Activate the ad delivery per ad unit for each ad network by setting the toggle to ActiveIf you’re working with multiple instances, you can activate ad delivery by instance.

    Note: Apps that are not defined yet will appear grey. Once you’ve defined your app, you will see it clearly in the Applications list.

    Step 7. Verify your integration

    Reporting API Verification 

    To ensure transparency and seamless integration success with ironSource mediation partners, we’ve added a Reporting API verification column in the Setup section. Once you’ve entered all the required credentials, and completed steps 1-6 above, you can verify that the selected ad network has been correctly set up in the Reporting API. You’ll receive one of three possible responses: Verified, Failed and No Response.

    Done!

    You’ve set up your selected ad networks on your ironSource dashboard.

    Check out the best practices to most effectively manage your waterfall.