TopOn now supports the zMaticoo platform. You can upgrade to TopOn SDK Android v6.6.42 / iOS v6.5.85 or above to use it.
| Platform |
Bidding Types |
Ad Formats |
|
Android/iOS
|
S2S bidding ad source, standard ad source
|
Native (self-rendering),Rewarded Video, Interstitial, Banner |
Step1. Create a zMaticoo Account
Visit zMaticoo to register an account and log in.
Step2.Create zMaticoo Apps and Placements
(1)Create Apps
Log in to the zMaticoo dashboard and select Application --> Apps --> + Add App on the left to create apps.

(2)Create Placements
In the zMaticoo dashboard, select Application --> Ad Placements --> + Add Ad Placement on the left, and select the corresponding app to create placements.

Step3. Enable the zMaticoo Report API
Three credentials are required before enabling: accessKey, accountId, and secretKey.
How to obtain them: Log in to the zMaticoo dashboard, select Account - Integrations on the left, select SDK & API List, and get accessKey, accountId, and secretKey in the API Security section.

Step4. Enable Auto-Creation of Ad Sources for zMaticoo
zMaticoo supports the auto-creation of ad sources. When adding the ad network, you need to set Auto-Create Ad Sources to “Yes”, and then you can use the auto-creation feature afterwards.

(1) Obtain the Configuration Parameters
The following parameters must be mapped from zMaticoo to TopOn:
| Parameter |
Description
|
|
App ID
|
The unique ID generated by zMaticoo for each app.
|
|
App Key
|
The unique Key generated by zMaticoo for each app.
|
|
Placement ID (Unit ID)
|
The unique ID generated by zMaticoo for each placement.
|
① Get the App ID
Go to Application --> Apps -->. The App ID is as shown in the figure below.

② Get the App Key
Go to Application --> Apps -->. The App Key is as shown in the figure below.

③ Get the Placement ID
Go to Application --> Ad Placements -->. The Placement ID is as shown in the figure below.

(2)Apply Parameters in the TopOn Developer Console
Log in to the TopOn dashboard → Mediation Management → select the relevant app and ad placement → add a new ad source and enter the parameters above.


Step6. zMaticoo Testing Process
(1) Method 1: Configure Test Devices in the zMaticoo Dashboard
To receive test ads on a specified device, you need to first add the test device to the whitelist in the zMaticoo dashboard.
1. Go to Test Mode and click [+ Add Test Device].

2. Add the device name and device ID (IDFA or Android ID).

3.After the device is added, it will be displayed in the device list, and you can change or turn on the test status of the device at any time.

(2)Method 2: Use Official Test Ad IDs for Verification
After the test device is configured, it is recommended to use the test App Key and test Placement ID officially provided by zMaticoo to quickly verify ad loading and display.
For the test ad parameters on each platform, see zMaticoo Test Integration .
Step7. Add zMaticoo adapter to your code
Refer to the TopOn SDK integration documentation