ironSource

System platform	Bidding Type	Ad Types
Android/iOS	S2S（iOS 6.4.88、Android 6.5.06）	Banner,Rewarded video,Interstitial

Step1. Create an ironSource Ads Account

To enable ironSource Ads ad inventory , Sign Up for an account and enter your account information.

 

Step2. Set Up Payment Information

To configure your payment details, go to the Payments section. You can access it by clicking on your user avatar located in the left-hand sidebar menu.

For additional guidance on completing payment setup or submitting tax forms, check out the detailed instructions here.

 

Step3. Add Your App

1. In the navigation bar on the left side of the page, select iS Ads. Then, click Apps and select Add App.

 

2. If your app is live in the App Store or on Google Play, enter your app’s URL. Click Import App Info. Your app’s name and category should appear automatically. If any field is incomplete, fill it manually.

 

If your app is not live yet, enter a temporary app name and update its information later from the Apps page.

 

3. Select COPPA and US state privacy laws settings:

Indicate if your app is directed to children by selecting the option under COPPA and decide how you’d like to comply with US state privacy laws. Then click Add App.

 

4. Select the ad units you want to display in your app. Then click the Continue button.

*Note, the app key is below the name of your app. You will need this later.

 

5.  Account Approval

Check your email inbox for a message requesting additional details. You’ll need to provide:

● A link to your app

● The mediation platform you’ve selected

● Any additional account information

 

After reviewing the information you provided, you’ll receive an email within a few days confirming whether your account has been approved or denied. Additionally, the header message on the ironSource Ads platform will be updated to reflect the status of your account.

 

Step4. ironSource Ads Instances

After you add your app, ironSource Ads bidding instances automatically appear in the Instances page. Be sure to activate the instances.

 

Step5. Configure ironSource's Report API

Ironsource reporting API documentation:https://developers.is.com/ironsource-mobile/air/reporting/

 

(1) ironSource will provide configuration information for pulling revenue data through the Report API, as follows：

① Secret Key

② Refresh Token

 

(2) find out Secure Key in ironSource

① Navigate to My Account and find out User Name

② Switch to the tab page of API，and find out Secret Key、Refresh Token

 

(3) Configure the ironSource Report API in TopOn

Navigate to TopOn→Network→Monetization→ New Network（ironSource）→Edit（Report API = ON ）→ Fill in Secret Key、Refresh Token

 

Step6. ironSource's Ad unit description

The correspondence between ironSource's Ad units and TopOn's ad types is as follows:

ironSource-Ad unit	TopOn-Ad Type
Interstitial	Interstitial(Video)
Rewarded Video	Rewarded Video
Banner	Banner

 

Step7. Configure ironSource on TopOn

(1) The following 2 parameters of ironSource need to be configured in TopOn. In this way, ironSource ads can be displayed through the TopOn SDK, and ironSource data can be displayed through TopOn：

Parameter name	Description
APP KEY	ironSource unique APP KEY for each APP
Instance Id	ironSource unique Instance Id for each Ad Unit

① Check the APP KEY and Instance Id in Ads--> Setup --> Instances

② If your APP is not online, you need to navigate to Ads-> SETUP-> Testing of the ironSource platform to add test Devices 

 

(2) Configure the parameters of ironSource in TopOn

① Navigate to TopOn → Mediation →Monetization(ironSource）→ Operation(AD Source Setting）→Add AD Source，and add AD Source

② Fill in the APP KEY and Instance Id of the ironSource corresponding to TopOn's APP

③ Set the price type of the AD Source .

If Header Bidding= NO,you need to sed the Price, eCPM price can be set independently for different Segment.The AD Source will be sorted according to the eCPM price, please fill in the real eCPM price .

Header Bidding=Yes: Bidding is achieved through server-side bidding.(Recommended options)

 

Step8. Add ironSource adapter to your code

Refer to the TopOn SDK integration documentation