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 menu > Admin > Sites & Settings.
In the Sites widget, select a site to integrate with Google Analytics 4.

Tip

If 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.

Tip

Brightspot 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. Average Time on Page (seconds)—Displays the average time a visitor spends on a given page, in seconds. Bounces—Displays the number of times a visitor visited one of your pages but then left your site. Page Views—Displays the number of views one of your pages has.
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: Sort dynamic lists by page view as described in Sorting dynamic lists by page views. Include page views in the search panel as described in Including page views in the search panel. Include page views in an asset's Analytics accordion as described in Viewing item-level analytics.
Site Reports	Type of reports to generate about traffic to your site: Device categories—Indicates types of devices visitors are using on your site. Demographics—Provides gender and age brackets. Referrals—Indicates how visitors arrive at your site, such as referral traffic from other sites or clicking links in search engines. Visits—Provides general information about site visits, such as number of sessions, users, and session duration. For more details, see [GA4] About Analytics sessions.
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. None—No ingestion occurs. Cron Expression—A cron expression specifying the times at which you want to ingest data. For example, entering `0 15,45 * * * ? ` ingests analytics every hour at 15 and 45 minutes after the hour. (A good utility for composing cron expressions is at freeformatter.com.) Schedule Builder*—A set of accordions for configuring the ingestion intervals. For more information, see Configuring analytics ingestion intervals with the schedule builder. 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.

Previous Topic

Adding the Google Analytics 4 integration

Next Topic

Retrieving Google Analytics 4 custom event data in Brightspot