Documentation/Guides/GA4 Integration

Google Analytics 4 Integration

Connect your Google Analytics 4 property to TagAssistant.ai for enhanced insights, real-time data, and property-specific recommendations from Tessa.

Hi, I'm Tessa! 👋

Your Tag Service Assistant

Connecting your Google Analytics property unlocks powerful insights! I'll be able to see your real data and give you even better recommendations. The connection process is quick, secure, and you can disconnect anytime.

Quick Tips

  • Connection takes just 2-3 minutes using secure OAuth2
  • I get read-only access - I can view but never modify your data
  • You can revoke access anytime from your Google Account settings

Why Connect Google Analytics?

📊

View Real Data

See actual pageviews, users, and sessions from your GA4 property directly in TagAssistant. No more switching between tools.

Verify Tracking

Confirm that your tracking is working correctly by comparing scan results with actual data flowing into GA4.

💡

Smart Recommendations

Tessa analyzes your actual analytics data to provide personalized recommendations based on real usage patterns.

🎯

Identify Issues

Detect tracking problems like missing events, low data volume, or configuration errors before they impact decisions.

⏱️ Time Required

2-3 minutes for the OAuth connection process. Data appears in TagAssistant immediately after authorization.

📋 Prerequisites

  • • A Google Analytics 4 property
  • • Viewer or Admin access to the property
  • • Completed website scan in TagAssistant

Connection Steps

1

Complete a Website Scan

Before connecting Google Analytics, you need to scan your website:

  1. Go to TagAssistant.ai/scan
  2. Enter your domain and run a scan
  3. Review the scan results to confirm Tessa detected your site
2

Find the "Connect Google Analytics" Button

After your scan completes, you'll see an option to connect your Google Analytics property. This appears as a button or card in your scan results timeline.

Why Connect GA4?

Connecting your Google Analytics property allows Tessa to:
  • Display real analytics data directly in TagAssistant
  • Verify your tracking is working correctly
  • Provide property-specific recommendations
  • Show performance metrics for tracked events
3

Click "Connect Google Analytics"

When you click the connection button, you'll be redirected to Google's OAuth consent screen. This is the standard, secure way to grant access to your Google account.

Important: Make sure you're logged into the Google account that has access to your Google Analytics property. If you're not sure which account, check your GA4 admin panel first.

4

Review OAuth Permissions

Google will show you exactly what permissions TagAssistant.ai is requesting:

Requested Permissions:

  • View your Google Analytics data - Read-only access to see metrics and reports
  • View property information - Access to property names, IDs, and settings

Your Data is Safe

TagAssistant.ai uses OAuth2, the industry-standard security protocol. We never see or store your Google password. You can revoke access anytime from your Google Account settings.
5

Grant Permission

Click "Allow" or "Continue" on Google's consent screen to grant TagAssistant.ai access to your Google Analytics data.

After granting permission, you'll be automatically redirected back to TagAssistant.ai where Tessa will immediately start analyzing your GA4 data.

6

View Your Analytics Dashboard

Once connected, you'll see a new "Google Analytics Overview" card in your timeline showing:

  • Property Name & ID: Confirmation of which GA4 property is connected
  • Recent Metrics: Pageviews, users, and sessions from the last 7 days
  • Top Pages: Your most visited pages with traffic data
  • Traffic Sources: Where your visitors are coming from
  • Real-Time Status: Whether data is currently flowing to GA4

Verify Your Tracking

Use the real-time data to verify that your tracking is working. Visit your own website in an incognito window and check if the visit appears in your analytics within a few minutes.

Troubleshooting

I don't see the "Connect Google Analytics" button

This usually means:

  • Your scan is still in progress - wait for it to complete
  • You haven't scanned a website yet - run a scan first
  • You're looking at an old scan - try refreshing or running a new scan
I get an "Access Denied" or permission error

Check these common issues:

  • Wrong Google Account: Make sure you're logged into the account that has GA4 access
  • Insufficient Permissions: You need at least Viewer role on the GA4 property
  • Revoked Access: Check your Google Account permissions to ensure TagAssistant hasn't been revoked
My data isn't showing up after connecting

Try these steps:

  1. Refresh the page - sometimes data takes a moment to load
  2. Check if your GA4 property actually has data (visit GA4 dashboard)
  3. Verify you connected the correct property (check the property ID)
  4. Wait a few minutes - initial data fetch can take 1-2 minutes
Can I connect multiple GA4 properties?

Currently, each domain scan can be connected to one GA4 property. If you need to track multiple properties, you can:

  • Run separate scans for different domains
  • Disconnect and reconnect a different property if needed
  • Contact support if you need multi-property support for your use case
How do I disconnect my Google Analytics?

You have two options:

  1. In TagAssistant: Look for the "Disconnect" or "Revoke Access" button in your analytics overview card
  2. In Google Account: Visit your Google Account permissions, find TagAssistant.ai, and click "Remove Access"

Note: Disconnecting removes access to your GA4 data but doesn't delete any scan results or recommendations already created.

Privacy & Security

Your Data is Protected

  • OAuth2 Security: We use Google's official OAuth2 protocol - we never see your password
  • Read-Only Access: We can only view your data, never modify or delete it
  • Encrypted Storage: All tokens are encrypted at rest using Google Cloud Secret Manager
  • No Data Sharing: We never sell or share your analytics data with third parties
  • Full Control: Revoke access anytime from your Google Account settings

For complete details, see our Privacy Policy.

What's Next?

Now that your Google Analytics is connected, you can take advantage of enhanced features and property-specific recommendations from Tessa.