Configuring a site to retrieve Google Analytics 4 data
After the Google Analytics 4 integration has been added to Brightspot (as outlined in Adding the Google Analytics 4 integration), you can configure Brightspot to retrieve analytics data for specific sites and assets..
To configure Brightspot to retrieve Google Analytics 4 data:
- Click > Admin > Sites & Settings.
In the Sites widget, select a site to integrate with Google Analytics 4.
TipIf you only have one set of credentials for your Google Analytics account, you can set those credentials under the Global site, and they will cascade down to all of your other sites. The value in the Credentials field is the only value that cascades down to your other sites. You must still enter the Property ID and remaining settings for each site for which you want to retrieve Google Analytics 4.- Under the Integrations tab, expand Google Analytics 4.
Using the following table as a reference, complete the fields as needed.
TipBrightspot displays a message validating whether or not the analytics integration has been configured properly.- Click Save.
- Change to the Global site.
- Under the Integrations tab, expand Google.
- Verify that the Task Host field contains the name of the host running the import from Google Analytics.
Google Analytics 4 settings—Integrations tab
Field |
Description |
---|---|
Enable Google Analytics Import | Toggle on to turn on the Google Analytics 4 integration. When toggled off, none of your sites can leverage the integration. This setting is only available on the Global site. |
Metrics to Display | Metrics to display in the Analytics widget on an asset's content edit page. If none are selected, all metrics will be displayed. Requires toggling on Page Report Enabled.
|
Custom Events to Display | Page-level custom events to display in the Analytics widget on the content edit page for a given asset. You must first create page-level custom events before they populate this field. For details, see Retrieving Google Analytics 4 custom event data in Brightspot. |
Credentials | Private JSON key that was downloaded from the Google API service account as described in Creating a Google API service account. Copy the key into this field, including the opening and closing braces. You can set the Credentials at the Global site level and have that value cascade down to all of your other sites, or you can enter unique credentials for each site if you have per-site Google Analytics credentials. Credentials entered at the site level always supersede those entered at the Global level. For example, you would use different credentials if your organization has different GCP Service Accounts with access to different Google Analytics accounts and properties. |
Property ID | ID of the property that was generated in your Google Analytics account as described in Creating a Google Analytics account. You can configure your account to have multiple properties, each with a different set of data. |
Import Time Zone | Set the time zone for your data import. This setting must match the time zone of the same property as specified in the Property ID field above. |
Page Report Enabled | Toggling on this setting allows the import of page views data at the per-page level. In addition, the following features become available:
|
Site Reports | Type of reports to generate about traffic to your site:
|
Custom Events | Custom events that Brightspot retrieves and displays either at the page level or at the site level. For details on how to create custom events, see Retrieving Google Analytics 4 custom event data in Brightspot. |
Analytics Import Task Schedule | Times at which you want to ingest data from Google Analytics 4.
This setting is only available on the Global site. |
Historical Days to Import | Number of days' data to import from Google Analytics. The default value for this field is 30 (days). This setting is only available on the Global site. |