Google Analytics settings

Connect Google Analytics / Disconnect (Connect Google)

Starts a Google sign-in popup. The connection is site-level: one admin connects once and the whole site uses it. Needed for reports in Confluence, the data stream and secret pickers, and custom dimensions. Not needed for page views.

GA4 property (Connect Google)

The property every report in Confluence reads from. It also scopes the data stream, API secret and custom dimension controls.

Data stream (View tracking)

Picking a web data stream fills in the Measurement ID. Add or edit streams in Google Analytics opens Google in a new tab.

Measurement ID (View tracking)

The GA4 tag ID (G-XXXXXXXXXX). The one required setting: nothing is collected until it is set. Enter a measurement ID manually instead lets you type it without connecting Google.

Use UA tag instead (View tracking)

Accepts a legacy Universal Analytics ID (UA-XXXXXX-Y). Google stopped processing UA data in 2023, and server-side events need a GA4 ID.

Measurement Protocol API secret (Enhanced tracking)

Turns on the server-side events: search queries, comments added, pages created or updated, and reactions. Pick an existing secret, or use the + button to create one in your data stream. The first secret on a property asks you to accept Google's terms (I acknowledge). Enter a secret manually instead takes a pasted secret. Picking or creating saves at once.

Custom dimensions (GA4) (Enhanced tracking)

Sync dimensions creates the app's 15 custom dimensions in your property: five required ones that back the core reports and ten optional ones that each unlock a filter. It adds only what is missing and never renames anything. Refresh re-reads what Google has. Appears once Google is connected and a property is chosen.

Who can view reports (Reporting)

Confluence admins only (the default), Specific groups (the groups you add plus site admins) or All logged-in users. Covers the report pages, Page analytics, the home page card and the macro. It never changes who is tracked.

Allowed groups (Reporting)

Shown for Specific groups. Add groups picks them. An empty list means only Confluence admins.

Turn off Google Analytics reports in Confluence (Other options)

Turns off the report pages, Page analytics and the macro. The menu entries stay and explain that reports are turned off. Tracking carries on.

Show sensitive data panels (Other options)

Adds the Raw (accessed paths) and Searches report tabs, which can expose URLs and search terms. Saved immediately.

Send Atlassian account IDs to Google Analytics (Other options)

Off by default, when people reach Google only as a one-way hash. On, every new event also carries the raw Atlassian account ID, so people are named directly. Existing data is not changed, and turning it off does not remove IDs already sent.

Allow Google Ads signals (Other options)

Off by default; leave it off. Linked Google Ads destinations try to load scripts that cannot work inside Confluence. Page views reach Google either way.

Tracking diagnostics

Run live check and Recent events read Google's realtime data. Check tracker config tests whether readers' browsers can see your settings, with Publish now if not. Copy info copies a bundle for support. Verbose tracking logs logs every event until you turn it off.

Published site generators

Ready-made snippets for sites published with Refined (an HTML script tag) or Scroll Viewport (JavaScript), so published views join up with views in Confluence.

Save configuration

Saves everything not marked as saving immediately, and republishes the settings that readers' browsers pick up.

Capable analytics integration (Capable Sites)

Set in the published site's Integrations settings in Capable Sites, not here. Turns on tracking of the published site, tagged with the Confluence space, page ID, type and version.

Cookie consent popup (Capable Sites)

Also set in Capable Sites. Shows a cookie banner on the published site and blocks analytics until the visitor accepts.