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 table after step 8 as a reference, complete the fields as needed.Click Save.TipIf the integration has been configured properly, Brightspot displays a confirmation message. If no message appears, please review the data that you input to ensure it is correct.
- 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. |
| Credentials | Private JSON key that was downloaded from the Google API service account as described in Create a service account key. 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. Click Click here to validate your Google API credentials to validate that Brightspot can correctly communicate with Google's APIs. |
| Property ID | ID of the property that was generated in your Google Analytics account as described in Create a new Google Analytics 4 property. 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. |
| Import Schedule | Times at which you want to ingest data from Google Analytics 4.
This setting is only available on the Global site.
Caution
Before the first run of the task, Brightspot recommends ensuring that your Brightspot site URLs match the URLs in Google Analytics 4. If they do not match, analytics data will not pull in correctly.
|
| 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. |