The Autohive Google Analytics integration connects your Google Analytics 4 properties with Autohive’s automation platform, enabling:

  • Standard reports - Run customized reports with dimensions and metrics for comprehensive analytics data
  • Realtime reports - Get real-time analytics data for the last 30 minutes with active user monitoring
  • Metadata discovery - Retrieve all available dimensions and metrics for your property before building reports
  • Batch processing - Run multiple reports in a single API call for efficient data retrieval
  • Date range filtering - Filter data by flexible date ranges with both absolute and relative formats
  • Pagination support - Handle large datasets with limit and offset controls for efficient data management
  • Event tracking - Access all GA4 event data for detailed user behavior analysis
  • Custom dimensions and metrics - Use any available GA4 dimension and metric combination for tailored reporting

Install the integration

  1. Set up Google Analytics OAuth2:

    • Ensure you have a Google Analytics 4 property set up
    • Note your GA4 Property ID (found in Google Analytics Admin)
    • Create OAuth2 credentials in Google Cloud Console with Analytics Data API access

  2. Log in to Autohive and navigate to Your user profile > Connections or Your workspace -> Manage workspace

  3. Locate the Google Analytics Integration card and click Connect

    List of integrations in Autohive

  4. Authorize with Google - you’ll be redirected to Google’s authorization page

  5. Review and approve permissions. Autohive requests access to:

    • Read-only access to Google Analytics data (analytics.readonly scope)

    Ensure you approve the permissions required in order for the integration to function as expected.

  6. Confirm installation - you’ll be redirected to Autohive with “Connected” status displayed

Use the integration

You can now use the integration with your agents, workflows and scheduled tasks!

  1. Follow our Create your first agent guide on how to create an agent.
  2. In the ‘Agent settings’, scroll down to the ‘Add capabilities’ section and turn on the Google Analytics capability. You can choose what individual Google Analytics capabilities to turn on and off.
  3. Once the settings have been selected, begin prompting the agent of the workflow you’d like to achieve with Autohive and Google Analytics!

Available capabilities

Report Generation

  • Run Report: Generate customized reports with dimensions, metrics, date ranges, and pagination controls
  • Run Realtime Report: Get real-time analytics data for the last 30 minutes with active user and engagement metrics
  • Batch Run Reports: Run multiple reports in a single API call for efficient data retrieval and analysis

Metadata and Discovery

  • Get Metadata: Retrieve all available dimensions and metrics for your property with descriptions and API names

Key features

Comprehensive GA4 Data Access

  • Access to all Google Analytics 4 event data with full dimension and metric support
  • Real-time data monitoring for active users and current activity within 30 minutes
  • Historical data analysis with flexible date range filtering (absolute and relative dates)
  • Custom report building with any dimension and metric combination

Efficient Batch Processing

  • Run multiple reports in a single API call to reduce API quota consumption
  • Retrieve different data views with varied dimensions and metrics simultaneously
  • Optimize report generation workflows with parallel data retrieval
  • Reduce latency and improve performance for complex analytics needs

Flexible Date Handling

  • Absolute date formats (YYYY-MM-DD) for specific time periods
  • Relative date formats (today, yesterday, NdaysAgo) for recurring reports
  • Multiple date ranges in a single report for comparison analysis
  • Support for custom date range calculations and dynamic reporting

Metadata Exploration

  • Discover all available dimensions and metrics before building reports
  • Get detailed descriptions and API names for accurate report construction
  • Understand data availability and structure for optimal report design
  • Cache metadata results to reduce API calls and improve efficiency

Common use cases

Automated Analytics Reporting

  • Generate daily, weekly, or monthly analytics reports automatically
  • Schedule recurring reports with relative date ranges (e.g., “last 7 days”)
  • Distribute formatted analytics data to teams via email or messaging platforms
  • Create executive dashboards with key metrics and performance indicators

Real-Time Monitoring and Alerts

  • Monitor active users and engagement metrics in real-time
  • Set up alerts for unusual traffic patterns or activity spikes
  • Track campaign performance and conversion events as they happen
  • Monitor website health and user experience with live data

Multi-Dimensional Analysis

  • Compare performance across different dimensions (country, device, channel)
  • Analyze user behavior by combining multiple metrics and dimensions
  • Create cohort analysis and segmentation reports automatically
  • Track conversion funnels and user journey analytics

Data Integration and Warehousing

  • Export Google Analytics data to external systems and data warehouses
  • Combine GA4 data with CRM, marketing, and sales data for unified analytics
  • Create custom data pipelines for business intelligence and reporting
  • Schedule automated data exports for backup and compliance

Campaign Performance Tracking

  • Monitor marketing campaign metrics and ROI automatically
  • Track user acquisition and engagement by source and medium
  • Analyze conversion rates and goal completions across campaigns
  • Generate campaign performance summaries for stakeholder reporting

Common dimensions and metrics

  • country: User’s country for geographic analysis
  • city: User’s city for local market insights
  • region: User’s region for regional performance tracking
  • deviceCategory: Device type (mobile, desktop, tablet) for device analysis
  • browser: Browser used for compatibility and user preference tracking
  • operatingSystem: Operating system for platform analysis
  • pagePath: Page URL path for content performance tracking
  • pageTitle: Page title for content identification and analysis
  • eventName: Event name for user interaction tracking
  • date: Date in YYYYMMDD format for time-series analysis
  • activeUsers: Number of active users for audience size tracking
  • sessions: Number of sessions for engagement measurement
  • screenPageViews: Number of page/screen views for content popularity
  • bounceRate: Bounce rate for engagement quality assessment
  • averageSessionDuration: Average session duration for engagement depth
  • conversions: Number of conversions for goal completion tracking
  • eventCount: Total number of events for interaction measurement
  • engagementRate: Engagement rate for content effectiveness

Date range formats

Absolute Dates

  • Format: YYYY-MM-DD (e.g., “2024-01-01”, “2024-12-31”)
  • Use for specific time periods and historical analysis
  • Required format for fixed date ranges and compliance reporting

Relative Dates

  • today: Current day for up-to-date reporting
  • yesterday: Previous day for daily comparisons
  • NdaysAgo: N days before today (e.g., “7daysAgo”, “30daysAgo”, “90daysAgo”)
  • Use for recurring reports and automated schedules
  • Automatically adjust to current date for dynamic reporting

API quotas and rate limits

Google Analytics Data API Quotas

  • Daily requests: 25,000 API requests per day per project
  • Concurrent requests: 10 concurrent requests per property
  • Tokens per day: 250,000 tokens per day (approximately 5,000 requests)
  • Tokens per hour: 40,000 tokens per hour (approximately 800 requests)

Best Practices

  • Use batch_run_reports when you need multiple reports to reduce API call count
  • Set appropriate limit values to avoid retrieving unnecessary data and reduce token usage
  • Cache metadata results as they don’t change frequently and reduce API overhead
  • Use relative date ranges (e.g., “7daysAgo”) for recurring reports to maintain consistency
  • Consider using real-time reports only when necessary as they have stricter rate limits

Disconnect the integration

Important: Disconnecting stops data synchronization but preserves existing data in both systems.

  1. Navigate to Your user profile -> Connections or Your workspace -> Manage workspace
  2. Find the Google Analytics Integration
  3. Click Disconnect and confirm

Data Impact: Existing data remains unchanged in both systems, but sync stops and Autohive loses Google Analytics API access.

Remove access

From Google: Go to your Google Account > Security > Third-party apps with account access > Find Autohive and remove access