Viewtracker - Analytics for Confluence Cloud
Space shortcuts
Viewtracker - Analytics for Confluence Cloud VTCLOUD
Skip to end of metadata
Go to start of metadata

Please refer to our main documentation for the Migration Assistant for general instructions on how to migrate bitvoodoo apps.

The following information is specific for the app "Viewtracker - Analytics for Confluence" by bitvoodoo.


If you migrate your Viewtracker data from Server/DC to your Atlassian Cloud instance, there are several points you should be aware of.

  • Some Server/DC macros are incompatible with Cloud.
  • The tracked Viewtracker data (views, viewers) can be migrated automatically by Atlassian's Migration Assistant as of March 2021.

This document explains the differences and the steps you need to undertake to migrate data.


Macros 

Some macros from the Server version are not compatible with Cloud. 

To prevent you from getting the error "Unknown macro", we have marked the incompatible macros as "hidden" in our Cloud version. These macros don't have any output in Cloud.


MacroCurrent state

Viewtracker Macro

Not needed anymore because auto-tracking is enabled.
Viewtracker Report MacroNot needed anymore. This is now done with the built-in Viewtracker Reports.
Space Analytics MacroNot implemented yet, will be coming in a future release. Use the built-in Space Report instead.
Recently Viewed MacroRetired in our Cloud version. We introduced the Popular Content Macro instead.
Page Analytics MacroNot implemented yet, will be coming in a future release. Use the built-in Content Report instead.

Tracking

In the Cloud version, we removed the legacy Viewtracker Macro and implemented auto-tracking per default. So to start tracking views, you don't need to do anything.


Data Migration

Migrating the tracked data from Server to the Cloud requires several mappings. For example, the id of the page is different, and the key of the user differs. Viewtracker is using these two elements for tracking, so we need to change the Server data to Cloud data.

bitvoodoo implemented an automated migration path that is part of Atlassian's Migration Assistant. The process is explained in this document.

A maximum of 2 million Viewtracker views can be migrated in one go. If you have accumulated more than 2 million views, you need to split the migration into various batches.


Related content

Viewtracker - Analytics for Confluence Cloud VTCLOUD