How to set up banners

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. 

Before you start To set up the ironSource Interstitial, 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:

Step 2. Set Up Your Preferred Banner Refresh Rate

You can control over the banner refresh rate (available only from SDK version 6.7.7 and onward) by updating the number of seconds you would like the banner to refresh at the banner refresh rate field:


It is important that you make sure to switch off the banner refresh rate on your mediated ad networks.

Step 3. 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‘.


Next, select the Placement Name from the list or enter a custom name and click ‘Save‘.

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.
  • 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.
      • 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:


(BOOL)isBannerCappedForPlacement:(NSString *)placementName


boolean isBannerPlacementCapped(String placementName)


bool isBannerPlacementCapped(string placementName)

Step 4. 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 one or more of the following network’s adapters in your code:

  1. AdMob
  2. Facebook
  3. AppLovin
  4. InMobi
  5. Fyber
  6. AdColony
  7. Chartboost
  8. Mintegral
  9. UnityAds

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

Step 5. Verify Your Integration

To ensure your Banner Mediation integration was successful, activate the ad delivery on the dashboard of your network partner 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:

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.

To receive the revenue the ad unit generates, you must provide Company and Payment information.
👏 Done! Your app can now receive live Banner ads