The Troubleshooting page provides SpringServe users with a visual interpretation of their activity in realtime. This is particularly useful to help debug issues for new supply and/or demand tags that do not work as expected. This dashboard can be accessed from the settings menu or by clicking the wrench icon in the header of an object or in the action column of an index table.
Navigating the Dashboard
Real Time Debugger
The main page of the Troubleshooting dashboard begins with the 'Real time Debugger' tab. This is where you can search any of your supply and demand tags, campaigns, or partners that need troubleshooting. As you enter text in the search box a drop down list sectioned off by headers (in bold) will display. Select the object that you want to look into and hit the submit button.
To search a specific supply and demand combination, add another search box by clicking on the "+" button and then hitting "Submit". This will result in 2 search boxes:
The results of your search will display the following in the same tab:
- Object metadata including Targeting, CPM and RPM Rates, Environment, waterfall positioning, and 3rd party pixels if applicable
- Realtime events including usable and blocked or skipped requests, opportunities, errors, impressions, and completes
- A visual display of your traffic including the number of secure/Non secure requests, Environment, Player Sizes, Inventory, Country, and User Agents
Note that realtime event and inventory data is a sampling of traffic for the last 15 minutes.
Targeting icons are shown below the object name. Like in the rest of the UI, icons are highlighted in teal when targeting is on the object and dark grey when targeting is on the parent (partner and/or campaign). If applicable, parent objects are shown below the targeting icons.
For supply tags CPM Rate, RPM Floor Rate, and (Targeted) Environment are shown. Response Type is displayed for managed supply tags. In the second column, the details for the associated demand are shown: domain and player size targeting, the number of tags in the waterfall, the number of distinct tiers/prios, and the number of broadcast tags in the waterfall.
Targeting icons and the number of active supply tags are shown for Supply Partners.
Revenue metadata and (Targeted) Environment are shown in the first column. Managed demand tags display the endpoint url in the second column. If applicable, demand pixels are shown. A table also displays the number of waterfalls that the demand tag belongs to, organized by tier. The inclusion rate is the percentage of time that the demand tag is included in a waterfall. There are a number of reasons that a tag would not be included in the waterfall, including:
- Targeting Skips: targeting prevents the tag from being eligible
- Pre-Bid Skips: demand tag has pre-bid enabled and
- Evaluation Skips: round robin exclusions, a demand tag downstream blocks the request, the demand stack behind a DC demand tag is empty
The number of active demand tags, Inclusion Rate, and average position in the waterfall is shown for Campaigns.
The number of active campaigns and demand tags, as well as the inclusion rate and the average position in the waterfall is shown for demand partners.
The events container shows data for a sample of your requests over the last 15 minutes.
You can look at performance information in three ways:
- Sunburst: Hierarchy of all events listed in the tables below
- Graph: Time Series for Usable Requests, Impressions, and Fill Rate
- Table: Select events listed in the tables below, highlighted in yellow
For demand objects, you can also view data for Errors. Sunburst and Table views are available for VAST error code data.
The sunburst graph allows you to see what portion of requests are being blocked, resulting in impressions, or throwing errors. To drill down, either click on the name of level in the legend or the level in the graph itself.
Drilling down can be helpful if there is a large portion of your requests that are being blocked or if you want to know more details about what kinds of VAST error codes you are seeing.
To get back to the default view of all events, click on Total (Ad) Requests in the legend.
The Requests graph shows the ratio of secure vs. non-secure requests.
The Environment graph shows the ratio of requests from Desktop, Mobile Web, In-app, and CTV.
The default Player Sizes graph shows the ratio of declared sizes.
The dropdown menu allows you to see histograms of Player Widths and Player Heights.
You can also view a scatter plot of Aspect Ratio. In this graph, the width is shown on the x-axis and the height on the y-axis. You can zoom in on this graph by highlighting the area of interest. Zooming can be useful if there are outliers.
These 4 types of graphs are also available for Detected sizes. Note that player size can only be detected if the VPAID has initialized, so for tags will few opportunities or VAST only tags (CTV), detected data is not available.
Inventory (Top 25)
The Inventory graph shows the top 25 requesting domains or apps. Select from Domains, App Names, and App Bundles in the dropdown.
The Country graph shows the ratio of requesting countries.
The User Agents graph defaults to the ratio of Device Types.
You can also select Device Make, Operating System, and Browser from the dropdown.
The Incoming requests tab is generated if your search included a managed supply tag. This tab streams the last 100 incoming requests. You could choose to pause the stream, or continue it by clicking on the / button to the right of the search box. This tab is especially useful to see if the tags are being filled in with their correct macro data.
The Outgoing requests tab gets generated if your search included a managed demand tag. The tab streams the last 100 outgoing requests. You could choose to pause the stream, or continue it by clicking on the button to the right of the search box. This tab is especially useful to see if macros from the supply tags are correctly being passed on to the demand.