Skip to main content

Overview

The Google Analytics server enables AI assistants to interact with Google Analytics, providing comprehensive analytics data access including account management, property configuration, custom dimensions and metrics, realtime reporting, and historical data analysis through the Google Analytics Data API.

How to Add Google Analytics

1

Add Server

Add the Google Analytics server to your Civic environment through the server directory.
2

Authorize

Simply log in with your Google account and approve the OAuth consent request. No admin approval needed.
3

Test Connection

Try “Show me my Google Analytics account summaries” to verify the connection works.
Simple OAuth Consent: Google Analytics uses standard Google OAuth consent. Works with personal Google accounts and Google Workspace without special admin approval.

What You Can Do

Account & Property Management

List accounts, properties, and Google Ads links

Custom Configuration

Retrieve custom dimensions and metrics for properties

Realtime Reporting

Run realtime reports with current visitor data

Historical Reporting

Generate data reports with date ranges and complex filtering

Available Tools (6)

Account & Property Operations

Retrieve information about all Google Analytics accounts and properties accessible to the user. Returns account and property details for configuration.
Get detailed information about a specific Google Analytics property by property ID. Property ID can be a number or “properties/123” format.
Retrieve custom Core Reporting dimensions and metrics defined for a specific property. Essential for understanding available custom data fields.

Reporting Operations

Run a Google Analytics Data API realtime report showing current visitor activity. Supports realtime dimensions and metrics, filtering with FilterExpression, ordering with OrderBy, and pagination. Returns up to 10 rows per request.
Run a Google Analytics Data API historical report with date ranges. Supports standard and custom dimensions/metrics, complex filtering with FilterExpression, ordering with OrderBy, pagination, and currency code specification. Returns up to 10 rows per request.

Use Cases

Account Discovery

“Show me all my Google Analytics accounts and properties” - List accessible analytics configurations.

Property Details

“Get information about property 123456789” - View specific property configuration. “List all Google Ads links for my property” - View advertising account connections.

Custom Configuration

“Show me the custom dimensions and metrics for property 123456789” - Understand available custom data fields.

Realtime Monitoring

“Show me current active users by country in realtime” - Monitor live visitor activity with dimensions like country and metrics like activeUsers.

Realtime Event Tracking

“Get realtime data for ‘purchase’ events” - Track specific events as they happen using dimension filters.

Historical Analysis

“Show me page views for the last 30 days by page path” - Analyze historical data with date range “30daysAgo” to “yesterday”.

Date Range Comparison

“Compare January 2025 vs February 2025 traffic” - Use multiple date ranges to compare periods.

Event Filtering

“Show events from google / cpc source” - Apply dimension filters to segment data by traffic source.

Metric Filtering

“Find pages with more than 100 views” - Use metric filters to find high-performing content.

Sorted Reports

“Show top 10 pages by event count descending” - Apply OrderBy to sort results by metrics.

Currency Conversion

“Show revenue in EUR instead of default currency” - Specify ISO4217 currency code like “EUR”, “USD”, or “JPY”.
Property ID Format: Accepts either a number (e.g., 123456789) or string format “properties/123456789”.Report Limits: Both run_realtime_report and run_report return maximum 10 rows per request. Use offset for pagination to retrieve additional data.Date Ranges: Supports absolute dates (“2025-01-01”) and relative dates (“yesterday”, “today”, “30daysAgo”).Filtering: Uses Google Analytics Data API FilterExpression with support for:
  • Simple filters (string_filter, numeric_filter, in_list_filter, empty_filter)
  • NOT expressions
  • AND/OR group filters
  • Independent dimension_filter and metric_filter application
Filter Limitations: dimension_filter and metric_filter are applied independently. Complex combinations like (dimension1 AND metric1) OR (dimension2 AND metric2) require multiple report requests or client-side filtering.Dimensions & Metrics:
  • run_realtime_report: Only realtime dimensions and metrics from Realtime API Schema
  • run_report: Standard dimensions/metrics from API Schema plus custom dimensions/metrics from get_custom_dimensions_and_metrics
Ordering: Use OrderBy objects to sort by dimensions (with order_type: ALPHANUMERIC, CASE_INSENSITIVE, NUMERIC) or metrics in ascending/descending order.

Guardrails

In addition to the 14 universal guardrails, this server has 41 server-specific guardrails across 6 operations.
GuardrailOperationTimingDescription
Filter Account IDsget_account_summariesResponseFilters out specific account IDs from results
Filter Industry Verticalget_account_summariesResponseFilters properties by industry vertical
Hide Property IDsget_account_summariesResponseHides property IDs for restricted properties
Limit Accounts Returnedget_account_summariesResponseLimits number of accounts returned
Redact Admin Emailsget_account_summariesResponseRedacts email addresses of account administrators
Block Sensitive Propertiesget_custom_dimensions_and_metricsRequestBlocks access to properties with sensitive data
Filter Custom Dimensionsget_custom_dimensions_and_metricsResponseFilters custom dimensions by name pattern including PII-related dimensions
Restrict Custom Dimension Propertiesget_custom_dimensions_and_metricsRequestRestricts to specific property IDs
Block Property Patternsget_property_detailsRequestBlocks properties matching certain patterns
Restrict Property IDsget_property_detailsRequestRestricts to approved property IDs only
Block Ads Property Patternslist_google_ads_linksRequestBlocks access to certain property patterns
Redact Conversion Trackinglist_google_ads_linksResponseRedacts conversion tracking details
Restrict Ads Link Propertieslist_google_ads_linksRequestRestricts Google Ads links to specific property IDs only
Block Realtime Revenue Metricsrun_realtime_reportRequestBlocks revenue and conversion metrics
Block Sensitive Dimension Combinationsrun_realtime_reportRequestBlocks sensitive dimension combinations
Filter Realtime PIIrun_realtime_reportResponseFilters rows containing PII
Filter Realtime Revenuerun_realtime_reportResponseFilters revenue and monetary metrics
Hide Realtime Geo Detailsrun_realtime_reportResponseHides geographic data below country level
Limit Realtime Dimensionsrun_realtime_reportRequestLimits number of dimensions requested
Limit Realtime Metricsrun_realtime_reportRequestLimits number of metrics requested
Realtime Row Limitrun_realtime_reportRequestEnforces maximum row limit
Redact Realtime User IDsrun_realtime_reportResponseRedacts user identifiers from results
Restrict Realtime Propertiesrun_realtime_reportRequestRestricts realtime reports to specific property IDs
Block Report Dimension Combinationsrun_reportRequestBlocks sensitive dimension combinations
Block User-Scoped Dimensionsrun_reportRequestBlocks user-scoped dimensions
Filter IP Addressesrun_reportResponseFilters IP address information
Filter Report PIIrun_reportResponseFilters PII from dimension values
Filter Transaction IDsrun_reportResponseFilters transaction IDs
Hide Report Geo Detailsrun_reportResponseHides detailed geographic information
Limit Report Dimensionsrun_reportRequestLimits number of dimensions
Limit Report Metricsrun_reportRequestLimits number of metrics
Redact Report Emailsrun_reportResponseRedacts email and phone dimensions
Redact Report User IDsrun_reportResponseRedacts user identifiers
Report Row Limitrun_reportRequestEnforces maximum row limit
Restrict Report Propertiesrun_reportRequestRestricts reports to approved property IDs
Redact Phone Numbers(all operations)ResponseRedacts phone numbers (international formats) from responses
Configure guardrails via the Civic UI or ask the Configurator Agent: “Add guardrails to my Google Analytics server.”