Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.curator.interworks.com/llms.txt

Use this file to discover all available pages before exploring further.

Curator supports integration with popular web analytics platforms so administrators can track page views, user engagement, and Dashboard interactions. Analytics tracking is configured in the Curator backend under Portal Settings > Analytics.

Supported Platforms

Curator supports the following analytics platforms. You can enable one or more simultaneously:
PlatformTracking MethodUser Identification
Google Analytics (Universal Analytics)Page views and custom events via analytics.jsNot sent
Google Analytics 4 (GA4)Page views and custom events via gtag.jsuser_id set to Curator username
Google Tag Manager (GTM)Container-based tag managementuser_id pushed to dataLayer
MatomoPage views, events, and site search via matomo.jssetUserId set to Curator username

Configuration

Navigate to Portal Settings > Analytics in the Curator backend. All fields are optional. Fill in only the fields for the platform(s) you use.

Google Analytics (Universal Analytics)

Google Analytics Tracking ID (Universal Analytics) — Your Universal Analytics tracking ID (e.g., UA-XXXXXXXX-X). Enables the analytics.js tracker, which sends an automatic page view on each page load.
Universal Analytics was sunset by Google in July 2024. If you are setting up analytics tracking for the first time, use Google Analytics 4 or Google Tag Manager instead.

Google Analytics 4 (GA4)

Google Analytics Tracking ID (Google Analytics 4) — Your GA4 measurement ID (e.g., G-XXXXXXXXXX). Enables the gtag.js tracker with automatic page views. If a user is logged in, their Curator username is sent as the user_id property.

Google Tag Manager (GTM)

Google Analytics Tag Manager Container ID — Your GTM container ID (e.g., GTM-XXXX). Loads the GTM container script on every page. If a user is logged in, their Curator username is pushed to the dataLayer as user_id before the container loads.
When using Google Tag Manager, you manage your analytics tags (including GA4) within GTM itself. You do not need to also fill in the GA4 field unless you want a separate, direct GA4 integration outside of GTM.

Matomo

  • Matomo Server URL — The URL of your Matomo instance (e.g., //matomo.example.com/). Must include a trailing slash.
  • Matomo Site ID — The numeric site ID configured in your Matomo instance (e.g., 1).
  • Enable Matomo Heartbeat — When enabled (default: on), Matomo tracks actual time spent on the page by monitoring whether the browser tab is active and in focus.
Both the Matomo Server URL and Matomo Site ID must be provided for Matomo tracking to activate. If a user is logged in, their Curator username is sent via setUserId. Matomo link tracking and download tracking are enabled automatically.

Tracked Events

When analytics is configured, Curator automatically tracks user interactions as events. All events are sent to every enabled analytics platform. Events use the category Dashboard and include the following actions:
EventDescription
Custom View AppliedUser applied a saved Custom View
Custom View CreatedUser created a new Custom View
Custom View Made PrivateUser changed a Custom View to private
Custom View Made PublicUser changed a Custom View to public
Custom View RemovedUser deleted a Custom View
Custom View Set as DefaultUser set a Custom View as the default
Data-Driven Alert CededUser left a data-driven alert
Data-Driven Alert JoinedUser joined a data-driven alert
Download WorkbookUser downloaded a workbook
Exported All Summary DataUser exported all summary data
Exported CSVUser exported data as CSV
Exported DataUser exported data
Exported ExcelUser exported data as Excel
Exported ImageUser exported a Dashboard as an image
Exported PDFUser exported a Dashboard as PDF
Exported PowerpointUser exported a Dashboard as PowerPoint
Exported Tableau-based PowerpointUser exported a Tableau-based PowerPoint
Exported Workbook Summary DataUser exported workbook summary data
FavoritedUser favorited a Dashboard
Filter AppliedUser applied a filter
FullscreenUser entered fullscreen mode
Parameter AppliedUser applied a parameter
PausedUser paused automatic updates
Powerpoint New SlideUser added a new PowerPoint slide
Powerpoint Slide DeletedUser deleted a PowerPoint slide
Powerpoint Slides ClearedUser cleared all PowerPoint slides
Print Dashboard ImageUser printed a Dashboard image
Refresh Timer StartUser started an automatic refresh timer
SharedUser shared a Dashboard
UnfavoritedUser unfavorited a Dashboard
UnpausedUser resumed automatic updates

Site Search Tracking

Curator also tracks site searches when a user uses the search feature:
  • Google Analytics 4: Tracked using the built-in search event with a search_term parameter.
  • Matomo: Tracked using the trackSiteSearch API with the search term, category, and result count.
  • Google Analytics (Universal Analytics): Tracked as a page view to /search?q={searchTerm}. This only applies when Beta Search is enabled, since the /search route does not exist under the standard search.

Custom Dimensions

Events include custom dimensions that provide additional context. These dimensions are sent when available:
DimensionGA4 ParameterMatomo Dimension
Usercustom_parameter_userdimension4
Valuecustom_parameter_value_strdimension3
Workbookcustom_parameter_workbookdimension1
Worksheetcustom_parameter_worksheetdimension2
For Matomo, custom dimensions must be configured in your Matomo instance with matching dimension IDs for the data to be recorded correctly.

Internal Logging

In addition to sending events to external analytics platforms, Curator logs all analytics events internally using its client-side logging utility. These log entries are visible in the browser developer console when client-side logging is enabled, which can be helpful for verifying that events are firing correctly during setup.