Google Analytics
Complete guide to connecting and configuring Google Analytics with your Mortar CMS organization.
Quick Start Guide
Connect Your Account
Navigate to your Mortar CMS platform and go to Connections → Google Analytics. Click "Connect Google Analytics" to start the OAuth authorization process.
Go to Google Analytics ConnectionAuthorize Access
You'll be redirected to Google's secure authorization page. Review the permissions and grant Mortar CMS read-only access to your Google Analytics data.
Map Properties
After connection, you'll see all your GA4 accounts and properties. Click "Add Mapping" next to any property to connect it to one of your Mortar CMS websites.
View Analytics
Once mapped, analytics data will appear in your website dashboards with real-time traffic, user behavior, and performance metrics.
Data Access & Privacy
Data We Access
- Account Information: Your Google Analytics accounts and properties
- Website Traffic: Page views, sessions, users, and bounce rates
- User Behavior: Popular pages, user flow, and engagement metrics
- Audience Data: Demographics, interests, and geographic information
- Conversion Data: Goals, events, and e-commerce tracking
Data We Don't Access
- Personal Information: Individual user identities or personal data
- Account Credentials: Your Google account password or login details
- Modification Rights: We cannot change your Analytics settings
- Other Google Services: Gmail, Drive, or other Google products
OAuth Permissions
Mortar CMS requests these specific OAuth scopes for GA4 access:
- • https://www.googleapis.com/auth/analytics.readonly
- • https://www.googleapis.com/auth/userinfo.email
- • https://www.googleapis.com/auth/userinfo.profile
GA4 Requirements
Important: Google has deprecated Universal Analytics (effective July 1, 2024). Mortar CMS only supports Google Analytics 4 (GA4) properties.
Before Connecting
- Ensure you have GA4 properties set up for your websites
- Verify you have admin access to your Google Analytics account
- Make sure GA4 tracking is properly installed on your websites
- Have permission to grant access to third-party applications
Need to Migrate from Universal Analytics?
If you're still using Universal Analytics, you'll need to set up GA4 properties first:
Property Mapping
Property mapping connects your GA4 properties to your Mortar CMS websites, enabling analytics data to appear in your website dashboards.
Mapping Strategies
One-to-One
Map one GA4 property to one website
Multiple Properties
Multiple properties track one website
Multi-Domain
One property tracks multiple websites
Primary Properties
You can designate one property as "primary" for each website. Primary properties are used as the default data source for dashboard widgets and automated reports.
Primary Property Benefits
- • Default data source for dashboard widgets
- • Highlighted in analytics reports and summaries
- • Used for automated insights and recommendations
- • Main property shown in website overview pages
How We Use Your Analytics Data
Dashboard Integration
- • Display traffic metrics in your website dashboard
- • Show popular pages and content performance
- • Track conversion goals and e-commerce data
- • Generate automated reports and insights
Audience Insights
- • Understand your website visitors better
- • Identify high-performing content
- • Track user engagement and behavior
- • Optimize content based on analytics data
Data Processing & Storage
- • Analytics data is cached locally for faster dashboard loading
- • Data is refreshed automatically every hour to stay current
- • All data is encrypted and stored securely in our infrastructure
- • You maintain full control over your data and can disconnect at any time
Troubleshooting
No Properties Found
If no properties appear after connecting:
- Verify you have GA4 properties set up (not just Universal Analytics)
- Check that you have admin access to the Google Analytics account
- Make sure you're connecting the correct Google account
- Try disconnecting and reconnecting with the account owner
Connection Errors
Token Expired
Click "Refresh" to renew the connection automatically
Access Revoked
You'll need to reconnect and re-authorize access
Data Not Updating
If your analytics data seems outdated:
- Data is automatically refreshed every hour - wait for the next sync
- Use the "Refresh" button for immediate data updates
- Check that your GA4 property is receiving data from your website
- Verify the property mapping is correct and active
Best Practices
Connection Management
- • Use a dedicated Google account for business analytics
- • Connect with an account that has long-term access
- • Regularly review connection status and health
- • Keep your GA4 properties organized and well-named
Property Mapping
- • Map properties to websites that match their tracking scope
- • Set primary properties for main analytics dashboards
- • Use descriptive names for properties in Google Analytics
- • Regularly audit mappings to ensure accuracy
Ready to Connect Google Analytics?
Start tracking your website performance with Google Analytics integration. The setup process takes just a few minutes.