How to set up rewarded video ads

In order to generate revenue for your app with our Interstitial ad unit, you will have to integrate the ad unit in your code and activate the Rewarded Video on your ironSource Dashboard.

Before you start To set up the ironSource Rewarded Video, 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 Rewarded Video on and make sure you’re on the Rewarded Video tab:

Step 2. Add Placements, Capping & Pacing

You will see a DefaultRewardedVideo placement that you can edit or you can add a placement by clicking  ‘+ Add Placement‘.

  1. Select the Placement Name from the list or enter a custom name.
  2. In the Item Name field, name the virtual item that will be rewarded the user for a video completion.
  3. In the Reward Count field, enter the amount of items to reward the user for a single video completion.
  4. Click ‘Save‘.

Next, 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 4 impressions/day- you will only serve 4 ads for this placement per day.
  • Placement Pacing gives 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 15 minutes, he will not see an ad at app launch.
    Note: Note: Capping and pacing your ads might result in revenue reduction.
  • We recommend checking if a certain placement is capped before you show the Rewarded Video trigger to your users to ensure you will have an ad to serve.To manually verify if a certain placement is capped, call the below method:


[[Supersonic sharedInstance] isRewardedVideoPlacementCapped:placementName];


boolean isRewardedVideoPlacementCapped(String placementName);

Step 3. Configure Callbacks

To make sure that your users will be rewarded with virtual currency, you need to create an endpoint on your server so we can notify you of the user reward. Following the reward notification, you will need to reward your users.

  1. Set up Server-to-Server Callbacks. If you don’t set up any callbacks, you will not receive notifications about your users’ rewards.
    Note: Note: If the state of client-side callbacks section is ON, it means our server will notify you about the reward event but if you haven’t set an endpoint to listen to this event, you won’t receive the notification.
  2. If you choose to activate Server-to-Server Callbacks, click “Define Server-to-Server Callbacks” and enter the following:
    1. The Callback URL with these parameters
      1. [USER_ID]: the holder for the ID of the user that should be credited
      2. [REWARDS]: a holder for the amount of virtual currency to be accredited to the user
      3. [EVENT_ID]: a holder for the unique completion ID
        Note: Note: For Offerwall you must supply the callback.
    2. Private Key: If you’d like to certify the callback to ensure the callback’s authenticity and that it came from the ironSource server, enter a private key which we will use to hash (encode) the callback.
    3. Callback Test Parameters: To test the callbacks, enter a user ID, reward amount and event ID. Our system will configure a reward callback for you. Once you click ‘Test and Save’, our server will send a test callback to your configured Callback URL in the exact manner that it will do so for an actual user reward.ironsource-offerwall-setup-4

Step 4. Integrate the Rewarded Video Ad Unit in Your Code

To serve Rewarded Video ads to your users, integrate the Rewarded Video Ad Unit in your code as described here.

Next, set your set the ad unit to Test mode and verify your integration by adding a test device on the Integration Testing page.


This module allows you to verify the integration of all ad units on specific devices so you can test ad delivery without affecting your live app version. You control the test ads on your Test Devices and can add, edit or remove Test Devices (per OS) as you see fit. Read more on the Integration Testing tool here.

Step 5. Set to Live

Once you’ve successfully tested ad delivery, activate the ad unit. If you don’t have permissions to activate the ad unit on your dashboard, simply contact us and we will activate it for you.

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

👏 Done! Your app can now receive live Rewarded Video ads.