GA 資源管理指南

註冊和管理組織的 GA4 資源,以便在 GIIP 中採集、分析和顯示。

🔗 開啟 GA 資源管理 →

📋 概述

GIIP 依資源(property)採集 Google Analytics 4(GA4)指標。採集或檢視資料前,必須在本頁將每個 GA4 資源註冊到您的組織(CSN)。一個組織可註冊多個。

🔑 誰可以管理

屬於該組織(CSN)的任何使用者都可檢視和管理其 GA 資源。權限在伺服器端強制,無需單獨的管理員角色。

🧭 尋找 GA4 資源 ID

1. 開啟 Google Analytics → 管理(齒輪)。
2. 在資源下開啟資源詳細資料。
3. 複製資源 ID(例如 123456789)。
4. 在 GIIP 中以 properties/123456789 格式輸入(保留 properties/ 前綴)。

⚠️ 資源 ID 與評估 ID 不是同一件事 — 容易混淆

GA4 中有兩個名稱相近的 ID,用途完全不同。

	資源 ID	評估 ID
格式	純數字(例如 123456789)	以 G- 開頭的字串(例如 G-RD96JF3S6Q)
查看位置	管理 → 資源 → 資源詳細資料	管理 → 資料串流 → 點選對應的網站資料串流
使用位置	GIIP 的「GA 資源」輸入欄(properties/<數字> 格式)。GIIP 採集器呼叫 GA4 Data API 時使用。	網站中嵌入的 gtag 程式碼片段(如 giipv3/src/app/layout.tsx 中的 GA_ID)。訪客瀏覽器實際傳送事件時使用。

兩者必須指向同一個資源。 一個資源下可以有多個資料串流,每個資料串流都有自己的評估 ID——僅憑「資源 ID」無法判斷實際網站是否正在向該資源傳送資料。

真實案例(giip-911/912)：在 GIIP 中註冊的資源 ID 是對的,但網站的 gtag 評估 ID 指向了另一個(舊的)資源,導致 GIIP 查詢的資源裡從未收到過該網站的流量(反而顯示了不相關網站的頁面資料)。排查步驟:

1. 確認在 GIIP 中註冊的資源 ID(properties/<數字>)。
2. 在 GA4 中開啟該資源的資料串流 → 評估 ID。
3. 與網站原始碼中的 gtag 評估 ID(layout.tsx 中的 GA_ID 或 NEXT_PUBLIC_GA_ID 環境變數)進行核對。
4. 如果不一致,要麼把網站的評估 ID 改成該資源的,要麼把 GIIP 的註冊改成網站實際傳送到的那個資源。

🛠️ 管理資源

本頁始終針對您的目前組織(CSN),顯示在標題旁。

新增

1. 輸入 GA 資源(例如 properties/123456789)。
2. 可選輸入標籤(例如 行銷網站)。
3. 點擊新增 → 出現在下方清單。

編輯

1. 點擊列的編輯;表單填入其值。
2. 修改標籤(或資源 ID)並點擊更新。取消放棄。

刪除

點擊列的刪除並確認。僅刪除註冊(不刪除已採集指標)。

🔐 註冊 GA4 服務帳戶金鑰(giip-803)

要讓實際採集(GA 採集流水線 頁的「開始採集」按鈕)生效,每個資源都需要註冊一個 GA4 服務帳戶金鑰。無需預先在伺服器上放置金鑰檔案——直接在本頁貼上即可安全存入資料庫,採集器會在執行時自動取得並使用。

1. 在 Google Cloud Console 建立服務帳戶並下載其 JSON 金鑰。
2. 在 GA4 管理畫面(資源存取權管理)中,為該服務帳戶授予**檢視者(Viewer)**權限。
3. 複製下載的 JSON 檔案全部內容,貼到 GA4 服務帳戶金鑰(JSON) 欄位。
4. 點擊新增/更新——儲存後,清單中的金鑰狀態欄會變為已註冊。

• 只修改標籤而不填寫金鑰,現有金鑰保持不變。
• 清單中永遠不會再次顯示金鑰原文(僅顯示「已註冊」/「未註冊」)。要替換請貼上新的 JSON。

🔗 後續

• 已註冊的資源可在 GA 分析報告 頁的下拉選單中選擇。
• 採集代理只能為已註冊的資源推送指標(未註冊回傳 403)。
• 在 GA 採集流水線 頁,可透過「開始採集」按鈕立即觸發採集(需已註冊服務帳戶金鑰)。

🧩 欄位

欄位	意義
GA 資源	GA4 資源名 properties/<id>,組織內唯一。
標籤	清單中用於識別的自由文字。
狀態	啟用/停用。停用保留但不採集。
GA4 服務帳戶金鑰(JSON)	採集器呼叫 GA4 Data API 所用的憑證。儲存後不再顯示。
金鑰狀態	已註冊/未註冊——僅清單提示(非金鑰原文)。

疑難排解

症狀	原因	解決
「未選擇組織(CSN)」	工作階段中無使用中組織	在頂部選擇專案/組織後重新開啟。
「您沒有該組織的權限」	非該組織成員	請管理員新增,或切換組織。
GA 報告中看不到資源	未註冊或屬於其他組織	在正確組織下註冊。
採集器回傳 403	資源 ID 未註冊	先在此註冊準確的 properties/<id>。
點擊「開始採集」顯示「該組織尚未註冊 GA 採集器」	該資源尚未註冊服務帳戶金鑰	依上方「註冊 GA4 服務帳戶金鑰」步驟貼上金鑰。
貼上金鑰後顯示「不是有效的 JSON 格式」	貼上內容不是完整 JSON(如只複製了一部分)	重新複製 Google 下載的完整 .json 檔案內容並貼上。

---

版本: 1.1 最後更新: 2026-07-29 原始檔: giipv3/public/help/ga-property.zh-TW.md