# Google Analytics 4

> Connect Google Analytics 4 so your AI can answer questions about traffic, conversions, revenue, funnels and realtime visitors.

Connect Google Analytics 4 and your AI can read every GA4 property your Google login can open. Plugsight only reads: it never changes properties, events or settings.

## What your AI can do

- Report sessions, users, engagement, page views, key events (conversions) and revenue.
- Break them down by channel, source / medium, campaign, landing page, page, device, browser, country, region, city, language and date.
- Report ecommerce: purchases, items viewed, add-to-carts, checkouts and item revenue by product, brand or category.
- Show Google Ads cost, clicks and ROAS, and Search Console data, for properties linked to them in GA4.
- Use any GA4 dimension or metric, including your own custom definitions.
- Build a funnel from 2 to 10 steps and show where people drop off, optionally split by device or channel.
- List your key events and how many happened in a period.
- Show who is on the site right now (the last 30 minutes).
- Run the account overview and period comparison deep dives.

See [How your AI analyses marketing data](https://docs.plugsight.app/connectors/marketing-data.md) for how these tools work.

### Example questions

- "Which channels drove the most revenue this month vs last month?"
- "Which landing pages have the highest conversion rate from paid search?"
- "Which products were added to cart most but bought least?"
- "How many people are on the site right now, and from which countries?"
- "Show sessions and key events by week for the last quarter."
- "Build a funnel from product page to purchase and show where mobile users drop off."
- "What counts as a conversion in this property?"

## What you need

- A **Pro** or **Agency** plan, or the Free plan to try it: Free includes 1 marketing connection and 25 marketing tool calls a month. See [Plans](https://docs.plugsight.app/get-started/plans.md).
- A Google account with access to your GA4 properties.

## Connect Google Analytics 4

1. Open **Connections** and click **Add connection**.
2. Choose **Google Analytics 4**.
3. Read **What happens next** and click **Continue to Google**.
4. Choose the Google account that can see your properties.
5. If Google says **"Google hasn't verified this app"**, click **Advanced**, then **Go to Plugsight (unsafe)**.
6. Google asks: "See and download your Google Analytics data". Tick the box and continue.
7. You're back on **Connections**, with a message such as "Connected you@example.com: 5 GA4 properties."

Then add the connection to an MCP server. If this is your first marketing connection, [refresh the tools list](https://docs.plugsight.app/ai-apps/refresh-tools.md) in your AI app and start a new chat.

To choose which properties your AI can see, click **Show sites & accounts** next to the connection. See [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md).

## What it can and can't change

GA4 is **read-only** in Plugsight. Google's permission is read-only too.

## Limits

GA4 sometimes holds data back. When it does, your AI is told so it can explain the answer:

- **Data thresholds**: with age, gender or small numbers of users, Google may withhold rows. Removing demographic breakdowns or widening the date range usually helps.
- **Sampling**: large reports may be based on a sample of events.
- **"(other)"**: when there are too many different values, GA4 groups the rest into "(other)". Add filters or ask for fewer breakdowns.
- **Daily quota**: GA4 limits how much each property can be queried per day. Your AI is warned when it's running low.

Funnel completion and drop-off rates come back as fractions (0.25 means 25%); your AI turns them into percentages.

If a property has no key events, your AI is told to mark events as key events in GA4 under **Admin → Data display → Events**.

## Troubleshooting

### Google Analytics 4 access wasn't granted. Tick the permission and try again.

**What it means:** The permission box on Google's screen wasn't ticked.

**How to fix it:** Connect again and tick the box at step 6.

### "This login doesn't reach anything yet."

**What it means:** The Google account you used has no GA4 properties.

**How to fix it:** Give that account access to the property in GA4, then click **Refresh list**. Or connect again with the right account.

### Step "…": give either event or page_contains.

**What it means:** Each funnel step must be either an event (such as add_to_cart) or a page whose address contains some text, not both or neither.

**How to fix it:** Describe each step clearly, for example "step 1: viewed a page containing /product; step 2: add_to_cart event".

### Your Free plan includes 1 marketing connection. Upgrade to Pro to connect more.

**What it means:** the Free plan includes 1 marketing or analytics connection to try, and you already have that many.

**How to fix it:** remove the marketing connection you don't need on **Connections**, or upgrade to Pro or Agency on **Billing**.

### Reconnect needed: "Google sign-in was revoked or has expired."

**What it means:** Google stopped accepting the login.

**How to fix it:** Click **Reconnect** next to the connection.

For other sign-in messages, see the troubleshooting section of [Google Ads](https://docs.plugsight.app/connectors/google-ads.md).

## Related articles

- [How your AI analyses marketing data](https://docs.plugsight.app/connectors/marketing-data.md)
- [Google Search Console](https://docs.plugsight.app/connectors/google-search-console.md)
- [Google Tag Manager](https://docs.plugsight.app/connectors/google-tag-manager.md)
- [Choose which sites and accounts your AI can see](https://docs.plugsight.app/connectors/hide-sites-and-accounts.md)
- [Who's on the site right now](https://docs.plugsight.app/recipes/realtime-visitors.md)
- [Bing Webmaster Tools](https://docs.plugsight.app/connectors/bing-webmaster.md)

---

Web version: https://docs.plugsight.app/connectors/google-analytics-4
