Skip to main content

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.

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

1

Open Settings and scroll to **Integrations**

Navigate to /app/settings in UPBEAT OS.
2

Find the Google Analytics 4 card

Scroll to the Google Analytics section and click Connect on the GA4 card.
3

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.
4

Select your property

After authorizing, UPBEAT OS shows a list of GA4 properties associated with your Google account. Select the property for your website.
5

Confirm the connection

You’ll be returned to the Integrations page. The GA4 card should show a green Connected status with your property name.

​
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.