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
- 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. Dependencies
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
Add file: TopOn/Editor/Dependencies.xml to the Assets/MaxSdk/Mediation directory, and click here to get the latest SDK version.
<dependencies>
<androidPackages>
<repositories>
<repository>https://jfrog.anythinktech.com/artifactory/overseas_sdk</repository>
</repositories>
<androidPackage spec="com.anythink.sdk:core-tpn:6.4.12"/>
<androidPackage spec="com.anythink.sdk:nativead-tpn:6.4.12"/>
<androidPackage spec="com.anythink.sdk:banner-tpn:6.4.12"/>
<androidPackage spec="com.anythink.sdk:interstitial-tpn:6.4.12"/>
<androidPackage spec="com.anythink.sdk:rewardedvideo-tpn:6.4.12"/>
<androidPackage spec="androidx.appcompat:appcompat:1.1.0"/>
<androidPackage spec="androidx.browser:browser:1.4.0"/>
<androidPackage spec="com.anythink.sdkadx:max-mediation-adapter:1.1.8"/>
</androidPackages>
</dependencies>
2) iOS
Add file: TopOn/Editor/Dependencies.xml to the Assets/MaxSdk/Mediation directory.
We are strongly recommend to update info.plist, otherwise it will affect the advertising revenue.
2. Filling out the app-ads.txt
It‘s strongly recommended to protect ad revenue. You can learn more in Ads.txt
Step 4. Load and Show an Ad
Please refer to MAX
Step5. 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
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 *************************************
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