Google Integrations
Iverton AI integrates with multiple Google services to provide analytics, data export, single sign-on, and performance monitoring capabilities.
Google Analytics 4
Connect your GA4 property to view traffic data, user behavior, conversions, and real-time statistics directly in Iverton AI.
Prerequisites
Before connecting, ensure you have:
- A Google Analytics 4 property (not Universal Analytics)
- Admin or Editor access to the GA4 property
- A Google account with access to the property
Connecting Google Analytics 4
- Go to Integrations in the main sidebar
- Find Google Analytics in the Analytics & SEO category
- Click Connect
- Sign in with your Google account
- Select the GA4 property you want to connect
- Grant the requested permissions
Permissions Requested
When connecting, Google will ask you to grant these permissions:
| Permission | Why It's Needed |
|---|---|
| View your Google Analytics data | Read traffic, user, and conversion data |
| See and download your Google Analytics data | Export reports and metrics |
Iverton AI only requests read-only access. We cannot modify your GA4 configuration.
Selecting a Property
After authorization, you'll see a list of GA4 properties you have access to. Select the property for the client/project you're working on. You can change this later in the integration settings.
If you don't see your property:
- Verify you have at least Editor access in GA4
- Ensure it's a GA4 property, not Universal Analytics
- Check that the Google account has been added to the property
Available Data
Once connected, Iverton AI syncs the following data:
Traffic Overview
- Total users and new users
- Sessions and session duration
- Pageviews and pages per session
- Bounce rate
Real-Time Data
- Active users right now
- Top active pages
- Traffic sources in the last 30 minutes
- Geographic distribution of active users
Acquisition
- Traffic sources (organic, direct, referral, social, paid)
- Top referrers
- Campaign performance
- Source/medium breakdown
Engagement
- Top pages by views
- Average engagement time
- Events triggered
- Scroll depth
Conversions
- Conversion events
- Conversion rate
- Goal completions
- E-commerce transactions (if configured)
Demographics
- Geographic location (country, city)
- Device type (desktop, mobile, tablet)
- Browser and operating system
Using Analytics Data
After connecting, analytics data appears in several places:
Dashboard Widgets
- Add GA4 widgets to your client dashboard
- View key metrics at a glance
- Set date ranges for comparison
Reports
- Generate automated client reports with GA4 data
- Include traffic trends, top pages, and conversion metrics
- Schedule weekly or monthly report delivery
AI Recommendations
- Iverton AI analyzes your traffic patterns
- Get recommendations for content optimization
- Identify underperforming pages
Date Ranges
You can view data for different time periods:
- Last 7 days
- Last 30 days
- Last 90 days
- Custom date range
Comparison periods are automatically calculated (e.g., last 30 days vs. previous 30 days).
Troubleshooting GA4
"No data available"
- New properties may take 24-48 hours to show data
- Verify the property has traffic and tracking is installed
- Check that the correct property is selected
"Property not found"
- Your access may have been revoked in GA4
- Reconnect the integration with updated permissions
"API quota exceeded"
- GA4 has daily API limits (50,000 requests)
- Wait until the next day for the quota to reset
- Contact support if this happens frequently
Google Sheets
Export data from Iverton AI to Google Sheets for custom reporting, analysis, or integration with other tools.
Prerequisites
- A Google account
- Access to Google Sheets
Connecting Google Sheets
- Go to Integrations in the main sidebar
- Find Google Sheets in the Analytics & SEO category
- Click Connect
- Sign in with your Google account
- Grant the requested permissions
Permissions Requested
| Permission | Why It's Needed |
|---|---|
| See, edit, create, and delete spreadsheets | Create export sheets and update data |
| See, edit, create, and delete files | Access Sheets files in Drive |
Export Features
Manual Export
- Export any report or data table to a new Google Sheet
- Click the export button on reports, contact lists, or campaign data
- Choose to create a new sheet or append to an existing one
Scheduled Exports
- Set up automated data exports on a schedule
- Daily, weekly, or monthly exports
- Data appends to existing sheets with timestamps
Available Data for Export
- Contact lists and CRM data
- Campaign performance metrics
- Email marketing statistics
- Social media analytics
- Custom report data
Using Exported Data
Once exported, you can:
- Create custom charts and visualizations
- Share with team members or clients
- Use Google Sheets formulas for additional analysis
- Connect to other tools via Sheets integrations
Troubleshooting Sheets
"Cannot create spreadsheet"
- Check that you have available Google Drive storage
- Verify the Google account has Sheets access
"Permission denied"
- Reconnect the integration and grant all requested permissions
Google Workspace SSO
Allow team members to sign in to Iverton AI using their Google Workspace (formerly G Suite) accounts.
Prerequisites
- Google Workspace account (Business, Enterprise, or Education)
- Admin access to your Google Workspace domain
- A verified domain in Iverton AI
Enabling Google Workspace SSO
- Go to Settings → Security → Single Sign-On
- Select Google Workspace as the identity provider
- Enter your Google Workspace domain (e.g.,
yourcompany.com) - Click Configure
Domain Verification
Before SSO works, you need to verify domain ownership:
- Iverton AI provides a TXT record
- Add this record to your domain's DNS settings
- Click Verify Domain once the record is added
- Verification typically completes within a few minutes
User Provisioning
Automatic Provisioning
- When a user from your domain signs in for the first time, an Iverton AI account is created automatically
- Users are assigned the default role (typically Member)
Manual Provisioning
- Pre-create user accounts before they sign in
- Assign specific roles and permissions in advance
Team Member Experience
After SSO is enabled:
- Team members go to the Iverton AI login page
- Click Sign in with Google
- Select their Google Workspace account
- They're signed in automatically
Security Benefits
- No separate passwords to manage
- Leverage Google's security features (2FA, security keys)
- Centralized access control through Google Admin
- Automatic deprovisioning when users leave your organization
Troubleshooting SSO
"Domain not verified"
- Check that the TXT record is correctly added to DNS
- DNS propagation can take up to 48 hours
"User not authorized"
- Verify the user's email domain matches the verified domain
- Check if the user has been explicitly blocked
PageSpeed Insights
Monitor website performance and get optimization recommendations powered by Google's PageSpeed Insights API.
Prerequisites
- A website URL to monitor
- PageSpeed Insights API key (optional but recommended for higher limits)
Enabling PageSpeed Monitoring
- Go to Integrations in the main sidebar
- Find PageSpeed Insights in the Analytics & SEO category
- Click Configure
- Enter your PageSpeed API key (or use the default shared quota)
- Add the URLs you want to monitor
Getting an API Key
For higher API limits and dedicated access:
- Go to the Google Cloud Console
- Create a new project or select an existing one
- Enable the PageSpeed Insights API
- Create an API key under Credentials
- Copy the key and paste it into Iverton AI
Metrics Tracked
PageSpeed Insights analyzes your pages and provides:
Core Web Vitals
- Largest Contentful Paint (LCP): Loading performance
- First Input Delay (FID): Interactivity
- Cumulative Layout Shift (CLS): Visual stability
Performance Score
- Overall score from 0-100
- Breakdown by category (Performance, Accessibility, Best Practices, SEO)
Opportunities
- Specific recommendations to improve speed
- Estimated time savings for each fix
- Priority ranking
Diagnostics
- Detailed technical information
- Resource loading analysis
- JavaScript execution time
Performance Monitoring
Scheduled Checks
- Iverton AI runs PageSpeed tests on a schedule
- Daily, weekly, or on-demand checks
- Track performance trends over time
Alerts
- Get notified when performance drops below a threshold
- Receive alerts for Core Web Vitals issues
- Monitor before and after site changes
Using Performance Data
Performance data feeds into:
- Client Reports: Include performance scores in automated reports
- AI Recommendations: Get suggestions based on performance data
- SEO Analysis: Correlate performance with search rankings
Troubleshooting PageSpeed
"API quota exceeded"
- The shared quota has limited daily requests
- Add your own API key for dedicated quota
- Reduce the number of URLs or check frequency
"URL not accessible"
- Verify the URL is publicly accessible
- Check that the site isn't blocking Google's crawlers
- Ensure the URL doesn't require authentication
Disconnecting Google Services
Disconnecting Google Analytics
To remove the GA4 connection:
- Go to Integrations → Google Analytics
- Click Disconnect
- Confirm the disconnection
Your historical data in Iverton AI is retained, but no new data will sync.
Disconnecting Google Sheets
- Go to Integrations → Google Sheets
- Click Disconnect
- Confirm the disconnection
Existing exported sheets remain in your Google Drive.
Disabling Google Workspace SSO
- Go to Settings → Security → Single Sign-On
- Click Disable SSO
- Users will need to set passwords for direct login
Fully Revoking Access
To completely remove Iverton AI's access to your Google account:
- Go to Google Account Permissions
- Find "Iverton AI" in the list of connected apps
- Click Remove Access
This revokes all Google integrations (Analytics, Sheets, Workspace) at once.
API Endpoints Reference
For developers integrating with the Google services API:
Google Analytics Endpoints
GET /api/google-analytics/status - Check configuration status
GET /api/google-analytics/auth/:clientId - Initiate OAuth flow
GET /api/google-analytics/callback - OAuth callback handler
GET /api/google-analytics/properties/:id - List available properties
POST /api/google-analytics/properties/:id - Set selected property
GET /api/google-analytics/overview/:id - Get analytics overview
GET /api/google-analytics/traffic/:id - Get traffic data
GET /api/google-analytics/conversions/:id - Get conversion data
GET /api/google-analytics/pages/:id - Get top pages
GET /api/google-analytics/sources/:id - Get traffic sources
GET /api/google-analytics/geo/:id - Get geographic data
GET /api/google-analytics/devices/:id - Get device breakdown
GET /api/google-analytics/realtime/:id - Get real-time data
DELETE /api/google-analytics/disconnect/:id - Disconnect integration
Environment Variables
For self-hosted deployments, configure these environment variables:
# Google Analytics
GOOGLE_ANALYTICS_CLIENT_ID=your-client-id
GOOGLE_ANALYTICS_CLIENT_SECRET=your-client-secret
GOOGLE_ANALYTICS_REDIRECT_URI=https://your-domain/api/google-analytics/callback
# Google OAuth (for Sheets, Workspace)
GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret
# PageSpeed Insights
GOOGLE_PAGESPEED_API_KEY=your-api-key
# Google Maps (optional)
VITE_GOOGLE_MAPS_API_KEY=your-maps-api-key