Skip to main content

TPX SDK Guide

1. Sign up for a TradPlus account

1)Go to TradPlus website:http://tradplus.com .


2)Click [sign up] at the top right corner of the page


3)Fill in the required information

Sign up informationInstruction
E-mailEnter your Email Address
PasswordEnter a password. Password must be >=8 chars
Account nameEnter your account name
Cell-phone numberEnter your cell-phone number
SkypeEnter your Skype ID
CompanyEnter your company name
Report currencyTradPlus data reports provide statistics in “RMB” and “USD”, please select the currency you wish to use for your report.
App UrlEnter your app url(App Store address or APK download address)
Product typeIf your product is a game app, please choose [Gaming]; for non-game app, please choose [Non-gaming]
How do you know about TradPlus?Choose how do you know about Tradplus?

4)Check [I have read and agreed to the Terms of Service and Privacy Policy].


5)After confirming that you have filled in the information correctly, click [Sign Up], and you can log in to the background after successful registration.


2. Add an app

2.1 Procedure

1)Click【App Management】-【Apps & Ad Units】-【Add an app】。


2)Fill in the application related information:

App informationInstruction
OSSelect the app OS
App Store/Google Play/Other app stores/ Not on any storeIf your app is for iOS system, or already on App Store, choose [Yes]; otherwise, choose [No]; if your app is for Android system, or already on Google Play, choose [Google Play]; if your app is on other app stores, choose [Other app store]; if your app is not on any store, choose [Not on any store].
App Store URLFill in the address of your app in Google Play and click [Verify URL] to verify the address. The URL cannot be changed after it is saved, so please confirm that the link is filled in correctly.
App DomainFill in the App Domain, such as, tradplus.com
Bundle NameFill in the bundle Name, such as, com.tradplus.app
App NameFill in the app name. You cannot change the App name after saving it, so please confirm that the name is filled in correctly.
CategorySelect the category. If your app is a game app, please choose [Gaming]; for non-game app, please choose [Non-gaming]
Sub CategorySelect the sub category

Advanced Settings - Adjust Authorization

  • Please continue to fill in the following information if you have enabled the Adjust authorization, or ignore this entry if you have not.
  • If you need to activate an Adjust authorization, please contact your TradPlus AM to activate it.
  • Please apply for Ad Revenue authorization from Adjustd, otherwise you can't send TradPlus data back to Adjust.


3)After confirming all the information, click [Confirm] to save the application information


2.2 Expected results

You can view the added apps in the app list on the left side of the [Apps & Ad Units] page as shown in the screenshot:


3. Add ad units

3.1 Procedure

1) On the [Apps & Ad Units] page, select the app that needs to add ad units, and click [Add Ad Units] in the upper right corner of the page.

2)Fill in the information of the ad units:

You can check the relationships between TradPlus VisiM ad formats and the ad networks' through Table of Ad Formats


TradPlus VisiM supports the configuration of 6 ad formats as described below:

i. Rewarded Video

Ad Configuration InformationInstruction
Ad Unit Name (Required)Enter Ad unit name
No. of Parallel Requests (Required)The default number is 2, which is suggested to keep as it is. Developers can adjust later based on actual performance.
Capping● The default choice is 'Uncapped', which is suggested to keep as it is. Developers can adjust later based on actual performance.
● If you need to configure the display cap, please tap 'Capping' and select the cap and frequency. The screenshot shows each user can see the ad up to 3 times every 4 hours.
Reward Item & AmountThis information can be left unconfigured. The rewarded video's reward callback will follow the one in the code.
Server Side Reward Callback● After the user finishes watching the video, TradPlus server calls back to your server with a reward message. Supported SDK: TradPlus Android SDK >= 7.9 and iOS SDK >= 7.5.
● To ensure the accuracy of the rewards, it is recommended that developers can prioritize ad networks' server reward callbacks. For TradPlus Exchange and cross promotion, TradPlus server reward callbacks can be used directly.
TradPus Exchange Blocking RulesPlease fill in this item if you use TradPlus Exchange, otherwise it can be ignored. (To switch on TradPlus Exchange, please contact your Operation Manager.)

ⅱ. Interstitial

Ad Configuration InformationInstruction
Ad Unit Name (Required)Enter ad unit name
No. of Parallel Requests (Required)The default number is 2, which is suggested to keep as it is. Developers can adjust later based on actual performance.
Capping● The default choice is 'Uncapped', which is suggested to keep as it is. Developers can adjust later based on actual performance.
● If you need to configure the display cap, please tap 'Capping' and select the cap and frequency. The screenshot shows each user can see the ad up to 3 times every 4 hours.
TradPus Exchange Blocking RulesPlease fill in this item if you use TradPlus Exchange, otherwise it can be ignored. (To switch on TradPlus Exchange, please contact your Operation Manager.)

ⅲ. Banners

Ad Configuration InformationInstruction
Ad Unit Name (Required)Enter ad unit name
No. of Parallel Requests (Required)The default number is 1, which is suggested to keep as it is. Developers can adjust later based on actual performance.
Auto refresh● Choose whether or not to auto-refresh.
● It is recommended to choose no refresh initially, and after the data is stabilized, you can configure the refresh time as 60s, 120s, 180s and so on.
● If you have configured automatic refresh at TradPlus, please disable the auto refresh at networks.
● If you need to use the TradPlus for auto refresh, but can't turn off the auto refresh at networks, we recommend that you configure a normal auto refresh time at TradPlus, and the longest auto refresh time at networks.For example, if Unity has the banner auto-refresh range from 10s to 40s, it is recommended to configure 40s.
Capping● The default choice is 'Uncapped', which is suggested to keep as it is. Developers can adjust later based on actual performance.
● If you need to configure the display cap, please tap 'Capping' and select the cap and frequency. The screenshot shows each user can see the ad up to 3 times every 4 hours.
TradPus Exchange Blocking RulesPlease fill in this item if you use TradPlus Exchange, otherwise it can be ignored. (To switch on TradPlus Exchange, please contact your Operation Manager.)

ⅳ. Native Ads

There are 2 types of native ads to choose from:

a. Standard

b. Native Draw video


Specific configuration guidelines are listed below:


Standard & Native Draw video

Ad Configuration InformationInstruction
Ad Unit Name(Required)Enter ad unit name
No. of Parallel Requests(Required)The default number is 2, which is suggested to keep as it is. Developers can adjust later based on actual performance.
Capping● The default choice is 'Uncapped', which is suggested to keep as it is. Developers can adjust later based on actual performance.
● If you need to configure the display cap, please tap 'Capping' and select the cap and frequency. The screenshot shows each user can see the ad up to 3 times every 4 hours.
TradPus Exchange Blocking RulesPlease fill in this item if you use TradPlus Exchange, otherwise it can be ignored. (To switch on TradPlus Exchange, please contact your Operation Manager.)

3)After filling out the form and confirming that it is correct, click [Confirm] to save the ad unit information.


3.2 Expected result

You can view the added ad units in the ad unit list on the right side of the [Apps & Ad Units] page as shown in the picture:


4. Configure ad placements for the TPX SDK

4.1 Obtain the appid and pid from the TPX SDK backend.

4.1 Configure ad placements for the TPX SDK in the Admob backend

Fill in the Appid and Pid into the Admob backend.

4.2 Configure ad placements for the TPX SDK in the Ironsource backend

Fill in the Appid and Pid into the Ironsource backend.

4.3 Configure ad placements for the TPX SDK in the MAX backend

Fill in the Appid and Pid into the MAX backend.

5. Enable the application in the TPX SDK backend.

①select 'TPX'

②choose ' Switch Status'

③check the corresponding apps

④click ‘Batch Open’

6. Set the Floor price in TPX SDK backend.

①select 'Segments'

②choose ' app and ad Units ' that you previously created.

③Click 'Unlimited' and set a floor price, and before configuring the price, it is recommended to communicate with TPX AM first.

Sample as below, and then click ‘√’

④You need to pay attention to the price configuration. If misconfigured, it will affect revenue.

After the configuration is completed, It would be best to provide a screenshot of the corresponding price configuration in the Max backend and let TP AM to check it.

Please note: If you want to set multiple prices, you should create multiple ad units.

7. Access Guide

7.1 Admob

Android Access Guide

iOS Access Guide

Unity Access Guide

7.2 ironSource

Android Access Guide

iOS Access Guide

Unity Access Guide

7.3 Max

Android Access Guide

iOS Access Guide

Unity Access Guide

8. Test Mode

If you want to test during the integration process, you can first create a test placement id and open it here. The steps as below:

1)choose 'advanced settings' and click 'Test mode'

2)click 'create Test mode' and enter the information as below, then save it

  • Device ID: Android supports GAID, OAI and TpUserID; iOS supports IDFA and IDFV.
  • Device name: Customized configuration
  • App: choose the app that you created
  • Networks: choose Tradplus Exchange
  • Header bidding :yes

3)Status on switch

TradPlus SDK Test Mode