Setting Up Banners on Your Dashboard

In order to generate revenue for your app with Banner Mediation, you will have to integrate the ad unit in your code, integrate your preferred ad network adapters and activate the Banner Ad Unit. To set up the Banner ad unit on your ironSource Dashboard, follow these steps:

Step 1. Select Your App
Step 2. Add Placements, Capping & Pacing
Step 3. Integrate the Banner & Adapter in Your Code
Step 4. Test Your Integration
Step 5. Set to Live

Before You Start
To set up Banners, you’ll need to add your app to the platform. Follow this guide for instructions on how to set up your app.

Step 1. Select Your App

Once you’ve successfully added your app to your ironSource account, you’ll be able to set up our ad units on the Ad Units page under Settings. Navigate to this page, select the app you’d like to integrate the Banner Mediation on and click on the Banner tab:
ironsource-banner-mediation-setup-1

Step 2. Add Placements, Capping & Pacing

With ironSource Ad Placements, you can customize and optimize the ad experience in your app. This tool enables you to present banners to your users from different placements and customize the ad frequency. 

In the Placements section, you will see a DefaultBanner placement that you can edit and add capping and pacing settings for. In addition, you can add a placement by clicking  ‘+ Add Placement‘.

ironsource-banner-mediation-setup

Next, select the Placement Name from the list or enter a custom name and click ‘Save‘.
ironsource-banner-mediation-setup-placements

Then configure Placement Capping and Pacing to enhance the user experience in your app.

  • Placement Capping will limit the amount of ads your serve for the selected placement. You can set limitations by day or hour. As seen below, if you limit this placement to 15 impressions/day- you will only serve 15 ads for this placement per day.
    ironsource-banner-mediation-capping-settings
  • Placement Pacing offers you control over the time interval between ads for the selected placement. For example, if you have an ad placement at app launch and a user opens your app, he will see an ad for this placement. If s/he then navigates out of the app and back within 3 minutes, he will not see an ad at app launch.
    ironsource-banner-mediation-pacing-settings
    Notes:

    • You can’t switch off the ad delivery for the default placement.
    • Capping and pacing your ads might result in revenue reduction.  

 

We recommend checking if a placement is capped before serving it with the following method:

iOS

boolean isBannerPlacementCapped(String placementName)

Android

(BOOL)isBannerCappedForPlacement:(NSString *)placementName

Unity

bool isBannerPlacementCapped(string placementName)

Step 3. Integrate the Banner & Adapter in Your Code

To serve Banners to your users, you must first implement the ad unit in your code as described here and then integrate the Admob or Facebook adapters in your code.

Next, make sure to set up your selected ad network on the Network Setup page and set it to active.

Step 4. Verify Your Integration

To ensure your Banner Mediation integration was successful, activate the ad delivery on the dashboard of our mediation partner (Admob or Facebook) as well as on the ironSource Network Setup page.

Note: This will activate live Banners on your app!

 

Then navigate to the ironSource Testing page in the Monetize section. Add a test device and select the app you integrated Banner Mediation on. Go to the Mediation Testing tab:
ironsource-integration-mediation-testing-banners

If you have:

  • correctly integrated Banner Mediation in your app
  • properly integrated at least one mediation network adapter with Banner Support in your app
  • precisely configured and activated the ad network on the Network Setup page on the ironSource dashboard

then you will be able to select the ad network from the Banner column, click on Test and you will receive live ads to your test device.
ironsource-integration-testing-banner-mediation

To receive the revenue the ad unit generates, you must provide Company and Payment information.

 

Done!
Your app can now receives live Banner ads.