Skip to main content
Skip table of contents

Tracking settings

Manage the general Viewtracker tracking settings, report catching (improves performance) and maximum simultaneous Content & Usage Report generation. Visitor’s time spent on pages and blog posts can also be measured by activating the appropriate function.

image-20250128-151405.png

How to access the Tracking Settings menu

Access the menu via Analytics Cockpit - Tracking (Manage what and how to track).

(info) The tab “Tracking” is selected by default.

image-20250115-155459.png

Settings

Status

“Tracking is active” is the default state. Pause and resume tracking via Viewtracker at any time. Interactions carried out when tracking was inactive will not appear in any Viewtracker reports.

Cache reports

“Caching is not active” is the default state. Enable the toggle to cache the page statistics for 10 minutes. As explained here, enabling this setting enhances Confluence performance on sites with high traffic volumes. However, this means that the numbers in the various Viewtracker reports will not be accurate for 10 minutes.

Blocking time

The blocking time (in milliseconds) defines a period during which the Viewtracker app will not track multiple views by the same user for the same page. A new view is only recorded once this blocking time has elapsed.

This setting does not apply to anonymous users, as it is not possible to determine whether repeated views originate from the same individual.

NEW Time Tracking

Time Tracking allows you to measure how much time users spend on pages and blog posts. This metric is disabled by default. Once activated, it begins recording when a user (whether logged in or anonymous) accesses a page or blog post on their desktop or mobile web browser. The duration of visits via the Confluence app cannot be measured.

The measurement of the user’s visit duration is paused under the following conditions:

  • When the user switches to another tab.

  • When the current Confluence page loses focus (e.g., the user opens another program or minimizes the browser).

  • If there is no recorded user activity for a defined timeout period (e.g., no mouse movements, clicks, focus changes, keyboard inputs, or scrolling).

Settings in Time Tracking

Minimum duration

Specifies the minimum time a user must remain on a page for their visit to be recorded and included in calculations.

Time out after

Indicates when the time measurement should stop if no user activity is detected. The measurement will resume once the user interacts with the page again. Once the browser tab containing this page is closed, the total time spent on the page is logged and included in the overall time calculations.

Limit time tracking to specific spaces

If you want to restrict time tracking to specific spaces, you can select or deselect spaces in this setting.

  • If no spaces are selected and time tracking is enabled, time spent on content will be measured across all spaces, except those that are explicitly excluded from tracking.

  • If one or more spaces are selected, time tracking will be limited to those selected spaces only. In all other spaces, only view counts will be recorded, not the time spent.

  • If time tracking is restricted to specific spaces, the “Average time spent” metric will not be displayed in the Global Report overview. This ensures that time-based data is only shown where tracking is actively applied.

  • It is not possible to specify spaces that have been excluded from tracking.

(info) Please note: The duration of visits is recorded and included in the calculation for "average time spent" and "total time spent" once this feature is activated.

  • Max. simultaneous Content & Usage Reports: The number of simultaneously created Content & Usage reports is limited to 4 by default. Decrease or increase the number if necessary.

  • Attachment File Types: see Attachment Tracking Settings

  • Search term length: Specify the minimum length of a search term that should be tracked in the Search Report. The default value is 3 characters.

  • Numbers in searches: Specify whether numbers in search terms should be tracked in the Search Report. By default, numbers are not tracked.


Related content

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.