Integrate TopOn ADX with MAX Mediation

Supported Ad formats

Interstitial
Reward Video
Banner
Native

Integrate MAX Custom Adapter

Step1. MAX Custom Adapter Setup

1. Add MAX Custom Network

1) Find Networks under the tab of MANAGE on MAX platform;

2) Click Networks to define a Custom Network:

Network Type: choose SDK
Name: enter TopOn
iOS Adapter Class Name: enter ALTopOnMediationAdapter
Android Adapter Class Name: enter com.applovin.mediation.topon.TopOnAdxAdapter

2. Enable Custom SDK Network

1）Click Ad Units under the tab of MANAGE on MAX platform；

2）Select custom adapter of TopOn；

3）Enter APP ID、App Key、Placement ID, which you can find on TopOn. Please note APP ID is required.

Example：

App ID: input format is TopOnAppID_TopOnAppKey

e.g. if the App ID of the app created in TopOn is “a5aa1f0deda26v”, and the App Key is “abcde5bfa2a243f80cd04d8d0c18d2f59”, then fill in ” a5aa1f0deda26v_abcde5bfa2a243f80cd04d8d0c18d2f59"

Placement ID: Enter the TopOn Placement ID

e.g. if the ID of Placement created in the TopOn is “b5fdc16c90007f”, then enter b5fdc16c90007f.)

CPM Price: Enter the floor price of the Waterfall that you want to set ;

You can find TopOn's App ID & Placement ID on this page: TonOn Apps

You can find TopOn's App Key on this page: TonOn Account Information

You can visit MAX Documents for more details.

Step 2. Configure the floor price in TopOn

The CPM Price for MAX Waterfall needs to be configured in TopOn.

1. Relationship between MAX CPM price and TopOn placement floor price

For example, if you want to set up 3 tiers of Waterfall, then it's necessary to create 3 placements in TopOn, with each placement's floor price corresponding to one tier of MAX Waterfall CPM price.

2. Configure TopOn placement's floor price

1) Enter the Mediation page;

2) Select the App and Placement you need to set;

3) Click Settings and find Bid Floor ;

4) Enter the CPM Price corresponding to the Placement ID set in the MAX in Step 1 ;

Note

In the early stages of integration, it is recommended to set only a floor price of 0.01 at MAX, and allow TopOn ADX's budget to have at least 1 day to learn the value of traffic. After the data is stable, adjust the stratification on MAX based on the data report in the TopOn ;
Please ensure that the currency of your TopOn developer account must be USD. For details of the currency, please visit My Account

Step 3. Integration with TopOn SDK & Adapter

1. Android

● TopOn Adapter Changelog

● v1.1.8

Supports the latest version of the Applovin SDK

● v1.1.7

Supports Applovin SDK ≤ v12.6.1

1.1 Dependencies

Add the dependencies of TopOn SDK & Adapter SDK to the build.gradle file, click here to get the latest SDK version.

repositories {
    //Anythink(Core)
    maven {
        url "https://jfrog.anythinktech.com/artifactory/overseas_sdk"
    }
}

dependencies {
    //Anythink (Necessary)
    api "com.anythink.sdk:core-tpn:6.4.17"
    api "com.anythink.sdk:nativead-tpn:6.4.17"
    api "com.anythink.sdk:banner-tpn:6.4.17"
    api "com.anythink.sdk:interstitial-tpn:6.4.17"
    api "com.anythink.sdk:rewardedvideo-tpn:6.4.17"

    //Androidx (Necessary)
    api "androidx.appcompat:appcompat:1.1.0"
    api "androidx.browser:browser:1.4.0"
        
    api "com.anythink.sdkadx:max-mediation-adapter:1.1.8"
}

2、 iOS

● TopOn Adapter Changelog

● v6.4.28

Supports Applovin SDK v13.1.0. If you need to connect to other max versions, please contact us

2.1 Cocoapods introduction (recommended)

Add the following code in Podfile to introduce TopOn SDK and Adapter

pod 'AppLovinMediationTopOnAdxAdapter', '6.4.28'

3. Filling out the app-ads.txt

It‘s strongly recommended to protect ad revenue. You can learn more in Ads.txt

Step4. Verify and Test

Before your app goes live, please verify that the SDK has been successfully integrated by doing the following.

1. Enable Log Switch

1.1 Android

AppLovinSdk.getInstance(this).settings.setVerboseLogging(true)

After opening, you can filter this TAG in Logcat to view related logs:AppLovinSdk|TopOn|anythink

The device ID (GAID) can be obtained through the following logs

anythink: ********************************** UA_6.3.01 *************************************
anythink: GAID(ADID): ********-****-****-****-************ , AndroidID: ****************
anythink: ********************************** UA_6.3.01 *************************************

1.2 iOS

You can filter this TAG in the console to view related logs：ATAdLogger

（1）You can get the device ID (IDFA or IDFV) through the following logs:

ATAdLogger(UA_6.4.28) Message:
Device info:
*****************************
{
    IDFA = "xxxxxx";
    IDFV = "xxxxxx";
    Language = "zh-Hans-CN";
    Model = "iPhone13,3";
    NetworkType = "-2";
    OSVersionCode = "17.1";
    OSVersionName = iOS;
    PackageName = "xxxxx";
} 
*****************************

2. Open TopOn ADX

Enter Mediation Page, select the application and advertising placement to be tested, and turn on the TopOn ADX advertising source switch below.

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

Device ID: Please use Google Advertising ID (GAID), which is the GAID(ADID) obtained from the log in the above description
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

TopOn Adx Client Bidding Integration

TapTap

Last modified: 2025-05-30Powered by

Outline