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.