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 previewing an asset.
Note - Per Google's API documentation, 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.
Creating a Google Analytics Connector
To create a Google Analytics Connector:
- Navigate to Manage Site > Connectors.
- Navigate to the container in which the new Connector will be stored, or create a new container using Add > Container.
- Click Add > Connector.
- 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.
- In the Name field, enter the name for your Connector.
- In the Parent Container field, select a container for your Connector, if desired.
- In the View ID field enter the View ID of the profile you wish to pull data from in Google Analytics.
Note: The View ID is found under Admin > View Settings > View ID and is not the same as the Tracking ID (UA-XXXXXX-X).
- 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".
- Click Submit.
Verifying/Unverifying the Google Analytics Connector
To verify/unverify your Google Analytics Connector:
- While viewing (but not editing) the Connector, click Verify.
- A new link will appear that says Click here to allow and "Verify" again.
- The link will open a new window/tab to Google to grant Cascade access to the Google Analytics account.
- If you're not already logged in, enter the account credentials which have access to the profile.
- Copy the authentication token presented to you:
- 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.