Skip to main content
Skip table of contents

Configuration - Data Collection • Universal Analytics

Using Confluence Server? See Configuration - Confluence Server instead.

We recommend that you have multiple users within Google Analytics who have administrator permissions on the Google Analytics property.

Create a shared user for Google Analytics with administrator access and document how to access that shared user account in a page within your Confluence system.

If your original Confluence administrator leaves the company, then you will still be able to access your Google Analytics property and data.

Step 1 – In Google Analytics

If you have already created a Universal Analytics property in Google Analytics, you can skip this step.

This will send basic data only to Google Analytics.

  1. Sign in to your Google Analytics account 

  2. Setup a new property using “Universal Analytics”

Make sure that you configure Google Analytics with Universal Analytics rather than Google Analytics 4 (GA4). Google Analytics 4 migration timeline

Step 2 – In Confluence Cloud

In Confluence Administration, browse to Google Analytics in Confluence and click on the “G Sign In” (Sign in with Google) button

If the G Sign In button is not present and instead you see only some “Authorizing…” text, then you may have third-party cookies disabled.

See for more details.

A new “Sign in with Google” window opens – enter your Google Analytics username (email address) and press the Next button

Then enter your password and press the Next button

A new screen appears displaying that “David Simpson App Integrations for Google Analytics” wants access to view your Google Analytics data. Press the Allow button.

The “Sign in with Google” window closes and your Google Analytics property data is displayed within Confluence.

  1. Select the account, property and view that corresponds with your Confluence Cloud instance (if you only have one property, this will automatically be filled out), then press the Save button.

  2. On successfully saving your configuration, a message is displayed

Setting up custom dimensions

Custom dimensions allow you to send contextual information about Confluence content and their parent space over to Google Analytics. Without correctly configuring custom dimensions, the Google Analytics reports with Confluence will not work correctly.

The configuration screen within the app displays each necessary custom dimension and whether it has been configured correctly.

Any incorrect custom dimension will be displayed in green (like 6 & 11 below):

When all custom dimensions are configured correctly, there will be green checkmarks all round:

If you want to make use of the Custom Reports in Google Analytics or any of the reporting functionality within the app, then continue with the configuration...

In Google Analytics

Create custom dimensions as specified in Custom Dimensions.

  1. Select the Admin tab and navigate to the property to which you want to add custom dimensions.

  2. In the PROPERTY column, click Custom Definitions, then click Custom Dimensions.

  3. Click New Custom Dimension.

  4. Add a Name.
    This can be any string, but use something unique so it’s not confused with any other dimension or metric in your reports.

  5. Select the Scope.
    Choose to track at the Hit, Session, User, or Product level. Read more about scope and how custom dimensions are processed in our Developer Guide.

  6. Check the Active box to start collecting data and see the dimension in your reports right away. To create the dimension but have it remain inactive, uncheck the box.

  7. Click Create.

Once, this has been completed, go back to the Google Analytics in Confluence Configuration page and press the Reload Custom Dimensions button. If everything was done correctly, you will get a (tick) icon next to each custom dimension.

Further reading

You may also be interested in…

JavaScript errors detected

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

If this problem persists, please contact our support.