Autotrack

Autotrack is a JavaScript library built on top of analytics.js that makes it easier for web developers to track the user interactions that are common to most websites.

To help you get an idea of what the data collected by autotrack might look like, this demo includes visualizations of the actual data captured by using autotrack on this site.

Outbound link tracking

The table below shows the top ten links visitors to this site have clicked on in the last seven days. Autotrack uses events to track outbound link clicks and sets the event label to the link's URL.

Outbound Link Clicks

Events - Last 7 days

View this report in the Query Explorer →

Declarative Event Tracking

To make capturing events easier, autotrack supports declarative event binding. Demos & Tools uses this technique on the sign-in and sign-out buttons to help track the usage of those features.

Here's an example of what declarative event binding looks like for the sign-out button:

<button
  data-event-category="User"
  data-event-action="signout">
  Sign Out
</button>

And the following table shows the actual usage data for these buttons on this site:

Sign In/Out Interactions

Events - Last 7 days

Media query tracking

The Demos & Tools site tracks media query usage for the following categories:

Breakpoints:
The screen sizes where the site layout changes to fit the content (resize your browser window to see this in action).
Resolution:
The popularity of high-dpi screens (such as retina displays) is increasing. It's useful to know whether your user's screens have such capabilities, so you can build your site accordingly.
Orientation:
How you decide to design your site's layout may be influenced by whether your users view your site primarily in landscape or portrait mode.

As you can see from the pie charts below, most Demos & Tools users are on large screens, at regular resolution, in landscape mode:

  • Breakpoint Usage

    Sessions - Last 7 days
  • Resolution (dpi)

    Sessions - Last 7 days
  • Orientation

    Sessions - Last 7 days

The tables below outline how each of the media query values are defined:

Breakpoints

Name Value
xs all
sm (min-width: 420px)
md (min-width: 570px)
lg (min-width: 1024px)

Resolution

Name Value
1x all
1.5x (min-resolution: 144dpi), (-webkit-min-device-pixel-ratio: 1.5)
2x (min-resolution: 192dpi), (-webkit-min-device-pixel-ratio: 2)

Orientation

Name Value
landscape (orientation: landscape)
portrait (orientation: portrait)

For more information on how to configure media query tracking for your site, refer to the mediaQueryTracker configuration section of the autotrack documentation.

Media query change tracking

If you're tracking media query values, it's often useful to know if and when those values change. Autotrack captures this information as well by sending an event any time a media query stops matching one value and starts matching another, it also updates the tracker object so subsequent hits are associated with the correct media value.

This chart shows how frequently the breakpoint media query values changed on this site over the last seven days as well what breakpoints were most commonly changed to/from:

Breakpoint Changes

Events - Last 7 days

Getting started with autotrack

To you use autotrack on one of your own sites, the best place to start is the usage documentation on Github. To see an example implementation from Demos & Tool, check out the source code.