How to set up the offerwall

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 Offerwall on your ironSource Dashboard.

Before you start To set up the ironSource Offerwall, 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 & Placements page under Setup. Navigate to this page, select the app you’d like to integrate the Offerwall on and click on the Offerwall tab:

offerwall-1

Step 2. Edit reward placement

You will see a DefaultOfferwall placement that you can edit or you can add a placement by clicking  ‘New Placement‘. Click the ‘Edit’ icon to change the reward configurations.

offerwall-1
Enter the ‘Currency Name’ of the virtual items that will be rewarded the user after completing an offer (ex. coins, gold, … ) and the ‘Conversion Rate’ which is the reward amount that will be granted to the users for every dollar you receive from ironSource. The conversion rate should be similar to the rate in your IAP store. Learn more about currency settings here.
offerwall-3

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. Select either Client-Side Events or Server-to-Server Callbacks. If you don’t set up any callbacks, you will not receive notifications about your users’ rewards.
    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.
    offerwall-3
  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: 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 offerwall ad unit in your code

To serve the ironSource Offerwall to your users, you must implement the Offerwall 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.

offerwall-1

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.
1

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 Offerwall ads