giip

GA Property Management Guide

Register and manage the GA4 properties for your organization so they can be collected, analyzed, and displayed in GIIP.

🔗 Open GA Property Management →

📋 Overview

GIIP collects Google Analytics 4 (GA4) metrics per property. Before data can be collected or viewed, each GA4 property must be registered under your organization (CSN) on this page. One organization can register multiple properties.

🔑 Who can manage

Any user who belongs to the organization (CSN) can view and manage its GA properties. Permission is enforced on the server — no separate admin role is required.

🧭 Find your GA4 Property ID

  1. Open Google Analytics → Admin (gear icon).
  2. Under Property, open Property details.
  3. Copy the Property ID (a number such as 123456789).
  4. In GIIP, enter it as properties/123456789 (keep the properties/ prefix).

⚠️ Property ID vs. Measurement ID — an easy mix-up

GA4 has two similarly-named IDs with completely different purposes.

Property IDMeasurement ID
FormatA plain number (e.g. 123456789)A string starting with G- (e.g. G-RD96JF3S6Q)
Where to find itAdmin → Property → Property detailsAdmin → Data Streams → click the web stream
Where it's usedGIIP's "GA Property" field (as properties/<number>). Used by GIIP's collector when calling the GA4 Data API.The gtag snippet embedded in the website (e.g. GA_ID in giipv3/src/app/layout.tsx). Used by the visitor's browser to actually send events.

Both must point to the same property. A single property can have multiple data streams, each with its own Measurement ID — so registering just the "Property ID" tells you nothing about whether the live website is actually sending data into that property.

A real incident (giip-911/912): the Property ID registered in GIIP was correct, but the website's gtag Measurement ID pointed to a different (old) property — so the property GIIP was querying never received that website's traffic at all (it showed page data from an unrelated site instead). Checklist:

  1. Confirm the Property ID (properties/<number>) registered in GIIP.
  2. In GA4, open that property's Data Streams → Measurement ID.
  3. Compare it against the website's gtag Measurement ID (GA_ID / NEXT_PUBLIC_GA_ID env var in layout.tsx).
  4. If they differ, either update the website's tag to the correct property's Measurement ID, or change the GIIP registration to the property the website actually sends to.

🛠️ Manage properties

The page always operates on your current organization (CSN), shown next to the title.

Add

  1. Enter the GA Property (e.g. properties/123456789).
  2. Optionally enter a Label (e.g. Marketing site).
  3. Click Add — the property appears in the list below.

Edit

  1. Click Edit on a row; the form fills with its values.
  2. Change the label (or property id) and click Update. Cancel aborts.

Delete

Click Delete on a row and confirm. This removes the registration only (collected metrics are not deleted).

🔐 Register a GA4 service account key (giip-803)

For actual collection (the Start collection button on the GA Collection Pipeline page) to work, each property needs a GA4 service account key registered. You no longer need to place a key file on any server — just paste it directly on this page; it's stored securely in the database and the collector fetches it automatically at run time.

  1. Create a service account in Google Cloud Console and download its JSON key.
  2. In the GA4 Admin screen (Property Access Management), grant that service account Viewer access.
  3. Copy the entire content of the downloaded JSON file and paste it into the GA4 service account key (JSON) field.
  4. Click Add/Update — after saving, the Key status column in the list switches to Registered.
  • Leaving the key field blank while only editing the label keeps the existing key unchanged.
  • The key content is never shown again in the list (only "Registered"/"Not registered" is displayed). Paste a new JSON to replace it.

🔗 What happens next

  • The registered property becomes selectable on the GA Analytics Report page.
  • The collector agent can push metrics only for registered properties — an unregistered property is rejected (403).
  • On the GA Collection Pipeline page, the Start collection button can trigger an immediate collection (requires a registered service account key).

🧩 Fields

FieldMeaning
GA PropertyGA4 resource name properties/<id>. Unique within the organization.
LabelFree text to identify the property in lists.
StatusActive / Inactive. Inactive is kept but not collected.
GA4 service account key (JSON)Credential the collector uses to call the GA4 Data API. Never redisplayed after saving.
Key statusRegistered / Not registered — list-only indicator (not the raw content).

Troubleshooting

SymptomCauseSolution
"No organization (CSN) selected"No active organization in the sessionSelect a project/organization at the top, then reopen.
"You do not have permission..."You are not a member of that organizationAsk an admin to add you, or switch organizations.
Property missing in GA ReportNot registered, or under a different organizationRegister it here under the correct organization.
Collector returns 403The property id is not registeredAdd the exact properties/<id> here first.
Clicking "Start collection" says "No GA collector is registered for this organization yet"No service account key registered for this propertyFollow the "Register a GA4 service account key" steps above.
Pasting the key says "Not valid JSON"The pasted content isn't a complete JSON document (e.g. partially copied)Re-copy the entire .json file Google downloaded and paste it again.

Version: 1.1 Last Updated: 2026-07-29 Source File: giipv3/public/help/ga-property.en.md

← PreviousCQE Script ManagementNext →GA Analytics Report