> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useupbeat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Analytics 4

> Connect GA4 to power the Performance dashboard with real traffic data.

Connecting Google Analytics 4 gives UPBEAT OS access to your site's traffic data — page views, sessions, top content, engagement metrics, and trends. This data powers the GA4 insights panel on your Performance dashboard and helps Beat make more informed content recommendations.

## What this integration enables

Once connected, UPBEAT OS pulls your GA4 data daily and surfaces it in the Performance dashboard (`/app/performance`). You'll see traffic trends over the past 30 days, your top-performing pages, session engagement metrics, and how your traffic is trending week-over-week. Beat also uses GA4 data to inform the Strategy page — for example, surfacing content that's driving traffic but not conversions.

## Prerequisites

* A Google Analytics 4 property (not Universal Analytics — if you're still on UA, you'll need to migrate or create a GA4 property first)
* Editor or Administrator access to the GA4 property
* The property must be tracking your website (at least a few days of data helps, but a fresh property works too)

## How to connect

<Steps>
  <Step title="Open Settings and scroll to **Integrations**">
    Navigate to [/app/settings](https://useupbeat.com/app/settings) in UPBEAT OS.
  </Step>

  <Step title="Find the Google Analytics 4 card">
    Scroll to the Google Analytics section and click **Connect** on the GA4 card.
  </Step>

  <Step title="Sign in with Google">
    You'll be redirected to Google's OAuth consent screen. Sign in with the Google account that has access to your GA4 property. Review the requested permissions and click **Allow**.
  </Step>

  <Step title="Select your property">
    After authorizing, UPBEAT OS shows a list of GA4 properties associated with your Google account. Select the property for your website.
  </Step>

  <Step title="Confirm the connection">
    You'll be returned to the Integrations page. The GA4 card should show a green **Connected** status with your property name.
  </Step>
</Steps>

## What you'll see once connected

After the first data sync (within 24 hours), the Performance dashboard will show:

* Traffic trend chart (past 30 days of page views and sessions)
* Top pages by traffic
* Engagement metrics (average session duration, pages per session)
* Week-over-week traffic comparison

## How to disconnect

Open Settings and scroll to **Integrations**, find the Google Analytics 4 card, and click **Disconnect**. This removes UPBEAT OS's access to your GA4 data. The Performance dashboard GA4 panel will become empty.

## Troubleshooting

**The property I need isn't showing in the list:** Make sure you're signed into the Google account that has Editor or Administrator access to that GA4 property. If you manage multiple Google accounts, try signing out and back in with the correct one.

**Data is showing but it looks wrong:** Check that you selected the right GA4 property during setup. You can disconnect and reconnect to select a different one.

**No data after 24 hours:** Verify the Connected status is green on the integrations page. If it shows an error, try disconnecting and reconnecting.