1. Functional Overview
TopOn provides log analysis of Bid fail、Request fail and Show fail for placements and ad sources. You can use the log analysis function to assist in troubleshooting..Log analysis data supports querying the last 14 days.
① The log analysis function supports the following dimensions:
| Log Type | Log Dimension | Required data dimensions | Illustrate |
|---|---|---|---|
|
Bid Fail
|
Placement | Placement | Analyze the bid failure logs of all bidding ad sources under the placement |
| Request Fail | Placement | Placement | Analyze the failed placement request log (the reason why the corresponding placement traffic request is not filled ) |
| Show Fail | Placement | Placement | Analyze the show fail log of the placement |
| Bid Fail | Ad Source | Ad source or Network | Analyze the bid failure log of the ad source (the reason why the corresponding ad source does not respond to the bid failure ) |
| Attempt Fail | Ad Source | Ad source or Network | Analyze the request fail log of the ad source (the reason why the ad request of the corresponding ad source is not filled ) |
| Show Fail | Ad Source | Ad source or Network | Analyze the video playback failure logs of rewarded videos and interstitial ad sources |
② Log analysis can query the data of the day
2. Operation Instructions
2.1 bid fail for placement and ad source
(1) When analyzing the bid failure log of a placement, after you select the placement , network , and ad source to be analyzed, TopOn will output the corresponding log content.
(2) Reasons for failed inquiries about placement , network , and ad source . The specific output content is as follows:
| Metrics | Illustrate |
|---|---|
| TopOn Error Codes | Error codes for TopOn SDK internal statistics |
| TopOn Error Type | Error types in TopOn SDK internal statistics |
| TopOn Error Message | Error information of TopOn SDK internal statistics |
(3) You can locate the reason why the placement , network , or ad source bid request is not filled based on the error type of TopOn SDK
| TopOn Error Codes | TopOn Error Type |
|---|---|
| -1 | The bidding failed or the network did not bid |
| -2 | The network SDK has not completed initialization and cannot initiate a bidding request |
| -3 | network timeout |
| -4 | TopOn S2S interface abnormality |
| -5 | Due to the show cap limit of the ad source, it does not participate in this bid request |
| -6 | Due to the show pacing limit of the ad source, it does not participate in this bid request |
| -7 | Due to the limitation of "the time interval between the next bid after the bid failed", the bidder will not participate in this bid request. |
| -8 | Due to the reason that "the developer passes in the filtered ad source ID through the SDK API", this bid request is not included |
| -9 | Due to "integration exception (network SDK does not exist, adapter does not exist)", this bidding request is not included |
2.2 Request fail for placement
(1) When analyzing the Request Fail log of a placement, after you select the placement to be analyzed, TopOn will output the corresponding log content.
(2) Reasons why the placement request failed. The specific output is as follows:
| Metrics | Illustrate |
|---|---|
| TopOn Error Codes | Error codes for TopOn SDK internal statistics |
| TopOn Error Message | Error information of TopOn SDK internal statistics |
(3) You can locate the reason why the placement is not filled based on the error code of TopOn SDK
TopOn Android SDK Error Code Description
TopOn iOS SDK Error Code Description
2.3 Show fail for placement
(1) When analyzing the Show Fail log of an placement, after you select the placement to be analyzed, TopOn will output the corresponding log content.
(2) The reason for the failure of the placement show, the specific output is as follows:
| Metrics | Illustrate |
|---|---|
| TopOn Error Codes | Error codes for TopOn SDK internal statistics |
| TopOn Error Message | Error information of TopOn SDK internal statistics |
(3) You can target the reason for the failure of the placement show based on the error code of the TopOn SDK
| TopOn Error Codes | Illustrate |
|---|---|
| 1 | There is currently no ad source available for display. Consider preloading ads or adding ad loading scenarios |
| 2 | The placement is limited by the display limit. You can consider modifying the cap setting of the placement. |
| 3 | Limited by the show pacing of the placement. Consider modifying your placement's show pacing settings |
| 4 | The current strategy is empty. Before the placement is loaded into the WaterFall strategy, the App will report this error when calling to display ads |
2.4 Attemps Fail for ad source
(1) When analyzing the Attempts Fail log, when you select the ad source or network for demand analysis, TopOn will output the corresponding log content.
(2) The reason for the failure of the ad source attempt, the specific output is as follows:
| Metrics | Illustrate |
|---|---|
| TopOn No Fill Type | Unfilled type of TopOn SDK internal statistics |
| Network error code | TopOn SDK records the error code returned by the network |
| Network error message | TopOn SDK records the error information returned by the network |
(3) You can target the reason why the ad source is not filled based on the TopOn Fill Fail Type
| TopOn Fill Fail Type | Illustrate |
|---|---|
| 0 | The ad source is not filled. It needs to be checked according to Network Error Codes and Network Error Message |
| 1 | Ad source filling timed out . The ad source did not return a filling result within 15 minutes. |
| 2 | Limited by the show cap of the ad source. Consider modifying your ad source's show cap settings |
| 3 | Limited by the show pacing of the ad source. Consider modifying your ad source's show pacing settings |
| 4 | No fill last time, no request was made within the specified time. Contact TopOn to set |
| 5 | Hit the filtered ad source ID passed in the Load method , and no request is initiated this time |
| 6 | The Bid Token of the bidding ad source has expired . No request will be made this time. |
| 7 | Current ad source is showing , so no request will be made this time |
(4) You can locate the reason why the ad source is not filled according to Network Error Codes and Network Error Message:
Network Android Error Code Description
Network iOS Error Code Description
2.5 Ad source show fail
(1) When analyzing the Show Fail log of an ad source, after you select the ad source or network to be analyzed, TopOn will output the corresponding log content.
(2) Reasons for the failure of ad source display. The specific output content is as follows:
| Metrics | Illustrate |
|---|---|
| TopOn show fail type | Display failure types counted by TopOn SDK |
| Network error code | TopOn SDK records the error code returned by the network |
| Network error message | TopOn SDK records the error information returned by the network |
(3) You can locate the reason for ad source show fail based on the show fail type of TopOn SDK
TopOn Android SDK Error Code Description
TopOn iOS SDK Error Code Description
(4) You can locate the reason why the ad source is shown failed according to Network Error Codes and Network Error Message:
;}.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)