GA Analytics Report Guide

View your organization's combined GA4 + Search Console AI analysis report (the main content), plus the latest metrics and history for a selected property/site (supporting detail).

🔗 Open GA Analytics Report →

📋 Overview

This page has two layers:

• Combined report (main) — an AI analysis that looks at GA4 and Search Console data together. Click a past date in the history list on the right to view that day's report, and click "File this as an issue" to send any suggestion you like straight into a giip issue.
• Individual GA4 / GSC panels (supporting) — below the combined report, separate panels show per-property KPI cards, recent daily history tables, and GSC top queries. These panels no longer generate their own AI analysis (the combined report above is the sole final analysis) — they're for checking the raw numbers directly.

✅ Prerequisites

1. The GA4 property and (optionally) the Search Console site must be registered for your organization — see GA Property Management and GSC Sites. If either source is missing, the combined report shows a "setup needed" link for it.
2. Collection is running so there is data (see "Setting up collection" below).

🔎 View a report

1. The combined report loads automatically when you open the page. Click a date in the history list on the right to switch to that day's report, or click "Back to latest" to return to the current one.
2. To see individual metrics, pick a registered property/site from the dropdown (or enter one manually) in the GA4/GSC panels below.

📊 Metrics

Metric	Meaning
Active Users	Distinct active users
Sessions	Number of sessions
Page Views	Screen/page views
Bounce Rate	Share of single-interaction sessions (shown as %)
Conversions	Conversion events
Avg. Session (s)	Average session duration, seconds
Clicks / Impressions (GSC)	Search Console search-result clicks/impressions
CTR / Avg. Position (GSC)	Click-through rate (%) / average search position

🤖 How the AI tells pages apart

The AI behind the combined report looks at each URL path and automatically classifies it as either a marketing/public page (a landing page, blog post, etc. visitors see without logging in) or a login-gated product/admin screen (e.g. a dashboard, an admin-only page). The latter is automatically excluded from being flagged as a conversion-funnel page.

If the automatic classification doesn't match your setup (e.g. you deliberately run some public pages without a login wall), or you want the AI to better reflect your service's own direction and target customers, you can add organization-specific (csn-scoped) guidance in Admin > Gareport AI Custom Prompt. It's appended after the global rules, not a replacement for them.

⚙️ Setting up collection (admin)

Metrics are collected by GIIP agents/servers and analyzed together by AI on a regular schedule. One-time setup:

1. Register the GA4 property (GA Property Management) and the GSC site (GSC Sites) — both sources need to be registered for the combined report to be complete.
2. Service account key — create a Google service account with GA4 read access and share the property with it. Place the key JSON at the path specified in giipdb mgmt/ga-collector.config.json.sample's serviceAccountKeyFile field (actual path: giipdb/.secrets/ga-service-account.json, gitignored). GIIP's ProcessGaCollect (giipfaw timer function) reads this file and calls the Google Data API directly.
3. Collection job — ProcessGaCollect (a giipfaw timer function) automatically collects registered active properties by reading from DB (tGaConfig). No separate PC/agent deployment is needed. The CQE guide and giipdb docs/30_Specs/CQE_SPECIFICATION.md apply only to the legacy agent-based collection method.
4. AI analysis (combined) — giipfaw's ProcessComboReport reads GA4 and GSC data together and produces the combined report. If the sample size is too small (e.g. too few visitors), the report notes that limitation.

Once collection runs, this page fills in automatically.

Troubleshooting

Symptom	Cause	Solution
"No report yet"	The combined-report batch hasn't run yet	Verify collection/setup and wait for the next run.
A "setup needed" link appears	Either the GA4 property or the GSC site isn't registered	Register it via the linked page (GA Property Management / GSC Sites).
Property/site dropdown is empty	No properties/sites registered for this organization	Register one in the corresponding management page.
403 / Access denied	You lack permission for the property's organization	Use an organization you belong to.
The AI misunderstands our service structure	Automatic page classification doesn't fit our organization's exceptions	Add guidance in the Gareport AI Custom Prompt page.

---

Version: 1.2 Last Updated: 2026-08-16 Source File: giipv3/public/help/gareport.en.md