Connect Google Analytics

Import your existing Google Analytics data into UserPath to maintain historical context while transitioning to a more powerful, AI-driven analytics platform. UserPath makes it easy to migrate your data and continue tracking without losing insights.

Understanding Google Analytics Integration

UserPath's GA4 integration provides comprehensive data migration:

Intelligent Data Import

Automatically import and transform your Google Analytics data for seamless transition

• Historical data import
• Intelligent event mapping
• Purchase event detection
• Geographic data preservation
• Device and browser mapping

What Gets Imported

UserPath imports comprehensive data from your Google Analytics properties:

• Page Views: All page view events with URLs and referrers
• User Sessions: Session data with device and geographic information
• Events: Custom events, goals, and conversion tracking
• E-commerce: Purchase events, revenue, and transaction data
• Geographic Data: Country, region, and city information
• Device Information: Desktop, mobile, tablet usage patterns
• Traffic Sources: Referrers, campaigns, and acquisition data

Data Transformation

UserPath intelligently transforms GA data to match its event schema:

Event Mapping:

• page_view → UserPath page view events
• purchase → UserPath purchase events with revenue
• session_start → UserPath session tracking
• first_visit → UserPath new user identification
• Custom events → Preserved with original names and properties

Setting Up Google Analytics Integration

Prerequisites

Before connecting Google Analytics:

1. Google Account Access: Admin access to your GA4 property
2. UserPath Account: Active UserPath account with appropriate permissions
3. GA4 Property: Universal Analytics is not supported (GA4 only)
4. Data Export Permissions: Viewer or higher role in Google Analytics

Connection Process

Connect your Google Analytics property to UserPath:

1. Go to Dashboard → Integrations → Connect Google Analytics
2. Or use the Command Palette (⌘+K) from any page within the Dashboard
3. Authenticate with your Google account
4. Select the GA4 property to import
5. Configure import settings (conversion tracking, date range)
6. Review and confirm the integration
7. Monitor import progress
8. Check the Dashboard or ask questions in the chat

Import Configuration

Conversion Settings

Configure how UserPath handles conversion and purchase data:

Time Zone and Date Range

UserPath respects your Google Analytics time zone and imports historical data:

Default Import Period:

• Retroactive: Last 3 months of historical data
• Time Zone: Automatically detected from GA property
• Data Continuity: Imports up to the integration start date

Custom Date Ranges:

• Specify custom start and end dates for import
• Maximum: 3 months of historical data per import
• One-time import: No ongoing synchronization

Data Import Process

UserPath's import process runs in several phases:

Phase 1: Data Validation

• Verify GA property access and permissions
• Validate date ranges and data availability
• Check for data quality issues

Phase 2: Event Retrieval

• Fetch events in chronological batches
• Handle API rate limits and pagination
• Apply data filters and transformations

Phase 3: Data Transformation

• Map GA events to UserPath schema
• Enrich with device and geographic data
• Generate session and user identifiers

Phase 4: Data Storage

• Store events in UserPath's analytics database
• Create indexes for optimal query performance
• Validate data integrity and completeness

Phase 5: Completion

• Send completion notification email
• Generate import summary report
• Enable analytics dashboard access

Event Mapping and Transformation

UserPath automatically maps common Google Analytics events:

Custom Event Preservation

UserPath preserves your custom Google Analytics events:

Enhanced Data Enrichment

UserPath enriches imported GA data with additional insights:

Geographic Enhancement:

• Convert GA location data to precise country codes
• Add city and region information where available
• Standardize geographic naming conventions

Device Classification:

• Enhanced device type detection (desktop, mobile, tablet)
• Browser identification and version mapping
• Operating system classification

Session Intelligence:

• Generate consistent session identifiers
• Calculate accurate session durations
• Identify user return patterns

Purchase Event Handling

UserPath intelligently handles Google Analytics e-commerce data:

E-commerce Event Processing

How purchase events and revenue data are imported:

Purchase Event Mapping

GA purchase events become UserPath purchase events:

Smart Purchase Detection

UserPath can automatically detect purchase-like events:

Detection Patterns:

• URLs containing /checkout/, /purchase/, /success/
• Events with names like conversion, lead, signup
• Form submissions on pricing or contact pages
• Goal completions in Google Analytics

Data Retention and Management

Imported Data:

• Imported GA data becomes part of your UserPath analytics
• Data remains accessible even after disconnecting GA
• Subject to your UserPath data retention policy
• Can be exported or deleted per data protection requirements

Ongoing Sync:

• UserPath imports historical data once during setup
• No ongoing synchronization with Google Analytics
• New events are tracked via UserPath's own pixel
• GA data only serves as historical baseline for continuity