Custom Network

You can add Network that are not yet aggregated by Topon through Topon's Custom Network Firm feature.

 

Step1. Create Custom Network Firm

(1) Add Network Account Configuration

① If you have not added a custom network firm, click the Custom Network Firm portal to add a network

② Fill in the custom network firm information

③ You can add parameters for app and ad source dimension configuration

Note: If you do not add the parameters of the app and ad source dimension, the non-official gathering platform needs to use the JSON format to deliver the style when adding the ad source. In order to reduce the difficulty of adding the ad source configuration, it is recommended that you add the app and ad source dimension parameters first. For example: App ID, App key, Slot ID and other public parameters.

Configuration logic:

Parameter name: Only used to display in the background;
Key: used to send to SDK for use, please confirm with your developer classmates before filling in.

For example, the JSON of the ad source configuration: {"app_id":"1234","unit_id":"1111"}. app_id and unit_id are the keys to be entered here.

④ Be sure to fill in the Adapter for the AD format you want to use

⚠️ Note: For Android platform, please fill in the full path class name of the Adapter as shown below

⑤ When you add custom network firm, a custom network firm account is created simultaneously

 

(2) View the Network Firm ID for the custom network firm

The Topon SDK supports the ability to return information about the AD source in a callback, including the network that the current AD source belongs to. You can view the Network Firm ID of the custom network firm you have added in the network list

 

Step2. Add a custom network firm account

If you have already added a custom network firm and need to create another account, you can directly add a custom network firm account

 

Step3. Create the app and placement of custom network firm

Create apps and placements on the custom network firm you want to add (please go to the background of the corresponding network)

 

Step4. Add AD source of custom network firm

You can add the Ad Source of the Custom Network Firm on the Mediation and Network pages in the Topon:

① When adding an ad source for a custom network firm, you need to fill in the parameters of the ad source.

② The parameters of the AD source will be passed to the Adapter of the custom network firm through the Topon SDK.

③ It is recommended that Parameters include all parameters required by the Custom Network Firm SDK, such as App ID, Unit ID, etc.

If you have added app and ad source parameters on the network account management page, you can see that the corresponding parameters can be filled in directly when adding the ad source

If no parameter is added, you can enter the JSON content in other parameters and send it to the SDK

[Important] The ad source parameters are sent to the Adapter in the JSON strings type. To prevent XSS attacks, special characters in JSON strings will be escaped and output, such as "<", ">" and "&" will be escaped to "\u003c", "\u003e" and "\u0026". It is recommended that developers restore the escaped characters when implementing Adapter code

④ The last parameter to be delivered depends on the content displayed in "SDK Json" on the page

⑤ The Ad Source of Custom Network Firm does not support Auto Price

 

Step5. Access the Topon SDK to the custom network firm

1. Implement a custom network firm Adapter

You need to implement the Adapter classes for each AD format of your custom network firm by yourself according to Topon's custom network firm Adapter specification. The specifications are as follows:

Platform	Access specification
Android	Learn more
iOS	Learn more

 

2. Implement custom network firm client bidding

If the custom network firm you access supports C2S bidding, you can implement the C2S bidding function on the custom network firm.

The C2S bidding loading process is as follows:

You will need to implement the C2S Bidding function of your custom network firm according to Topon's Custom Client Bidding advertising specification. Specific specifications are as follows:

 

3. Add the custom network firm Adapter to the app code

Refer to the Topon SDK Integration documentation to integrate the Topon SDK into your app.

(1) Download Topon SDK

Support for custom network firm version numbers	Download URL
TopOn Android SDK V5.6.5 and above	Download
TopOn iOS SDK V5.6.5 and above	Download

(2) Refer to the TopOn SDK integration documentation

 

Step6. View the data of the custom network firm

You can view the data of Custom Network Firm in the Full Report in Topon.

The custom network firm already supports manual data upload，please check the specific upload steps in the developer background Operation Guide -> Upload Network Report Data