Tag Control Reference Guide – Analytics

This document is a detailed reference to the analytics provided with Instart Tag Control.

Inventory 

The Inventory screen shows a list of tags present in the current property. You can present and organize the list in a number of ways – as a list of the Domains the tags are called from, or a list of source Files; these can be grouped by Site, Page, or Environment.

Shading in the Page views indicate when the domain or file was loaded relative to a few key DOM events:

  • shaded pink: loaded before Time to DOM Interactive
  • shaded gray: loaded between Time to DOM Interactive and Time to DOM Content Loaded
  • shaded blue: loaded between Time to DOM Content Loaded and Onload
  • no shading: loaded after Onload

Here's the Domains by Site view of the Inventory screen:

Here's the Domains by Page view:

Here's the Files by Site view:

Here's the Files by Page view (scrolled to show shading):

By default the list appears in ascending order of start time. You can sort it to appear in ascending or descending order of any of the three columns by clicking the corresponding up/down arrow icon.

You can narrow down the list by typing in the search boxes above each column. For example, typing "ab" atop the Domain column reduces the list to only those domains that have that substring present in their names; typing "< 100" atop the Avg. Duration column reduces the list to only items that loaded in less that 100 ms. These searches can be used together – for example, the following reduces the list from 147 results to just one:

By default the lists are set up to display 50 lines per page, and left and right pagination buttons are provided to move around in the full list. This is configurable; you can click in the number/page selector and choose to display 5, 10, 25, 50, or 100 lines per page, or All to show the entire list on a single page:


You can apply filters to each screen to limit the amount of data displayed. Filters can be set by clicking the filter icon on the right above the list. Some of these are required, such as Data type and Page Name. The available filters also differ depending on whether Data Type is set to Synthetic or Real User.

A complete list of available filters can be found in the Appendix.

Domain Analysis

The Domain Analysis screen collects a number of detailed metrics about the property. It shows 7 days of data back from a date you select in the Filters pane.

You can apply filters to each screen to limit the amount of data displayed. Filters can be set by clicking the filter icon on the right above the list. Some of these are required, such as Data type and Page Name. The available filters also differ depending on whether Data Type is set to Synthetic or Real User.

A complete list of available filters can be found in the Appendix.

Performance Details

Starting at the top is the Performance Details graph. This can be viewed either with all measurements or with only resource timings collected by clicking the tab along the top of the graph.

The graph plots the following metrics, indicated by different colors and line types:

Graph traceDescription
Page ViewsA page view is an instance of a page being loaded or reloaded in a browser. Page views is a metric defined as the total number of pages viewed.
OnloadThe average time until an object has been loaded (the Onload event)
1stByteThe average time between when the user or client made an HTTP request and the first byte of the page being received by the requesting browser.
DNSThe average time it took to receive the results from a DNS lookup, from the Resource Timing API in the users' browsers.
TCPConThe average time to establish the TCP connection to the server, from the Resource Timing API in the users' browsers.
DOM DurationThe average time for the browser to download a page's HTML and finish constructing the document object model (DOM) after the page is requested so that the domComplete event is triggered. Visually, this event occurs when the loading spinner stops spinning, which affects user perception of page speed. DOM Duration is measured as the time elapsed between the DOM Loading and DOM Complete events (DOM Duration = domComplete - domLoading). It occurs during the processing of the page. See W3C Navigation Timing for further information.
SSLWhen TLS or SSL are in use, the average time between when the handshake begins for securing the connection and when the connection to the server is complete, from the Resource Timing API in the users' browsers.
RedirectThe average time it took to redirect, if the page was redirected; from the Resource Timing API in the users' browsers.
Base PageThe average time the page takes to fetch the HTML file. This is calculated in the browser as the time elapsed between Response Start and Response End (Base Page = responseEnd - responseStart). See W3C Navigation Timing for more information.
Time to DOM InteractiveThe average time until the DOM could be interacted with by user. Specifically this is defined as the point where the page has displayed useful content, event handlers are registered for most visible page elements, and the page responds to user interactions within 50 milliseconds.
Time to DOM Content LoadedThe average time until the DOMContentLoaded event was fired, which is when the initial HTML document has been completely loaded and parsed, without waiting for stylesheets, images, and subframes to finish loading.
30 Day Avg OnloadThe 30-day average of the time until the Onload event occured
30 Day Avg DOM DurationThe 30-day average of the time until the DOM is constructed
30 Day Avg Time To DOM InteractiveThe 30-day average of the time until the DOM could be interacted with by users

Hovering over the plot will cause a summary data box to appear at the time points along the graph. For example:

For RUM data (for example, DNS, TCPCon), some browsers don't support the JavaScript resource timing API, so the second tab allows you to view the data allows you to filter out those that don't have that data reported.

You can click on the metric labels below the graph to gray them out, removing its trace in the display. For example, here's a graph showing only the average time until the Onload event:

Clicking on them returns them to the display.


Average Load Time By Domain

Next is the Average Load Time By Domain table:

This displays a list of third-party domains and the average daily load time for each over the selected seven-day period, plus the average load time over the last month, a 30-day average of the percentage of elements, and a 30-day average of elements per page.

By default the table is set up to display 25 lines per "page," and left and right pagination buttons are provided to move around in the full list. This is configurable; you can click on the number/page selector and choose to display 5, 10, 25, 50, or 100 lines per page, or All to show the entire list on a single page.


By default the list appears in ascending order of the 30-day average percentage of elements. You can sort it to appear in ascending or descending order of any of the other columns by clicking the corresponding up/down arrow icon.

You can narrow down the list by typing in the search boxes above each column. For example, typing "ad" atop the Domain column reduces the list to only those domains that have that substring present in their names; typing "< .09" atop the 30-Day Average column reduces the list to only items that loaded in less that 90 ms. These searches can be used together – for example, the following reduces the list from 28 results to just 3:

You can export the data in this table to CSV, TSV, JSON format, or as an array. Click Export on the upper left side of the table and select the desired format from the menu.

Domain Level Activity

Next comes Domain Level Activity. There are four possible views:

Domain Level Detail as a graph

This displays a waterfall for all the third-party domains in the selected page.

Hovering the mouse cursor over any portion of the waterfall will display details:

Domain Level Detail as a table

This displays the same data but in tabular form.

If you click on a small image icon in the first column, a graph of domain timings over the last seven days is generated:

You can click on the metric labels below the graph to gray them out, removing its trace in the display. For example, here's a graph showing only the average page load time:

Clicking on them returns them to the display.

By default the table is set up to display 25 lines per "page," and left and right pagination buttons are provided to move around in the full list. This is configurable; you can click on the number/page selector and choose to display 5, 10, 25, 50, or 100 lines per page, or All to show the entire list on a single page.


By default the list appears in ascending order of the count in the leftmost column. You can sort it to appear in ascending or descending order of any of the other columns by clicking the corresponding up/down arrow icon.

You can narrow down the list by typing in the search boxes above each column. For example, typing ".add" atop the Domain column reduces the list to only those domains that have that substring present in their names; typing "> .5" atop the Domain Activity column reduces the list to only items that loaded in more than 500 ms. These searches can be used together – for example, the following reduces the list from 47 results to just 2:

You can export the data in this table to CSV, TSV, JSON format, or as an array. Click Export on the upper left side of the table and select the desired format from the menu.

Object Level Detail as a graph

This displays a waterfall for all the third-party objects in the selected page.

Hovering the mouse cursor over any portion of the waterfall will display details:

Object Level Detail as a table

This displays the same data but in tabular form.

If you click on a small image icon in the first column, a graph of domain timings over the last seven days is generated:

You can click on the metric labels below the graph to gray them out, removing its trace in the display. For example, here's a graph showing only the Total Duration time:

Clicking on them returns them to the display.

By default the table is set up to display 25 lines per "page," and left and right pagination buttons are provided to move around in the full list. This is configurable; you can click on the number/page selector and choose to display 5, 10, 25, 50, or 100 lines per page, or All to show the entire list on a single page.

By default the list appears in ascending order of the count in the leftmost column. You can sort it to appear in ascending or descending order of any of the other columns by clicking the corresponding up/down arrow icon.

By default the list appears in ascending order of the 30-day average percentage of elements. You can sort it to appear in ascending or descending order of any of the other columns by clicking the corresponding up/down arrow icon.

You can narrow down the list by typing in the search boxes above each column. For example, typing ".css" atop the Files column reduces the list to only those domains that have that substring present in their names; typing "< .09" atop the Duration column reduces the list to only items that loaded in less that 90 ms. These searches can be used together – for example, the following reduces the list from 112 results to just 2:

You can export the data in this table to CSV, TSV, JSON format, or as an array. Click Export on the upper left side of the table and select the desired format from the menu.


Resource Timings By File

Finally there is Resource Timings By File:

The information provided is described below:

ColumnDescription
DomainRepresents an IP resource, usually understood as the name and address of a website.
FileThe name of the file loaded by a domain on the site.
Element CountThe number of times an element was loaded within the filter parameters and the selected time period.
DurationThe average time all objects in a domain or individual objects spend loading. Within a domain, this does not include time between files firing. See W3C Resource Timing for more information.
Redirect(s)The time elapsed between Redirect Start and Redirect End in the browser timings. This elapsed time is is added into the calculation for First Byte time in the event of a redirect.
App Cache(s)The amount of time it takes for a page to retrieve information from the application cache. Caching allows local storage and retrieval of information for loading a page. In the browser, the App Cache time is defined as the time elapsed between Fetch Start and Domain Lookup Start (App Cache = domainLookupStart - fetchStart). If there is no caching, Fetch Start and Domain Lookup Start occur simultaneously.
DNS(s)The Time Required to look up the domain name in the DNS system. (Domain Lookup End - Domain Lookup Start)
Request(s)The time spent issuing the network request for a page load or a page resource load. In the browser, this is the time elapsed between Request Start and Response Start (Request = responseStart - requestStart). Also see First Byte for a page load.

By default the table is set up to display 25 lines per "page," and left and right pagination buttons are provided to move around in the full list. This is configurable; you can click on the number/page selector and choose to display 5, 10, 25, 50, or 100 lines per page, or All to show the entire list on a single page.

Domain Details

This screen displays some summary details about domains.

At the top appears a Resource timing over time graph; by default it is populated with the aggregate timings for the currently selected domain.

As with the graphs in the Domain Analysis screens, you can click on the metric labels below the graph to gray them out, removing their trace in the display. Clicking on them returns them to the display.

You can view resource timings for individual resources by selecting a specific resource in the table below:

You can apply filters to each screen to limit the amount of data displayed. Filters can be set by clicking the filter icon on the right above the list. Some of these are required, such as Data type and Page Name. The available filters also differ depending on whether Data Type is set to Synthetic or Real User.

A complete list of available filters can be found in the Appendix.

Action Analytics

The Action Analytics screen displays information about requests that matched tag control rule conditions and had the rule actions applied.

At the top is a filters section to allow you to narrow down the results displayed. You can select which of the three types of events to show from the Action type pulldown:

  • Control Cookie Access
  • Control Form Access
  • Delay Resource Load

If you choose either of the first two, you can also filter by Access; the choices are 

  • Block Read
  • Block Write
  • Monitor Read
  • Monitor Write

Note

Currently you cannot create monitor access rules for cookies and forms using the rule building user interface; you need to use the API to do this for the time being.


You can select how to list the action events by selecting from the Group by pulldown. The choices are:

  • Under App:
    • Page Domain
    • Resource Domain
    • Page Event
  • Under Client
    • Country
    • Browser
    • Device

You can specify the Time Period for the display. Choices are

  • Last 24 hours
  • Last 3 Days
  • Last 7 Days
  • Custom

Custom allows you to pick a start and end date from a calendar widget.

You can further narrow down the list of events displayed by applying Additional filters and specifying criteria and values for them. For example, you could filter on Page Domain with Filter Criteria set to equals and Filter Value set to images.acme.net and click Apply, and only those events that were applied to images.acme.net would be displayed.

Below the filters is a graph showing the number of times rule actions were triggered during the selected time span. When you hover the cursor over the plot, specific information about that point on the graph is displayed:

You can zoom into the graph by manipulating the adjustment bar beneath the graph. You can drag the ends left or right, or drag the entire bar left or right:

Beneath the graph is a list of aggregated totals for the rules that were triggered. The left column shows the selection from the Group By filter, and the right column shows the total number of times the rule triggered for that grouping and the selected Action Type (and Access if applicable.)

For example, if Group By is set to Page Domain, and Action Type to Delay Resource Load, the list shows the number of times that tags had their load time deferred by a tag control rule for each first-party domain:

If Group By is set to Page Domain, and Action Type to Control Form Access, and Access to Block Read, the list shows the number of times that tags were prevented from being able to read from specified form fields by a tag control rule for each first-party domain:

Appendix 

Inventory screen filters 

FilterRequired?DescriptionValid values
Data TypeYesData Type allows you to choose either Synthetic or RUM data. RUM data will give insights into real experience on your site. Synthetic measurements yield more consistent measurement values, making this data particularly useful in scatter plots to reduce noise.Choose from pulldown: Synthetic or Real User
Time PeriodYes

The span of time to show data from.

Choose from list:
  • Last 3 Hours
  • Last 6 Hours
  • Last 24 Hours
  • Last 3 Days
  • Last 7 Days
  • Last 14 Days
  • Last 30 Days
  • Yesterday
  • Today
  • This Month
  • Last Month
  • Custom Range

If you choose Custom Range, you can select from the calendar widget to the right.

TimezoneYesThe timezone for the selected time spanSelect from pulldown

Datacenter location

NoWhere a user's site experience was served from. Contact your Blue Triangle representative to set up a datacenter location.
Page nameYesThe name of a specific page of a website.Select from pulldown
CountryNoSpecifies where site traffic from real users originates by country. Changing the country does not change the timezone used for reporting.Select from pulldown
Number of objectsYesResources on a page. As a filter, this limits the number of objects displayed in graphs and tables.

Select from pulldown:

  • 150
  • 200
  • 250
  • 300
  • 350
  • 400
  • 500
  • 600\
  • 700
  • 800
  • 900
  • 1000
Sort byYesChanges which objects are displayed in a waterfall chart based on the number of files an object contains or by the amount of time the object takes to load.

Select from pulldown:

  • File count
  • Slowest load time
Minimum sample sizeYesLimits the results in Object Level Detail to objects with a file count above this number. This filter is most useful when sorting the waterfall in Object Level Detail by slowest load time rather than by file count to filter out objects with a low number of hits.

Enter any integer; defaults to 100


Domain Analysis screen filters

FilterRequired?DescriptionValid values
Data TypeYesData Type allows you to choose either Synthetic or RUM data. RUM data will give insights into real experience on your site. Synthetic measurements yield more consistent measurement values, making this data particularly useful in scatter plots to reduce noise. Bullet list Choose from pulldown: Synthetic or Real User
Lookback 7 Days FromYesThe date from which to count back the last 7 days of data.Select from calendar widget
Baseline Period for ComparisonYes

Select from pulldown:

  • 7
  • 14
  • 21
  • 28
  • 30
  • 60
  • 90
TimezoneYesThe time zone for the selected time spanSelect from pulldown
Traffic Source/ReferrerNoSelecting a referrer only allows measurements from users that came from a particular source, such as a search engine, other website, or a direct navigation.
Datacenter LocationNo

Where a user's site experience was served from. Contact your Blue Triangle representative to set up a datacenter location.


Page NameYesThe name of a specific page of the website.Select from pulldown
Common Devices,
Common Operating Systems, and
Common Browsers
NoFilters to show specific devices, operating systems, and browsers.

Click on an icon to select it.

You can also click Select All Common to choose all common client attributes, and Deselect All to clear all selections.

Browser/OS/
Browser Version
NoAllows you to further refine the data displayed to specific OS and browser versionsSelect from pulldown; available selections depend on versions that actually appear in the last 7 days' data.
Bot TrafficNoAllows you to toggle Blue Triangle's bot filtering.

Select the desired radio button:

  • Include Bots will include data Blue Triangle has flagged as bot traffic.
  • Exclude Bots is the default setting, and keeps bot traffic from skewing real-user metrics.
  • Bots Only shows only bot traffic, which can be useful as a diagnostic tool.
CountryNoSpecifies where site traffic from real users originates by country. Changing the country does not change the timezone used for reporting.Select from pulldown; available selections depend on versions that actually appear in the last 7 days' data.
Number of objectsYesResources on a page. As a filter, this limits the number of objects displayed in graphs and tables.

Select from pulldown:

  • 150
  • 200
  • 250
  • 300
  • 350
  • 400
  • 500
  • 600
  • 700
  • 800
  • 900
  • 1000
Sort byYesChanges which objects are displayed in a waterfall chart based on the number of files an object contains or by the amount of time the object takes to load.

Select from pulldown:

  • File count
  • Slowest load time
Minimum sample sizeYesLimits the results in Object Level Detail to objects with a file count above this number. This filter is most useful when sorting the waterfall in Object Level Detail by slowest load time rather than by file count to filter out objects with a low number of hits.Enter any integer; defaults to 100


Domain Details filters

FilterRequired?DescriptionValid values
Data TypeYesData Type allows you to choose either Synthetic or RUM data. RUM data will give insights into real experience on your site. Synthetic measurements yield more consistent measurement values, making this data particularly useful in scatter plots to reduce noise.

Choose from pulldown:

  • Synthetic
  • Real User
  • API/Base Page & SSL
Time PeriodYesThe span of time to show data from.

Choose from list:

  • Last 3 Hours
  • Last 6 Hours
  • Last 24 Hours
  • Last 3 Days
  • Last 7 Days
  • Last 14 Days
  • Last 30 Days
  • Yesterday
  • Today
  • This Month
  • Last Month
  • Custom Range

If you choose Custom Range, you can select from the calendar widget to the right.

TimezoneYesThe timezone for the selected time spanSelect from pulldown