Brightspot Integrations Guide

Retrieving Google Analytics 4 custom event data in Brightspot


In Google Analytics 4, a custom event is a specific event that takes place on your site that you tell Google you want to track, like a particular form submission or a page scroll percentage. Custom events are often set up in your Google Tag Manager console (see [GA4] Custom events), and then associated with custom dimensions and metrics in your Google Analytics console (see [GA4] Custom dimensions and metrics).

To retrieve event data, you must create Brightspot records that connect to these custom dimensions and metrics in order to retrieve and view custom event data at the site level and page level.

To retrieve Google Analytics 4 custom event data in Brightspot:

  1. Click menu > Admin > Sites & Settings.
  2. In the Sites widget, select the site for which you want to configure this setting.
  3. Click search, located to the left of more_horiz, and type Custom Events.
  4. Under Custom Events, click add_circle_outline, then click search to open the content picker.
  5. In the Create menu, select one of the following options:
    • Page-Level Event (Custom Metric and Dimension)—Produces a custom event from a metric and dimension that appears at the page level in the Analytics widget.
    • Page-Level Event (Custom Metric Only)—Produces a custom event from a metric only that appears at the page level in the Analytics widget.
    • Site-Level Event (Custom Metric and Dimension)—Produces a custom event from a metric and dimension that appears at the site level in a Report widget.
    • Site-Level Event (Custom Metric Only)—Produces a custom event from a metric only that appears at the site level in a Report widget.
  6. Click New.
  7. In the Internal Name field, enter an internal name. Brightspot uses this name in selection fields.
  8. Do one of the following:
    • If creating a page-level or site-level dimension and metric record, select the applicable dimension and metric from the Dimension and Metric fields.
    • If creating a page-level or site-level metric only, select the applicable metric from the Metric field.
      Note
      • Dimensions with high cardinality (high uniqueness of data) should be avoided. Data will only be persisted for 200 unique dimension values.
      • If a dimension is selected, but no metric is selected, the eventCount metric will be used by default.
  9. Click Save.
    Caution
    Do not change the values after saving this record. Instead, create a new custom event to avoid polluting existing data for this custom event.
  10. Click Back.
  11. Select the custom event you just created from the content picker.
  12. Click Save.

Depending on the configuration you select, Brightspot is now able to display custom event data at the site level or page level.

Previous Topic
Configuring a site to retrieve Google Analytics 4 data
Next Topic
Adding Google Analytics 4 data to the search panel
Was this topic helpful?
Thanks for your feedback.
Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

Asset types
Module types
Page types
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

Content types
Modules
Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
Images
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

Google Analytics
Shopify
Apple News