Web Analytics
Web Analytics shows how visitors use your website: how many came, where they came from, which pages they looked at, what they clicked, and how many reached your goals.
It is built from the events that Autocapture sends, so the only setup is turning Autocapture on in the browser SDK. Open it from the Analytics section of the side menu.
- Turn on Autocapture in your website. Until page views arrive, the page shows No page views in this range yet.
- To fill the Clicks card, also turn on clicks with
autocapture: { clicks: true }. See Autocapture.
Pick what to look at
- Environment. Web Analytics shows one Environment at a time. Use the Environment switcher at the top of the page to change it.
- Date range. The Date chip in the filter bar always shows the range. Click it to pick any start and end date and time, or use a shortcut: Today, Yesterday, Last 7 days or This month. The default is the last 7 days, including today. Times are shown in the time zone of your browser.
- Refresh. Use the refresh button to load the latest numbers, or turn on auto refresh to reload every 30 seconds.
Above the summary, the page shows how many visitors are on your website right now: everyone with an event in the last 5 minutes. This count ignores the date range and filters, and leaves out bots and internal traffic.
Filters
Filters narrow every number on the page to the visitors you care about.
- Add a filter with the Add filter button (the funnel icon) in the filter bar, or click a row in any breakdown to filter by that value. Click the row again to remove it.
- Edit or remove a filter from its chip. Clear removes every filter and the goal, and turns Clean paths and internal traffic exclusion back on. It keeps the date range.
- Several values of the same filter match any of them. Different filters must all match. For example, Country is India or Germany and Channel is Email.
- Filters are part of the page address, so you can share a filtered view with a link. Your last filters are also remembered when you come back.
You can filter by Path, Entry path, Exit path, Channel, Referrer, UTM source, UTM medium, UTM campaign, Device type, Browser, OS, Country, Region, City, Language, Platform, Domain and Screen size.
The same menu adds three report settings. Each shows a chip only while it is set:
- Goal counts the sessions that reach a goal. See Goals and actions.
- Clean paths groups paths with your path cleaning rules. It is on by default, and the chip Clean paths is Off shows when you turn it off.
- Internal traffic leaves out your own team and test sites. It is on by default, and the chip Internal traffic is Included shows when you turn it off. See Internal and test traffic.
Removing a setting's chip puts it back to its default.
How a filter applies depends on what it describes:
- Session filters: Entry path, Exit path, Channel, Referrer and the UTM filters describe how a session started (or, for Exit path, how it ended). They keep whole sessions, with all of their page views.
- Page view filters: the others describe each page view. They keep the matching page views, and the sessions that include at least one of them.
Summary
The tiles at the top show the main numbers for the selected range:
| Metric | What it counts |
|---|---|
| Visitors | The number of different visitors, anonymous or signed in, that viewed at least one page. Each visitor is counted once in the range. |
| Page views | The number of $pageview events. |
| Sessions | The number of sessions that started in the range and include at least one page view. A session ends after 30 minutes without activity, or 24 hours after it started. |
| Session duration | The average time from the first to the last event of a session. Every event in the session counts, not only page views. |
| Bounce rate | The share of sessions with exactly one page view, no autocaptured clicks, and a duration under 10 seconds. |
With a goal picked, two more tiles show Conversions and Conversion rate. See Goals and actions.
Each tile also shows the change from the previous period: the range of the same length that comes right before the one you picked. Hover over the change to see the previous value. A lower bounce rate is shown as an improvement.
Trend
The chart shows Visitors, Page views or Sessions over the range, and Conversions when a goal is picked. It has one point per hour for ranges of 48 hours or less, and one point per day for longer ones. A session is counted in the hour or day it started, so the points add up to the Sessions total in the summary.
Active hours
A heatmap of page views by day of the week and hour of the day, in the time zone of your browser. Switch between Page views and Visitors. Hover over a cell to see its number. It follows your filters, so you can compare, for example, when mobile and desktop visitors come.
Retention
Visitors are grouped into weekly cohorts by the week of their first page view in the selected range. Weeks start on Monday. Each row shows how many visitors the cohort has, and the share of them who viewed a page again in each later week. Pick a range of several weeks to see a useful table. It follows your filters.
Breakdowns
Each card has tabs, and each tab lists the top 20 values.
| Card | Tabs | What it shows |
|---|---|---|
| Paths | Top pages | Each page with its visitors, views and average time on page. |
| Entry pages | The first page of a session, with the number of sessions. | |
| Exit pages | The last page viewed in a session, with the number of sessions. | |
| Domain | The website domain the session was on, by sessions. Useful when one Environment tracks several websites. | |
| Sources | Channels | How the session arrived, by sessions. See Channels. |
| Referrers | The website the visitor came from, by sessions. Visits that did not come from another website are shown as (direct). | |
| UTM source, UTM medium, UTM campaign | The campaign tags on the landing page of the session, by sessions. | |
| Devices | Device type, Browser, OS | What visitors use, by sessions. |
| Platform | The DashX SDK that sent the events, such as @dashx/browser, by sessions. | |
| Screen size | The screen size the browser reports, such as 1920x1080, by sessions. | |
| Geography | Countries | Where visitors are, by sessions, shown with each country's flag and name. |
| Regions | The state or province visitors are in, such as Karnataka, by sessions. | |
| Cities | The city visitors are in, by sessions. | |
| Languages | The language and region set in the visitor's browser, such as en-IN, by sessions. | |
| Clicks | Top clicks | The elements visitors click most, with the number of clicks and visitors. |
A few things to know about how the numbers are counted:
- Session values. Each session is counted once per breakdown. Entry pages, Channels, Referrers and the UTM tabs use the session's first page view, and Exit pages its last. The other tabs use the session's first page view that matches your filters. A value that was not recorded is shown as (none).
- Average time on page comes from the time recorded when a visitor leaves a page.
- Referrers are other websites only. Moving between pages of your own website does not count as a referrer.
- Top clicks groups clicks by what the visitor saw: the element's text, or else its
aria-label, or else itsid(shown with a#), or else its selector. The same label on different kinds of elements is listed separately, and hovering over a row shows the link target for links. Form submits are not included. - Page views with no session, for example ones tracked from a server, count in Visitors, Page views and Top pages. They are not counted in Sessions or in the other breakdowns.
- With a goal picked, every tab counted by sessions also shows Conversions and Conversion rate for each value, so you can see which sources, entry pages and devices convert best. Top pages and Top clicks don't, because conversions are counted per session.
Channels
Each session gets one channel, from its first page view:
| Channel | When |
|---|---|
| Direct | No referrer and no campaign tags. |
| Organic Search, Organic Social, Organic Video, Organic Shopping | The visitor came from a search engine, social network, video site or shopping site, without paid campaign tags. |
| Paid Search, Paid Social, Paid Video, Paid Shopping | The same sources with a paid utm_medium (such as cpc, ppc or paid), or an ad click id in the landing page URL (such as gclid or msclkid). |
| Paid Unknown | A paid utm_medium from a source DashX doesn't recognize. |
| Cross Network | utm_campaign is cross-network. |
| Email, SMS, Push, Affiliate, Audio | The campaign tags say so, for example utm_medium=email. Visits from webmail such as Gmail count as Email. |
| Referral | Any other website, or utm_medium set to referral. |
| Unknown | Campaign tags that don't match any of the above. |
Path cleaning
Pages whose paths contain ids, such as /orders/1042 and /orders/1043, are usually the same page. Path cleaning rules group them, so Top pages shows /orders/:id once instead of one row per order.
- Open the rules with the settings button in the filter bar, or from the Setup tab of the Analytics app under Apps in the Workspace dashboard. Rules belong to the Workspace, so every Environment uses the same rules and everyone sees the same grouping.
- Each rule replaces every match of its regex with its alias, and rules run in order. In an alias, use
\1to\9to keep a part of the match captured by the regex. - Regexes use RE2 syntax, so lookahead, lookbehind and backreferences are not available.
- Add suggested rules adds rules for UUIDs and for numeric path segments.
- The preview in the settings dialog shows how your top paths look with the rules you are editing. Try a path shows what any path you type becomes, in the dialog and on the Setup tab.
- Turn Clean paths off from the filter menu to see paths exactly as they were recorded. Turning it on or off removes any Path, Entry path and Exit path filters, because their values only match in one mode.
Rules apply when the page loads, so a change also regroups past data. A rule that can't be run is not saved. If a saved rule ever stops working, it is skipped, the page still loads, and a warning next to the settings button points to it.
Goals and actions
A goal is something you want visitors to do, like signing up or starting a checkout. Pick one with Goal in the filter menu, and Web Analytics counts the sessions that reached it.
A goal is either:
- An action you defined on the Setup tab, shown as Action: Signed up.
- An event, shown as Event: Page view or with your event's name. The list offers the events the browser SDK sent during the selected range.
A session converts when any of its events matches the goal. Conversions is the number of sessions that started in the range and converted, and Conversion rate is conversions divided by sessions. Conversions are counted per session, so only events sent from the browser SDK with a session can be goals. Events sent from a server have no session.
The goal is part of the page address, like filters, so a shared link opens with the same goal.
Define actions
An action names something visitors do, so you can use it as a goal. Define actions on the Setup tab of the Analytics app under Apps in the Workspace dashboard. Actions belong to the Workspace, so every Environment uses the same actions.
Each action has a name and one or more steps. An event matches the action when it matches any of its steps, and it matches a step when it meets all of the step's conditions:
| Condition | Matches |
|---|---|
| Event | Page view, Click, or one of your own events. |
| Page path | The path of the page the event happened on, as visited, before path cleaning. |
| Element text | Clicks only. The visible text of the element that was clicked. |
| Link | Clicks only. The link target of the element that was clicked. |
| CSS selector contains | Clicks only. Part of the element's selector, such as button.signup. |
Page path, Element text and Link can each equal a value, contain it (ignoring case), or match a regex. Regexes use RE2 syntax, and a regex that can't run is not saved.
Actions apply when the page loads, so a new action also counts past events. Clicks are only recorded when the browser SDK captures them. See Autocapture.
A goal whose action was deleted is removed from the page. If an action's regex ever stops working, the goal is skipped, the chip says (skipped), and the reason shows above the summary.
Internal and test traffic
Your own team and your test sites can skew the numbers. Set them up on the Setup tab of the Analytics app, under Internal and test traffic:
- Email domains, such as
example.com, and Emails match signed-in accounts in each Environment. - Test domains, such as
localhostorstaging.example.com, match the domain of the page that was viewed.
Internal traffic is left out of every number, including the live visitor count, while it is excluded. That is the default. To include it, open Internal traffic in the filter menu and turn exclusion off. The page shows how many accounts were left out. Up to 2,000 matching accounts can be excluded at a time.
What is left out
Visits from bots and crawlers are left out of every number. DashX recognizes them from the browser's user agent. Internal and test traffic is left out too, unless you include it.
Where the data comes from
The browser SDK sends the page, referrer, session and campaign with each event. When DashX receives an event, it adds:
- the browser, operating system and device type, from the user agent
- the country, region and city, from the IP address the event was sent from
- the screen size, from the device information the SDK sends
- the channel, from the referrer, campaign tags and landing page URL
Channels are worked out when an event arrives, so events recorded before channels were introduced show the channel (none). Likewise, events recorded before regions were introduced show the region (none).
Learn more about what the SDK sends, and how to keep personal data out of it, in Autocapture.