(iOS) Integrate TopOn with Max Mediation

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

AppLovinSDK SDK	TopOn Mediation Adapter	TopOn SDK
12.3.1	1.0.0	6.3.21 and above

 

Supported ad formats

• Native
• Banner
• Interstitial
• Reward Video

Step 1: Integrate MAX SDK

Please integrate AppLovinSDK 12.3.1 and above, topon 6.3.21 and above, refer to Max, TopOn

Step 2: Max Console Setup

1.Custom Adapter Setup

Log in Max，find Mediation,  Click Networks -> click here to add a Custom Network, disposition  iOS Adapter Class Name，Custom Network Name。

iOS Adapter Class Name：ALTopOnMediationAdapter （TopOn  calss name ）

2. TopOn Placement ID Setup

In the page of Ad Units，Select the ad slot you want to connect to TopOn SDK

 

Click Custom Networks and enter TopOn’s App ID, Placement ID, and CPM Price

CPM Price: (Optional) Enter the floor price (default is no floor price. If the floor price is configured, TopOn will return ads based on this price, which may result in a reduction in the fill rate of this Instance)

App ID：appid_appkey

Placement ID：TopOn Placement ID

 

 

 

You can find TopOn’s application ID & TopOn’s ad slot ID on this page： TonOn App

You can find TopOn’s App Key on this page：TonOn APP Info

 

 

Step 3 Integrated TopOn SDK&Adapter

1. integrated

 1.Add dependencies

Necessary dependency packages: AppLovinSDK SDK and topon SDK. The topon version is currently unlimited. It is recommended that the latest stable version be as current as possible.

pod：

Podfile 
pod 'AppLovinSDK','12.3.1'  
pod 'TPNSDKiOS','6.3.21'
pod 'Masonry'

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

 2. add TopOnMaxFramework.framework

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

 GDPR

Please refer to TopOn SDK GDPR Introduction

 

COPPA&CCPA

Please log in to the TopOn backend, enter the application page, select the corresponding application, and set COPPA & CCPA

 

Step 4. Test TopOn Ads

After configuring the dependencies, initialize max normally, and configure the admob backend topon-related policies, you can debug the corresponding topon adapter policy source.

// Turn on the topon debug switch, and you can see the related topon adapter running debugging logs to facilitate troubleshooting.
    [ATAPI setLogEnabled:YES];

Please refer to The test guideline of TopOn SDK

Step 5. Recommended Waterfall & eCPM Floor Price Setting

1. SDK & Adapter version

It is recommended to connect to TopOn v6.3.21 and above and TopOn Adapter v1.0.0 and above before setting the floor price.

2. Create ad placement

For each format of ad in Max, 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 Max rewarded video ad, you just need to create a TopOn reward placement in TopOn dash.

3. eCPM Floor Price Setting

If you want to set TopOn's eCPM floor price for TopOn Network, you can refer to the following steps to configure it

Note:

• using TopOn Adapter, TopOn’s floor price can be set directly in the Max Dash, but not set in the TopOn dashboard.

• In the early stages of integration, it is recommended to set only a floor price of 0.01 at max. After the data is stable, adjust the stratification on max based on the data report in the TopOn background.

• Please ensure that the currency of your TopOn developer account must be USD. For details of the currency, please see My Account

(1) In an Ad Unit of Max, create multiple Placement IDs, and configure the same TopOn ad slot ID in the Placement ID input box (assuming TopOn’s ad placement id is "xxx"), as shown in the red box in the figure below

Note: Fill in the parameters in the Placement ID input box, Must contain "_", and TopOn's ad placement ID must be added before "_". After "_", any string can be added

(2) According to actual needs, each Instance configures different prices for stratification, as shown in the blue box in the figure below

(3) After configuring as above, TopOn Adapter will automatically filter the floor price according to the price configured above ($1, $0.5, $0.1).

When the TopOn ad (One of the Placement ID in the above picture) placement is successfully loaded and the floor price is met, it will notify Max SDK: the ad is loaded successfully, otherwise it will notify Max SDK : Ad failed to load