Integrations
Google Analytics 4
Connect GA4 to correlate AI visibility with real website traffic — track AI referrer sessions, landing page performance, and daily automated sync.
Overview
Connect your Google Analytics 4 property to see how AI visibility translates into real website traffic. AEO Optima identifies visits from AI referrer sources (ChatGPT, Perplexity, Claude, Gemini, etc.) and correlates them with your visibility scores.
What You Get
- AI referrer traffic — Sessions from ChatGPT, Perplexity, Claude, and other AI sources, broken out by source.
- Correlation analysis — See how changes in AI visibility scores align with traffic changes.
- Landing page performance — Which pages receive AI-referred traffic and how they perform.
- Automated daily sync — GA4 data is refreshed every day at 6AM UTC via a background cron job.
Prerequisites
- A Google Analytics 4 property (not Universal Analytics).
- The Google account must have Viewer access or above on the GA4 property.
- Your AEO Optima plan must be Pro-Individual or above (Pro-Individual, Pro-SME, Enterprise-Brand, Enterprise-Agency, or Custom tiers).
How to Connect
- Navigate to Settings → Integrations.
- Find the Google Analytics 4 card and click Connect Google Analytics.
- You'll be redirected to Google to authorize access. AEO Optima requests
analytics.readonlyanduserinfo.emailscopes. - After authorization, you'll be redirected back. Pick the GA4 property to track from the dropdown. AEO Optima suggests the best match for your project (scoring each property against your project's brand name and website, marked high/medium confidence) so the right one is pre-surfaced even when the Google account exposes hundreds of properties (agency accounts often do).
- Click Save. The first sync runs immediately (you don't wait for the next daily cron) — the initial import covers the last 7 days. If you bound the wrong property, AEO Optima's binding diagnostics flag the mismatch.
Data Synced
| Metric | Description |
|---|---|
| Sessions | Total sessions from AI referrer sources |
| Users | Unique users arriving via AI referrers |
| Engagement Rate | Percentage of engaged sessions |
| Conversions | Goal completions from AI-referred traffic |
| Top Pages | Landing pages receiving the most AI traffic |
Sync Schedule
Data is synced daily at 6AM UTC via the aeo-optima-ga4-sync background job. GA4 data has a processing delay of approximately 24-48 hours, so the most recent data point is typically from 2 days ago.
Disconnecting
To disconnect, go to Settings → Integrations → Google Analytics 4 and click Disconnect. Your existing synced data is preserved — only new syncs stop.
Troubleshooting
| Issue | Solution |
|---|---|
| "Please revoke access and try again" | Go to myaccount.google.com/permissions, revoke AEO Optima access, then reconnect |
| No properties listed | Ensure your Google account has Viewer access on the GA4 property |
| Data not appearing | Wait 24-48 hours for GA4 processing. Check that the correct property is selected |