Brightspot Integrations Guide

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:

  1. Click menu > Admin > Sites & Settings.
  2. In the Sites widget, select a site to integrate with Google Analytics 4.

    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.

  3. Under the Integrations tab, expand Google Analytics 4.
  4. Using the table after step 8 as a reference, complete the fields as needed.
    If 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.
    Click Save.
  5. Change to the Global site.
  6. Under the Integrations tab, expand Google.
  7. Verify that the Task Host field contains the name of the host running the import from Google Analytics.

Google Analytics 4 settings—Integrations tab

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.


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.

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 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:
  • 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.
Import 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
  • 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.

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.

Previous Topic
Adding the Google Analytics 4 integration
Next Topic
Retrieving Google Analytics 4 custom event data in Brightspot
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
Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

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

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

Google Analytics
Apple News