Google Analytics Connector

Overview

The Google Analytics Connector syncs data from your Google Analytics account with Cascade CMS to provide users with basic analytics information for Sites, Pages, Files, and Folders. Site analytics data is available through a Dashboard widget, the Google Analytics Statistics report, and by viewing More > Analytics when viewing any of the Site, Page, File, or Folder asset types.

Creating a Google Analytics Connector

To create a Google Analytics Connector:

1. Navigate to  Manage Site > Connectors.
2. Navigate to the container in which the new Connector will be stored, or create a new container using  Add >  Container.
3. Click  Add >  Connector.
4. Select  Google Analytics and then click Choose.
   • If your selected site already has a Google Analytics Connector, you won't be able to add another unless you delete the existing Connector first.
5. In the  Name field, enter the name for your Connector.
6. In the  Parent Container field, select a container for your Connector, if desired.
7. In the View/Property ID field enter the View/Property ID of the profile you wish to pull data from in Google Analytics. 
   Note:  For Google Analytics 4, the Property ID is found in Admin > Property Settings > Property Details. For the older Universal Analytics, the View ID is found under Admin > View Settings > View ID and is not the same as the Tracking ID (UA-XXXXXX-X). 
8. Optionally, enter a value for the Base Path field.
   • The Base Path is a path segment that is removed from URLs imported from Google Analytics to help Cascade determine which asset corresponds to a particular URL.
   • An example of when the Base Path could be used is when a site in Cascade corresponds to a sub-folder off of a particular domain. For instance, an athletics-oriented site might be published to www.myuniversity.edu/athletics. In Cascade, there is no "athletics" folder because it is represented by a site. The URLs coming from Google Analytics, however, look like "/athletics/index.html".  In order for Cascade to be able to match the URL to a particular page inside Cascade, it would need to know that "/athletics" should be removed from the URL in order to successfully locate the matching Page "index".
9. Click Submit.

Google Analytics 4 data points

If you've been using the Connector to pull data from Universal Analytics, you'll notice a few differences in the data once you switch to Google Analytics 4.

Universal Analytics displayed Pageviews, Visits, Unique Pageviews, Average Time on Site, and Bounce Rate.

With Google Analytics 4, you'll see:

• Views
• Sessions
• Users
• Engagement Rate
• Average Engagement Time

You can find more about comparing metrics between Universal Analytics and Google Analytics 4 on the Google website.

Google Analytics 4 and Universal Analytics

Cascade CMS currently supports Universal Analytics Views and Google Analytics 4 (GA4) properties. However, Universal Analytics properties and views are being phased out. Standard Universal Analytics properties will stop collecting data on July 1, 2023 while 360 Universal Analytics properties will stop collecting data on July 1, 2024. Google recommends switching to GA4 as soon as possible

Switching your Connector to Google Analytics 4

You'll want to follow the migration guide to get set up Google Analytics 4 and start collecting data as soon as possible. To help, Google will automatically create a GA4 property for you.

Once you have a sufficient amount of data associated with the new Google Analytics 4, you can go ahead and switch to the GA4 version:

1. Edit your existing Connector and update the View/Property ID field to reference the GA4 
2. Re-verify the Connector
3. Either manually import data or wait for the scheduled data sync

Quotas, Limits and Errors

Universal Analytics quotas

If you're using the Connector to connect to Universal Analytics properties and views, there is a 25-token limit per Google account. Creating and verifying more than 25 Analytics Connectors in Cascade CMS will result in older connectors becoming unverified during the next sync. 

Verifying/Unverifying the Google Analytics Connector

To verify/unverify your Google Analytics Connector:

1. While viewing (but not editing) the Connector, click Verify.
2. A new link will appear that says Click here to allow and "Verify" again.
3. The link will open a new window/tab to Google to grant Cascade access to the Google Analytics account.
4. If you're not already logged in, enter the account credentials which have access to the profile.
5. Copy the authentication token presented to you:
    
6. Now that a new access token for your Google Analytics connector has been generated, copy the token, go back to the Connector verification dialog, paste the token into the field and click the Submit.