Google Analytics

Overview

The Google Analytics integration brings your website traffic data directly into WebGPT. Instead of switching between multiple Google Analytics properties, you can view visitor counts, session data, pageviews, and trends for all your sites in one place.

The integration supports Google Analytics 4 (GA4) properties and provides both high-level KPI summaries and detailed breakdowns by domain and category.

Connecting Google Analytics

Follow these steps to link your GA4 account to WebGPT:

1. Navigate to the Google Analytics integration page. Go to Integrations → Google Analytics and click the Connect button.
2. Sign in with your Google account. A Google sign-in window will appear. Use the Google account that has access to your GA4 properties.
3. Grant read permissions. WebGPT requests read-only access to your Analytics data. It cannot modify your GA4 settings, create properties, or change any configurations. Make sure to check the Google Analytics data access checkbox in the consent screen, then click Continue. If you skip the checkbox, the connection cannot retrieve your analytics data and you will be asked to try again.
4. Properties are fetched automatically. After authorization, WebGPT fetches all GA4 properties associated with your Google account. This may take a few moments if you have many properties.
5. Link properties to your WordPress domains. For the best experience, link each GA4 property to its corresponding WordPress domain in WebGPT. The system can auto-match properties to domains based on the website URL. You can also link them manually.

Accounts tab

The Accounts tab manages your connected Google Analytics accounts and property-to-domain linking.

Account management

• View connected accounts: See all Google accounts you have linked, along with the number of GA4 properties discovered.
• Sync accounts: Refresh the list of GA4 properties from Google. Use this if you have added new GA4 properties since connecting.

Property-to-domain linking

Linking a GA4 property to a WordPress domain is what enables the analytics dashboard to show data per domain. You have two options:

• Auto-match: WebGPT attempts to match each GA4 property URL with your existing WordPress domains. Properties that match are linked automatically.
• Manual linking: For properties that could not be auto-matched (e.g., the URL differs slightly), you can manually select which domain a property belongs to.

Properties that are not linked to a domain will still have their data available, but they will not appear in domain-specific views and category breakdowns.

Analytics dashboard

The analytics dashboard provides a comprehensive view of your website traffic. It is divided into several sections.

KPI cards

At the top of the dashboard, you will find key performance indicator (KPI) cards showing your most important metrics at a glance:

• Active domains — the number of linked domains with traffic data in the selected period.
• Unique visitors — total unique visitors across all domains.
• Sessions — total sessions (a session is a group of interactions within a time frame).
• Pageviews — total pages viewed across all domains.
• Avg. visitors per domain — the average number of unique visitors per active domain.
• Avg. visitors per day — the average daily unique visitors across the selected time range.
• Engaged sessions — sessions where the user interacted meaningfully (stayed 10+ seconds, viewed 2+ pages, or triggered a conversion).
• Engagement rate — percentage of sessions that were engaged.
• Avg. session duration — average time spent per session across all domains.
• Total users — total distinct users who visited your sites, including those who did not engage.
• Sessions per user — how many times each user returns on average. A higher number indicates stronger visitor loyalty.
• Event count — total events fired across all sites, including page views, clicks, scrolls, and any custom events you have set up in GA4.
• Key events — events you have marked as important (conversions) in your Google Analytics settings. This card only appears when at least one domain has key events data.

Trend chart

Below the KPI cards, a line chart displays traffic metrics over time. You can toggle individual metrics on or off using the switches below the chart: visitors, sessions, pageviews, new users, engaged sessions, total users, event count, and key events. This helps you identify traffic trends, seasonal patterns, or the impact of content publishing on traffic volumes. Hover over data points to see exact numbers for specific dates.

Top domains chart

A horizontal bar chart shows your highest-traffic domains, ranked by the selected metric. This is a quick way to see which sites in your portfolio are performing best during the selected period.

Click any domain bar to expand an inline table showing that domain's top-performing pages, including page title, path, pageviews, visitors, engagement rate, and average session duration. Click the bar again to collapse it, or click a different domain to switch.

Top pages

The Top Pages view shows a combined table of the best-performing pages across all your domains. Each row displays the domain name, page title, page path, and key metrics (pageviews, visitors, engagement rate, bounce rate, and session duration). You can sort by any column and use the search box to find specific pages or domains.

Top pages data covers the most recent sync period and includes up to 100 pages per domain, ranked by pageviews.

Category breakdown table

If you have assigned categories to your WordPress domains, this table groups your analytics metrics by category. Each row shows aggregate data (visitors, sessions, pageviews, users, events, and more) for all domains in that category. This is particularly useful for portfolio owners who manage sites across different niches or topics.

Tips and best practices

• Link all properties to domains. Unlinked properties will not appear in domain breakdowns or category tables. Take a moment after connecting to ensure every property is linked to its correct domain.
• Use category filters for portfolio analysis. If you manage dozens of sites, categories help you understand performance at a group level rather than checking each site individually.
• Check data regularly. The dashboard shows the latest data available from Google Analytics. Regular checks help you spot traffic drops or spikes early so you can take action.
• Sync after adding new GA4 properties. If you set up a new GA4 property in Google Analytics, use the Sync button on the Accounts tab so WebGPT can discover it.
• Read-only access. WebGPT only reads your analytics data — it never modifies your GA4 configuration, goals, or property settings.

Troubleshooting

• No data showing: First, make sure you have synced analytics data from the Accounts tab or the Analytics tab prompt. Then verify that your GA4 properties are linked to WordPress domains and that the selected date range includes dates when the properties had active tracking. If filters are active, try resetting them using the reset button.
• Properties not found: Ensure you signed in with the Google account that has access to your GA4 properties. If you use multiple Google accounts, try connecting each one separately.
• Stale data: Google Analytics data can have a processing delay of up to 24-48 hours. If you do not see today's data, check again later.
• Permission errors: If WebGPT cannot fetch data, the most common cause is skipping the Analytics data access checkbox during the Google sign-in. Disconnect the account and reconnect it, making sure to check the checkbox when Google asks what WebGPT can access. If the issue persists, try reconnecting to refresh the OAuth tokens.