AEO Optima Docs
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-SME (legacy: Professional) or Enterprise.

How to Connect

  1. Navigate to Settings → Integrations.
  2. Find the Google Analytics 4 card and click Connect Google Analytics.
  3. You'll be redirected to Google to authorize access. AEO Optima requests analytics.readonly and userinfo.email scopes.
  4. After authorization, you'll be redirected back. Select the GA4 property you want to track from the dropdown.
  5. Click Save. Data sync begins automatically — the initial import covers the last 7 days.

Data Synced

MetricDescription
SessionsTotal sessions from AI referrer sources
UsersUnique users arriving via AI referrers
Engagement RatePercentage of engaged sessions
ConversionsGoal completions from AI-referred traffic
Top PagesLanding 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

IssueSolution
"Please revoke access and try again"Go to myaccount.google.com/permissions, revoke AEO Optima access, then reconnect
No properties listedEnsure your Google account has Viewer access on the GA4 property
Data not appearingWait 24-48 hours for GA4 processing. Check that the correct property is selected

On this page