Google Analytics 4 API Setup

This guide walks you through setting up automated GA4 data fetching.

Prerequisites

• Same service account from GSC setup (or create new one)
• GA4 property with data

Step 1: Enable the API

1. Go to Google Cloud Console
2. Select the same project used for GSC
3. Go to APIs & Services → Library
4. Search for “Google Analytics Data API”
5. Click Enable

Step 2: Get Your GA4 Property ID

1. Go to Google Analytics
2. Select your 360tft property
3. Click Admin (gear icon)
4. Under Property Settings, find Property ID
5. Copy the number (e.g., 123456789)

Step 3: Grant Access to Service Account

1. In GA4, go to Admin → Account Access Management
2. Click + → Add users
3. Enter the service account email (same as GSC)
4. Set role to Viewer
5. Click Add

Step 4: Add GitHub Secrets

Add these secrets to your GitHub repo:

Step 5: Test Locally

cd scripts/ga4

# Copy service account from GSC folder
cp ../gsc/service_account.json .

# Install dependencies
pip install google-analytics-data

# Run with property ID
python fetch_ga4_data.py --property YOUR_PROPERTY_ID

What Data Is Collected

Overview Metrics

• Sessions, Users, New Users
• Page Views
• Bounce Rate, Engagement Rate
• Average Session Duration

Breakdowns

• Top Pages: Most viewed pages with engagement metrics
• Landing Pages: Entry pages with bounce rates
• Traffic Sources: Where visitors come from
• Devices: Mobile vs Desktop vs Tablet
• Countries: Geographic distribution

Insights Generated

• High bounce rate pages (need improvement)
• Low engagement pages (need more content)
• Top performing content
• Traffic source analysis

Output

Reports saved to:

• scripts/ga4/data/ga4_latest.json - Most recent
• scripts/ga4/data/ga4_report_YYYY-MM-DD.json - Historical

Combined with GSC

When both GSC and GA4 are set up, you get:

Together: Full picture of how users find your site AND what they do when they arrive.