Table of Contents

Children

 

Changes in Version 4.0:

 

Overview

Gain valuable insight into who is visiting your Confluence pages. The Viewtracker add-on provides more information than just counting page hits. It provides important user behaviour details, of who has viewed which Confluence pages, and how often the page has been visited.

Viewtracker Macro

Use the Viewtracker macro to track page views per users.

Viewtracker{viewtracker}
confluence-content

Parameter

NameDescriptionTypeThis is a required fieldDefaultValues
Hide
hide
Allows you to hide the tracked resultsbooleanfalse
Expandable
expandable
Enables the expansion of the listbooleantrue
Render User Names
renderusernames
Enables the creation of links to user profile pages in the list. Disable for better performance.booleantrue
Sort
sort
Sorts the list by date or nameenumdatedate, name
Time frame
timeframe
Specifies the time frame for displaying the tracked data. The time frame can either be a specific date or the number of days (for example 12would display all views tracked in the last twelve days). By default all tracked views are displayed.string
Date format
dateformat
Define the format of the date specified in timeframe, if it is in a different format than the default Confluence format defined in the formatting/international settings. Specify a format that matches the simple date format.string

Supplier Support

Examples

Simply place the Viewtracker macro on a Confluence page or blog post and your counter is ready to go:

{viewtracker}

Only display views tracked in the last 10 days:

{viewtracker:timeframe=10}

Only display views tracked after 01/01/2000 (if MM/dd/yyyy is your default format in Confluence):

{viewtracker:timeframe=01/01/2000}

or to specify it in a different format:

{viewtracker:timeframe=01.01.2000|dateformat=dd.MM.yyyy}

Screenshots

Recently Viewed Macro

Recently Viewed Pages{recently-viewed}
Displays pages you have recently visited in Confluence. This history is also available in the Recently Viewed content view from the "User" dropdown.
confluence-content

Parameter

NameDescriptionTypeThis is a required fieldDefaultValues
Hide header
hideHeader
Allows you to hide the header of the table.booleanfalse
Maximum number of results
maxResults
The maximum number of results to display.int20

Examples

Displays pages you have recently visited in Confluence:

{recently-viewed}

Only display the last 5 pages visited and hide the header of the table:

{recently-viewed:maxResults=8|hideHeader=true}

Screenshots

Viewtracker Report

Viewtracker Report{viewtracker-report}Documentation
confluence-content

Parameter

NameDescriptionTypeThis is a required fieldDefaultValues
Expandable
expandable
The report is closed by default and can be expanded.booleanfalse
Page
page
The page you want to display the tracked data from. Format: SPACEKEY:PAGETITLE, leave blank for current page.string
Render User Names
renderusernames
Enables the creation of links to user profile pages in the list. Disable for better performance.booleantrue
Sort
sort
Sorts the list by date or nameenumdatedate, name
Time frame
timeframe
Specifies the time frame for displaying the tracked data. The time frame can either be a specific date or the number of days (for example 12 would display all views tracked in the last twelve days). By default all tracked views are displayed.string
Date format
dateformat
Define the format of the date specified in timeframe, if it is in a different format than the default Confluence format defined in the formatting/international settings. Specify a format that matches the simple date format.string

Configuration

In the configuration of the Viewtracker plugin, which is in the Administration Console, you can configure the blocking time option and enable/disable space usage reports:

  1. In the add-on management section in the administration console of Confluence, select the Viewtracker plugin and click on "Configure":
     
  2. Configure the Viewtracker plugin:
     

Blocking Time

The blocking time (ms) defines the time period in between the Viewtracker macro doesn’t track multiple views per user for the same page.

Space Usage Reports

Space Usage Reports is an optional feature and can be enabled to show up in Space Administration. Feel free to override the default template with your custom report. For Space Usage Reports the Reporting Plugin and Viewtracker Supplier Add-on is required!

FAQ

Related articles

Support

 

Known errors and Feature requests

Comments  (0)

Attachments  (6)

Add Attachment
  File Modified
PNG File viewtracker-screenshot-2.png 03. Mar. 2014 by Remo Siegwart
PNG File viewtracker-screenshot-1.png 03. Mar. 2014 by Remo Siegwart
PNG File viewtracker-screenshot-3.png 03. Mar. 2014 by Remo Siegwart
PNG File viewtracker-plugin-config-2.png 03. Mar. 2014 by Remo Siegwart
PNG File viewtracker-plugin-config-1.png 03. Mar. 2014 by Remo Siegwart
PNG File viewtracker-logo.png 03. Mar. 2014 by Remo Siegwart