Google Analytics Tracking

Introduction to Google Analytics Tracking in Omniscope

Omniscope includes built-in support for Google Analytics 4, allowing administrators to track how users interact with workflows and published reports and dashboards. This integration helps you understand user behavior, monitor engagement with specific features, and make data-informed improvements to your content. Whether you're interested in simple page tracking or more advanced interaction logging, Google Analytics provides a flexible and powerful way to gain visibility into how your Omniscope projects are being used.

This guide explains both the basic and extended configurations for integrating Google Analytics with Omniscope. Start with simple page usage tracking to confirm setup, and later expand to include more detailed interaction insights.

Basic Setup: Simple Page Tracking in Omniscope

You can quickly configure Omniscope to send basic page view data to your Google Analytics account. This is useful to verify that your integration is working and to start collecting general usage metrics.

To set up simple tracking:

1. Create or access your Google Analytics account at https://analytics.google.com and configure your Property.

2. Set up a Web Data Stream for the domain where Omniscope is hosted, and copy the Measurement ID (formatted as G-XXXXXXXXXX).

3. Open Omniscope and go to Admin > Tracking.

4. Paste the Measurement ID into the Tracking ID field.

5. Save your changes and refresh the page.

Once configured, Google Analytics will begin receiving page view events from Omniscope. These will appear in standard GA reports, typically within 24 hours. You can now proceed with the extended tracking configuration for deeper interaction analytics.

Setting Up Google Analytics for Extended Usage Tracking in Omniscope

To start collecting detailed usage tracking information using Google Analytics, follow the steps below.

1. Set Up Your Google Analytics Account - configure your Account and Property sections

If you don't already have a Google Analytics account, create one by visiting: https://analytics.google.com.

Once logged in. Create and configure your GA account. Fill in your account and property details.

Your admin section should look like this:

2. Add a Data Stream and Obtain Your Google Measurement ID (G-XXXXXXXXXX)

After setting up your account and property:

1. In the Google Analytics dashboard, go to Admin > Data Streams.

2. Click your Web data stream or create one.

3. You need to make sure to enter the domain name of the Omniscope server that your users access.

4. You need to specify HTTPS URL.

5. In the details panel, locate your Measurement ID — it will look like G-XXXXXXXXXX.
   This is the key you'll need to integrate with Omniscope.

3. Configure Google Analytics in Omniscope

Once you have your Measurement ID, follow these steps in Omniscope:

1. Open Omniscope and navigate to the Admin > Labs section.

2. Enable Extended Tracking (make sure you enable this first before going to the next admin section).

3. Navigate to the Admin > Tracking section.

4. Enter your G-XXXXXXXXXX Measurement ID in the Tracking ID field.

5. Make sure that Extended tracking option is enabled

6. Also enable the Debug mode option. This will help to verify that Google Analytics is actually receiving data from Omniscope. The data appears in Google Analytics reports with some delay (e.g. in some reports it might appear in a day).

This will begin sending interaction data from Omniscope to your Google Analytics account.

4. Define Key Events in Google Analytics

To make Omniscope interaction data available in Google Analytics reports and charts, you must define key events. Go back to Google Analytics admin website.

Create Key Events

1. Go to Admin > Data Display > Events.

2. Click Create event.

3. Add the following events you want to track (you can start with a few and expand later)

4. Make sure that you mark them as key events.

add_block, add_block_shape, add_page, add_shape, add_tab, add_view,

app_click, change_view_type, click, connect_block, delete_shape,

delete_tab, delete_view, dialog_view, duplicate_blocks,

duplicate_page, duplicate_tab, edit_block_data_option, edit_block_option,

edit_view_option, execute_blocks, group_blocks, move_page,

page_open, page_view, parameterise_block_option, purchase,

remove_blocks, rename_block, stop_block_execution, ungroup_blocks

Add Custom Dimensions (Event Parameters)

1. Go to Admin > Data Display > Custom Definitions.

2. Click Create Custom Dimension.

3. Add the following dimensions (event parameters):

block_option_path, block_type, component,

from_block_name, to_block_name,

view_option_name, view_preset_id

These dimensions provide context for events, helping to create analytics dashboards and reports.

5. Check that Omniscope sends tracking data and Google Analytics receives tracking (DebugView)

The steps above should begin sending interaction data from Omniscope to your Google Analytics account.

Note that Google Analytics does not display data in real time in most standard reports. Interaction data typically appears in charts and dashboards the following day.
This means that if something is misconfigured, you would normally have to wait another day to detect the issue.

To confirm that data is being sent correctly, we recommend verifying that Omniscope is successfully sending events and that Google Analytics is receiving them. To do this:

1. Ensure Debug Mode is enabled in Omniscope (Omniscope Admin > Tracking section).

2. Perform some interactions in Omniscope (e.g., add/remove/connect blocks, open a report, add/remove views).

3. In Google Analytics, go to Admin > Data Display > DebugView.

The DebugView allows you to see events as they are sent in near real time. While Google Analytics doesn’t show real-time data in its standard reports, DebugView provides a live stream of event data, helping you confirm that everything is working as expected.

6. Google Analytics charts and reports (data might appear in some reports only next day)

Go to the Explore section in Google Analytics, and either add one of the predefined charts or create your own custom free-form chart.

You can use events and dimensions we configured above to analyse the user activity.

7. Analyse data in Omniscope

Obviously you can use Omniscope to load the GA dataset and explore data visually using the GA connector, as described here https://help.visokio.com/support/solutions/articles/42000110203-connect-to-google-analytics-4

You will find events in the dimensions and metrics you have specified in GA, ready to be pulled and analysed in Omniscope.