Integrate TopOn via ironSource custom network adapter

The version correspondence between TopOn Mediation Adapter, TopOn SDK and ironSource Mediation SDK is as follows:

ironSource SDK	TopOn Mediation Adapter	TopOn SDK
7.9.1.0	1.0.0	6.3.21 and above

 

Supported ad formats

• Interstitial

• Reward Video

• Banner

 

ironSource Adapter

TopOn supports to connect with ironSource mediation via custom adapter. Below introduces how to integrate TopOn sdk.

 

Step 1. Integrate ironSource SDK

Please integrate ironSource 7.9.1 and above, topon 6.3.21 and above, refer to ironSource, topon

 

Step 2. ironSource Console Setup

1. Custom Adapter Setup

Log in ironSource console,find Monetize ➣ Setup ➣ SDK Networks. Click Manage Networks and select Custom Adapter, then input TopOn network key: 15bfbe1d1.

Fill in TopOn's App Key (How to get it, please see the instructions below), and click the Save button to save

2. TopOn Placement ID Setup

In the page of SDK Networks Setup, select the app and find TopOn, then click Setup , input TopOn's APP ID, APP KEY and Ad placement ID (How to get it, please see the instructions below)

• In the app_id input box, fill in TopOn’s application ID

• In the app_key input box, fill in TopOn’s application KEY

• In the placement_id input box, fill in TopOn’s placement ID

• (Optional) In the Rate input box, fill in the floor price (the default is no floor price, if a floor price is configured, TopOn will return the advertisement based on this price, which may lead to a decrease in the filling rate of this Instance)

you can find TopOn's App ID & TopOn's placement ID, in this page: TonOn App

you can find TopOn's App Key, in this page: TonOn Account information

Step 3. Integrate TopOn SDK&Adapter

1. Integrate

1. Add Dependency

Necessary dependency packages: ironSource SDK and topon SDK. The topon version is currently unrestricted. It is recommended that the latest stable version be as current as possible. There are two integration methods, manual and pod

pod method (recommended):
Podfile configuration
pod 'IronSourceSDK','7.9.1.0' 
pod 'TPNSDKiOS','6.3.21'  
​

Note: If you need to integrate more networks through topon, please refer to Network SDK Integration. 

Manual way:

Download the corresponding SDKs from the official websites of ironsource and topon respectively, and drag them directly into the project Frameworks directory.
For other libraries that the project needs to depend on, please refer to various official website SDK instructions.

ironSource SDK Download document

topon SDK Download document

2. Add ISToponAdapter.xcframework

Currently, only manual import is supported. The adapter SDK is provided by topon and can be directly dragged into the project Frameworks directory.。

Framework Download

3. Adapter debug

After configuring dependencies, initialize ironSource normally, and configure ironSourceh backend topic related strategies. You can debug to the corresponding topon adapter policy source.

[IronSource setAdaptersDebug:YES]; Turn on the ironSource debug switch and you can see the related topon adapter running debugging logs to facilitate troubleshooting.

2. COPPA&CCPA

Please Log in the TopOn background, enter app page, select the corresponding app, and set COPPA and CCPA

Step 4. Test TopOn Ads

1. Add Test Device

In the ironSource backend, select the Testing option, find the corresponding app, click add test device in the upper right corner, and fill in the corresponding device ID.

2. Mediation Testing Setup

Switch to Mediation Testing, and add TopOn, then click test 

3. Enable Log Switch

    [ATAPI setLogEnabled:YES];

 

4. Enable TopOn Test Mode

Enter the Test Mode page, click the +Test Mode button, and enter the Device ID, Device Name, and select the App and Network to be tested, and click Confirm.

• Apple device ID, use the test device ID configured in the ironSource background as mentioned above

• Please wait for 5~10 minutes for the configuration to take effect, uninstall and reinstall the application before testing

please refer to The test guideline of TopOn SDK

 

Step 5. Recommended Waterfall & eCPM Floor Price Setting

1. For each format of ad in ironSource, you only need to create one placement id in TopOn dash.

   For example, if you want to create a TopOn ad to use in an ironSource rewarded video ad, you just need to create a TopOn reward placement in TopOn dash.

2. If you want to set TopOn’s eCPM floor price for TopOn ADX, you can refer to the following steps to configure it

   (1) Create multiple Instances in ironSource Dash, all using the same ad placement id (assuming TopOn’s ad placement id is "xxx"), as shown in the red box in the figure below

   (2) According to your waterfall setting needs, each Instance sets a different eCPM price, as shown in the blue box in the figure below

   Note: It is recommended to configure no more than 3 Instances and set up to 3 different eCPM prices

   

   (3) In the TopOn backend, on the aggregation management page, select the TopOn advertising placement for which you need to set floor price, and click `Advanced Settings'. In the bid floor input box, fill in the lowest price. For example, if $1, $0.5, and $0.1 are set in the picture above, fill in 0.1 in the input box