1. View the mediation (Waterfall) report data
Adjusting Waterfall needs to be done in combination with the actual data performance of each layer of ad sources. The TopOn mediation page directly provides two sets of data: TopOn SDK statistics and network report API data. There is no need to switch to the full report page to view and then switch back to make adjustments, which maximizes your convenience and saves time.
1.1 Report Time Zone
The data report supports modifying the report time zone. Currently, it supports UTC+8 China Standard Time, UTC+0 Greenwich Standard Time, and UTC-8 Pacific Standard Time. The default is UTC+8 time.
TopOn SDK statistics and the following network data have been aggregated according to the selected time zone (Facebook, Mintegral, Applovin, UnityAds, Tapjoy), and the remaining network data are based on the time zone returned by the API.
Report time zone modification path: TopOn Developer Backstage→[My Account]→[Account Information]→[Base information]→Report Time Zone
1.2 Data update time
The update time of different data metrics will be different, as follows:
(1) eCPM: eCPM is calculated by splitting the API revenue according to the impression ratio. Yesterday's data will be updated at 11:00 and 17:30 every day;
(2) Other TopOn SDK statistics except eCPM: updated every 30 minutes;
(3) Report API data of ad platforms (we will pull network data of the previous day in multiple time periods), please refer to the update instructions of each network in the full report for details
(4) Latency Percentiles data updated the next day:
① UTC+8 China Standard Time: Updated daily at 6:00
② UTC+0 Greenwich Mean Time: Updated daily at 11:00
③ UTC-8 Pacific Standard Time: Updated daily at 20:00
1.3 Report Metrics
Custom metrics support checking the required data dimension content to impression in the aggregate management report.
Description of each indicator of the mediation report:
| Report indicator | Description |
|---|---|
| Priority | The order in which TopOn initiates requests to each ad source. Request in ascending order of Arabic numerals and descending order of priority. Note: When the numbers are the same, the priority is the same. Each time a request is made, the priority of the ad source with the same number will be randomly requested. S2S and C2S icons are Impressioned for bidding ad sources |
| Ad source | The placement ID parameter of each network corresponds to a unique TopOn ad source, which can be used for waterfall ad layering in mediation. >>More |
| Status | Turn on or off the ad source. Blue is on, gray is off. |
| Operation | Edit or delete the ad source. |
| Price | Sorting price. This price is only used for priority sorting when requesting ads: for example, if ABCDE 5 layers of ad sources are added, these 5 layers of ad sources need to be sorted. This sorting will be sorted from high to low according to the filled-in price, and will not affect ad filling. Note: ① If the sorting prices of multiple ad sources are the same, the priority is the same, and each request is made with a random priority; ② It is recommended that the price be as consistent as possible with the actual eCPM (i.e. eCPM API) value of the ad source, which can be used to estimate the real-time revenue and LTV of the day. |
| eCPM | eCPM (effective cost per mile) refers to the ad revenue that can be obtained for every thousand impressions; if there are multiple traffic groups, it is the eCPM converted after the revenue and impression of the traffic group are split. Calculation formula: (revenue/impression)×1000. Note: Assuming that there are 3 traffic groups A, B, and C in this placement, the revenue of traffic group A = TopOn statistical impression of traffic group A/Total impression of TopOn statistics× revenue; eCPM of traffic group A = revenue of traffic group A/TopOn statistical impression of traffic group A×1000. |
| Estimated Revenue | Estimated revenue based on the number of impressions and eCPM prices counted by TopOn SDK. Calculation formula: ① Conventional ad source: manually filled in eCPM price * TopOn statistics / 1000; ② Header bidding ad source: real-time ad impression price. >>Header bidding instructions |
| Request | The summary row represents the traffic request, that is, the number of requests (Load) initiated by the application (client) to the TopOn SDK; The remaining rows represent the ad source request, that is, the number of requests initiated by TopOn to each ad source according to the waterfall ad source ranking of the aggregate management. Note: One traffic request may correspond to multiple ad source requests. When the application (client) initiates a request to TopOn, TopOn initiates requests to each ad source in sequence according to the waterfall ad source order. When the high-priority ad source is not filled, or no ad is returned within the short timeout (8s), it will request the lower-priority ad source. At this time, one traffic request will correspond to multiple ad source requests. |
| Fill rate | Summary row indicates the traffic fill rate, that is, the percentage of ads returned successfully after the application (client) initiates a request (Load) to the TopOn SDK; The remaining rows indicate the ad fill rate, that is, the percentage of ads returned successfully after TopOn initiates a request to each ad source. Calculation formula: Traffic fill rate = number of traffic requests returned successfully (number of traffic fills) / traffic requests ×100%; Ad source fill rate = number of ad source requests returned successfully (number of ad fills) / ad source requests ×100%. |
| Latency (sec.) | The average time from initiating a request to successfully returning an ad. Note: ① Due to the self-filling behavior of UnityAds, the Latency cannot be accurately counted, and the Latency data of the UnityAds ad source is not Impressioned for the time being. ② Statistical data will be available starting from December 16, 2020. |
| Impression | From 0:00 on March 7, 2023 (UTC+8), the statistical caliber will be adjusted from "the number of times TopOn calls the network SDK to start Impressioning" to "the number of callbacks TopOn receives from the network SDK for successful Impressioning". Due to different statistical calibers, there may be some differences between the impression counted by TopOn and the impression counted by the network (Impression API). |
| Click | Number of ad clicks counted by TopOn. Some platforms do not provide click callbacks (such as Admob's rewarded videos), resulting in TopOn being unable to count user clicks. |
| CTR | The ratio of ad clicks counted by TopOn to ad exposures counted by TopOn. Calculation formula: click/impression*100%. |
| Impression Rate | The ratio of the number of ad impressions counted by TopOn to the number of successful traffic requests returned (traffic filling number). Calculation formula: impression/traffic filling number*100%. |
| Impression Gap | The difference between the number of ad impressions counted by TopOn and the number of ad impressions counted by the network. Calculation formula: (Impression-Impression API)/Impression API. Note: Due to different statistical calibers, there may be some differences between the impression statistics of TopOn and the impression statistics of the network (Impression API). When the Impression gap exceeds 15%, you can contact TopOn's AM to investigate the cause. |
| eCPM API | The eCPM (effective cost per mile) that TopOn pulls from the network through the report API. Calculation formula: (Revenue/Impression API) ×1000. Note: If there are multiple groups (traffic groups or AB tests), the eCPM API in each group is the total eCPM of the ad ID pulled from the network, and is not split according to the group. If you want to view the actual eCPM of the group, please check the eCPM indicator, which is the estimated eCPM data after splitting; or use an independent set of ad source IDs for each group to accurately distinguish. |
| Revenue API | The actual revenue that TopOn pulls from the network through the report API. Note: If there are multiple groups (traffic groups or AB tests), the revenue in each group is the total revenue of the ad ID pulled from the network, and is not split according to the group. If you want to view the actual revenue of the group, please check the estimated revenue indicator, which is the estimated revenue data after splitting; or use an independent set of ad source IDs for accurate distinction for each group. |
| Request API | The number of ad requests that TopOn pulls from the network through the reporting API. Note: Some ad platforms do not provide this data. If there are multiple groups (traffic groups or AB tests), the requests in each group are the total requests for the ad ID pulled from the network, and are not split according to the group. If you want to view the actual requests for the group, please check the Request indicator, which is the request data counted by TopOn; or use an independent set of ad source IDs for each group to accurately distinguish. |
| Attempts Rate API | The ad fill rate that TopOn pulls from the network through the report API. Note: Some ad platforms do not provide this data. If there are multiple groups (traffic groups or AB tests), the requests in each group are the total fill rate of the ad ID pulled from the network, and are not split according to the group. If you want to view the actual fill rate of the group, please check the Attempts Rate indicator, which is the fill rate data counted by TopOn; or use an independent set of ad source IDs for each group to accurately distinguish. |
| Impression API | The number of ad impressions that TopOn pulls from the network through the report API. Due to different statistical calibers, there may be some differences between the impression statistics of TopOn and the impression statistics of the network (Impression API). Note: If there are multiple groups (traffic groups or AB tests), the requests in each group are the total impression of the ad ID pulled from the network, and are not split according to the group. If you want to view the actual impression of the group, please check the impression indicator, which is the impression data counted by TopOn; or use an independent set of ad source IDs for each group for precise distinction. |
| Chicks API | The number of ad clicks that TopOn pulls from the network through the report API. Note: If there are multiple groups (traffic groups or AB tests), the requests in each group are the total clicks of the ad ID pulled from the network, and are not split according to the group. If you want to view the actual clicks of the group, please check the Click indicator, which is the click data counted by TopOn; or use an independent set of ad source IDs for each group to accurately distinguish. |
| CTR API | The click-through rate of ads that TopOn pulls from the network through the report API. Calculation formula: Chicks API/Impression API×100%. Note: If there are multiple groups (traffic groups or AB tests), the requests in each group are the total click-through rate of the ad ID pulled from the network, and are not split according to the group. If you want to view the actual click-through rate of the group, please check the CTR indicator, which is the click-through rate data counted by TopOn; or use an independent set of ad source IDs for each group to accurately distinguish. |
1.4 FAQ
(1) What is the function of latency?
Latency refers to the average time from initiating an ad request to the ad returning successfully. It can be used to view the loading time of each ad layer, and optimize the waterfall flow in time by combining the ad layer fill rate and ecpm.
Note:
① Long latency does not necessarily mean that the ad effect is poor, and it needs to be evaluated in combination with other data.
②Generally, video ads with a loading time of less than 10 seconds are not considered slow.
;}.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)