Search...
Menu
Error Codes
Tips:
To quickly pinpoint the cause of an issue, it is recommended to obtain all error information via
AdError#getFullErrorInfo()."code[ " + code + " ],desc[ " + desc + " ], platformCode[ " + platformCode + " ], platformMSG[ " + platformMSG + " ]" code: TopOn SDK error code desc: TopOn SDK error message platformCode: Third-party ad network error code (the error code to check when an ad has no fill) platformMsg: Third-party ad network error message (the error message to check when an ad has no fill)
1. TopOn Error Code Information
| Error Code | Description |
|---|---|
| 10001 | App ID or App Key is incorrect. Please check the App ID and App Key passed when initializing the TopOn SDK. |
| 10003 | 1. App ID is incorrect. Please check the App ID passed when initializing the TopOn SDK. 2. The TopOn placement ID does not match the App ID. Please check the Placement ID passed when calling the load method in your code. |
| 10004 | The TopOn placement ID is incorrect. Please check the Placement ID passed when calling the load method. |
| 9999 | 1. A network request error occurred. Check whether the network status is normal. 2. An error message appeared: chain validation failed. Please check whether the test device's system time has been adjusted. |
| 9990 | The HTTP interface request returned a status error. You need to contact a TopOn colleague to view the error information. |
| 9991 | A business code error was returned by the interface request. You need to contact a TopOn colleague to view the error information. |
| 9992 | The GDPR level is set too low. Check whether the FORBIDDEN level has been manually set. |
| 2001 | Ad load timed out. Check whether the current test ad source is an overseas network and whether the phone's network has been proxied. |
| 2002 | The TopOn SDK package is incomplete, missing the Adapter package for a third-party ad network. Confirm that the required third-party SDK packages for mediation have been imported as instructed. |
| 2003 | The current placement has reached its impression cap. You need to confirm whether the TopOn dashboard configuration limits the number of impressions for this placement. |
| 2004 | The current placement is in a non-display time period. You need to confirm whether the TopOn dashboard configuration limits the display interval for the placement. |
| 2005 | This placement is in the loading phase. After a request is initiated for the same placement, before receiving the load success or failure callback, the placement cannot initiate the next load. Please wait for the load success or failure callback. |
| 2006 | Check whether the imported third-party ad network SDK packages are complete. If they are complete, check whether the imported version matches the version specified on GitHub. If not, the third-party SDK packages need to be completed. |
| 2007 | This usually occurs when an ad load is initiated immediately in the load failure callback. Initiating an ad load immediately in the load failure callback is prohibited. A certain time interval must elapse since the last load failure for this placement before an ad load can be initiated. Please delay the call to load the ad. |
| 2008 | After a load failure for the same placement, calling the load method immediately in the load failure callback for a retry is prohibited. Please delay for at least 2 seconds before retrying. |
| 2009 | The number of loads for the placement has reached the cap within a certain time interval. |
| 3001 | Policy fetch error. 1. Check whether the network is normal. 2. Check whether the appId, appKey, and placementId used are matching. 3. Check whether the appId, appKey, and placementId in the code are correct and matching (no spaces allowed). |
| 3002 | One of the passed appId, appKey, or placementId is an empty string. Please check these parameters. |
| 3003 | The placement does not match the API being called. For example, a Banner placement ID was used to call the Rewarded Video API to load an ad. |
| 4001 | This usually occurs when a third-party ad network returns an error resulting in no ad fill. You can obtain the full error information via AdError.getFullErrorInfo(), and view the ad network's error code and error message using platformCode and platformMsg. Please check the third-party ad network error codes for troubleshooting. |
| 4002 | The Context has been destroyed. You need to recreate the corresponding ad type object and re-initiate the ad load. |
| 4003 | The status of this placement is closed. Check whether the status switch for this placement is turned on in the TopOn dashboard. |
| 4004 | No ad source information has been configured for this placement in the TopOn dashboard. You need to go to the TopOn dashboard - Mediation Management to add third-party ad network ad sources for the placement. |
| 4005 | All ad sources under the placement have been filtered. Possible reasons are as follows: 1. Check whether the impression cap or impression interval has been set for the ad sources in the TopOn dashboard. 2. If only header bidding ad sources are configured, they will be filtered when the bidding fails. |
| 4006 | Video playback failed. Refer to Error Code 4001 for troubleshooting. |
| 4007 | Ad source bidding failed. Refer to Error Code 4001 for troubleshooting. |
| 4008 | The ad source was filtered due to custom filtering logic in the developer's code. If the filtering does not match expectations, please troubleshoot the custom filtering logic. |
| 4009 | In debug mode, no ad source information has been configured for this placement. |
2. Third-Party Ad Network Error Codes
| ● AdMob | ● Meta | ● Mintegral | ● Pangle |
|---|---|---|---|
| ● Huawei | ● AppLovin | ● Unity Ads | ● Digital Turbine(Fyber) |
| ● Chartboost | ● ironSource | ● Liftoff(Vungle) | ● InMobi |
| ● Ogury | ● Maio | ● Nend | ● Yandex |
| ● Bigo |
Previous
How to Test
Next
TopOn Demo App
Last modified: 2026-07-03Powered by;}.cls-2{fill:%230868f7;}.cls-3{fill:url(%23未命名的渐变_44);}.cls-4{fill:%23333;}%3c/style%3e%3clinearGradient%20id='未命名的渐变_8'%20x1='33.73'%20y1='100.61'%20x2='-0.03'%20y2='-1.06'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%237ae9fb'/%3e%3cstop%20offset='0.67'%20stop-color='%232b90f8'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3clinearGradient%20id='未命名的渐变_44'%20x1='27.86'%20y1='18.67'%20x2='68.36'%20y2='22.22'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%235ac7f2'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3c/defs%3e%3cpath%20class='cls-1'%20d='M29,28.74V81.91l-9.51-3.68v0L8.52,74A7.17,7.17,0,0,1,4,67.32V24.54A3.76,3.76,0,0,1,9.08,21Z'/%3e%3cpath%20class='cls-2'%20d='M68.09,78.07a13.15,13.15,0,0,1-17.9,12.06L29,81.91h0V28.74L50.19,37A13.17,13.17,0,0,0,68.08,25.3h0Z'/%3e%3cpath%20class='cls-3'%20d='M68.08,25.3a13.19,13.19,0,0,1-6.73,10.87A13.09,13.09,0,0,1,50.19,37L29,28.74V6A3.76,3.76,0,0,1,34.1,2.52l25.59,9.91A13.22,13.22,0,0,1,68.08,25.3Z'/%3e%3cpath%20class='cls-4'%20d='M129.06,81.76a4.33,4.33,0,0,1-3.19-1.31,4.4,4.4,0,0,1-1.31-3.24V56.86H97.65V77.21a4.36,4.36,0,0,1-1.35,3.2A4.68,4.68,0,0,1,93,81.76a4.32,4.32,0,0,1-3.19-1.31,4.37,4.37,0,0,1-1.32-3.24V27.27A4.58,4.58,0,0,1,89.83,24a4.59,4.59,0,0,1,7.82,3.27V48.15h26.91V27.27A4.58,4.58,0,0,1,125.91,24a4.59,4.59,0,0,1,7.82,3.27V77.21a4.37,4.37,0,0,1-1.36,3.2A4.65,4.65,0,0,1,129.06,81.76Z'/%3e%3cpath%20class='cls-4'%20d='M163.77,81.66c-6.57,0-11.76-1.92-15.44-5.7s-5.54-9.07-5.54-15.74a26.76,26.76,0,0,1,2.09-10.43,17.72,17.72,0,0,1,6.67-8.06,19.15,19.15,0,0,1,10.68-2.95,19,19,0,0,1,10.46,2.8,18.7,18.7,0,0,1,6.55,7.36,22.53,22.53,0,0,1,2.36,10.28A4.51,4.51,0,0,1,177,63.77H152.23a10.8,10.8,0,0,0,3.49,6.65c2,1.68,4.88,2.52,8.66,2.52a22.25,22.25,0,0,0,7.54-1.21c.74-.3,1.55-.67,2.37-1.07a3.75,3.75,0,0,1,1.84-.4,4.09,4.09,0,0,1,3,1.15,4,4,0,0,1,1.12,3,4.38,4.38,0,0,1-2.58,3.82,32.34,32.34,0,0,1-6.36,2.61A28.67,28.67,0,0,1,163.77,81.66ZM172.4,55.9a9.72,9.72,0,0,0-1.63-4.56A9.9,9.9,0,0,0,167,48a10.38,10.38,0,0,0-4.64-1.14,12,12,0,0,0-4.77,1.06,9.54,9.54,0,0,0-4.89,5.66,11.78,11.78,0,0,0-.51,2.3Z'/%3e%3cpath%20class='cls-4'%20d='M193,81.64a4.49,4.49,0,0,1-4.51-4.55V27.28A4.58,4.58,0,0,1,189.84,24a4.48,4.48,0,0,1,3.28-1.36A4.36,4.36,0,0,1,196.35,24a4.46,4.46,0,0,1,1.31,3.31V77.09a4.34,4.34,0,0,1-1.35,3.2A4.67,4.67,0,0,1,193,81.64Z'/%3e%3cpath%20class='cls-4'%20d='M263.79,81.71a5.7,5.7,0,0,1-4.2-1.74,5.76,5.76,0,0,1-1.73-4.19V27.37a4.58,4.58,0,0,1,1.35-3.27A4.59,4.59,0,0,1,267,27.37V72.53h24a4.58,4.58,0,0,1,3.27,7.82A4.66,4.66,0,0,1,291,81.71Z'/%3e%3cpath%20class='cls-4'%20d='M424.48,81.74a4.71,4.71,0,0,1-2.71-.88,5.43,5.43,0,0,1-1-1l-.07-.09-12.41-17-5.41,5v9.44a4.31,4.31,0,0,1-1.36,3.19,4.66,4.66,0,0,1-3.3,1.36A4.29,4.29,0,0,1,395,80.42a4.36,4.36,0,0,1-1.32-3.23V27.37A4.58,4.58,0,0,1,395,24.1a4.52,4.52,0,0,1,6.58.12,4.54,4.54,0,0,1,1.24,3.15V56.31l17.72-16.38.05,0a4.8,4.8,0,0,1,2.94-1.11,4.4,4.4,0,0,1,3.27,1.2,4.57,4.57,0,0,1,1.2,3.27,4.44,4.44,0,0,1-.77,2.33,7.45,7.45,0,0,1-1.43,1.65l-11,9.64,13.34,17.68a5,5,0,0,1,1,2.71,4.12,4.12,0,0,1-1.36,3.24A4.64,4.64,0,0,1,424.48,81.74Z'/%3e%3cpath%20class='cls-4'%20d='M317.93,81.76a21.5,21.5,0,1,1,21.17-21.5A21.37,21.37,0,0,1,317.93,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,317.93,47.66Z'/%3e%3cpath%20class='cls-4'%20d='M212.18,101.22a4.12,4.12,0,0,1-3.05-1.26,4.17,4.17,0,0,1-1.26-3.1V43.34a4.37,4.37,0,0,1,1.3-3.14,4.26,4.26,0,0,1,3.13-1.3,4.19,4.19,0,0,1,3.1,1.26,4.32,4.32,0,0,1,1.26,3.16,20.77,20.77,0,0,1,13-4.54,21.51,21.51,0,0,1,0,43,20.51,20.51,0,0,1-13-4.57V96.86a4.15,4.15,0,0,1-1.3,3.06A4.5,4.5,0,0,1,212.18,101.22Zm17.43-53.63c-6.23,0-12.93,4.11-12.93,12.72a12.73,12.73,0,0,0,25.46,0A12.71,12.71,0,0,0,229.61,47.59Z'/%3e%3cpath%20class='cls-4'%20d='M365.76,81.76a21.5,21.5,0,1,1,21.18-21.5A21.37,21.37,0,0,1,365.76,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,365.76,47.66Z'/%3e%3c/svg%3e)
Outline