giip
SES 商機登記
7分鐘閱讀

GA 分析報告指南

檢視貴組織的 GA4 + Search Console 綜合 AI 分析報告(核心內容),以及所選資源/網站的最新指標與歷史(輔助資訊)。

🔗 開啟 GA 分析報告 →

📋 概述

本頁面分為兩層:

  • 綜合報告(核心) — 結合 GA4 與 Search Console 資料的 AI 分析。在右側歷史清單中點擊過去的日期,可檢視當時的報告;對喜歡的建議點擊**「將此建議登記為 Issue」即可直接登記為 giip issue。開啟其下方的「產生報告時自動登記 issue」**開關後，日後每次產生新的綜合報告都會自動將其建議登記為 giip issue（開啟時，目前顯示的最新報告若尚未登記，也會立即登記 1 筆）。開關關閉時，仍可照舊使用手動登記按鈕。
  • 個別 GA4 / GSC 面板(輔助) — 綜合報告下方分別顯示各資源的最新指標(KPI 卡片)、最近每日歷史表,以及 GSC 熱門搜尋字詞。這些面板不再單獨產生 AI 分析(上方的綜合報告是唯一的最終分析),僅供直接檢視原始數字時參考。

✅ 前提條件

  1. GA4 資源與(可選)Search Console 網站需已在您的組織註冊 — 見 GA 資源管理、GSC 網站。若任一來源未註冊,綜合報告會為該項顯示「需要設定」的連結。
  2. 採集正在執行,已有資料(見下方「設定採集」)。

🔎 檢視報告

  1. 開啟頁面後綜合報告會自動載入。點擊右側歷史清單中的日期可切換至當天的報告,點擊「返回最新」可回到最新報告。
  2. 若要檢視單項指標,請在下方的 GA4/GSC 面板中從下拉選單選擇已註冊的資源/網站(或手動輸入)。

📊 指標

指標意義
活躍使用者去重活躍使用者
工作階段工作階段數
頁面瀏覽量螢幕/頁面瀏覽量
跳出率單次互動工作階段占比(以 % 顯示)
轉換次數轉換事件
平均工作階段(秒)平均工作階段時長(秒)
點擊次數 / 曝光次數 (GSC)Search Console 搜尋結果的點擊/曝光次數
CTR / 平均排名 (GSC)點擊率(%) / 平均搜尋排名

🤖 AI 如何區分頁面

綜合報告背後的 AI 會讀取每個 URL 路徑,自動區分行銷/公開頁面(訪客無需登入即可檢視的到達頁、部落格等)與登入後的產品/管理畫面(如儀表板、僅管理員可見的頁面)。後者會自動排除在「轉換入口」相關的評論之外。

如果自動分類與貴組織的實際情況不符(例如刻意將部分公開頁面設為無需登入),或希望 AI 更能反映貴公司自身的服務方向與目標客戶,可在 管理員 > Gareport AI 自訂提示詞 中輸入僅適用於本組織(csn)的附加說明。該說明不會取代全域規則,而是附加在其後。

⚙️ 設定採集 (管理員)

指標由 GIIP 代理/伺服器採集,並由 AI 定期綜合分析。一次性設定:

  1. 註冊 GA4 資源(GA 資源管理)與註冊 GSC 網站(GSC 網站) — 兩個資料來源都需註冊,綜合報告才完整。
  2. 服務帳號金鑰 — 建立具有 GA4 讀取權限的 Google 服務帳號並將資源共用給它。將金鑰 JSON 放置於 giipdb mgmt/ga-collector.config.json.sample 中 serviceAccountKeyFile 欄位指定的路徑(實際路徑: giipdb/.secrets/ga-service-account.json,gitignore)。giipfaw 的 ProcessGaCollect 讀取此檔案並直接呼叫 Google Data API。
  3. 採集作業 — giipfaw 的計時器函式(ProcessGaCollect)透過讀取 DB(tGaConfig) 中註冊的活動資源清單自動執行採集。無需單獨的 PC/代理部署。CQE 指南 和 giipdb docs/30_Specs/CQE_SPECIFICATION.md 僅適用於舊版基於代理的採集方式。
  4. AI 分析(綜合) — giipfaw 的 ProcessComboReport 會同時讀取 GA4 與 GSC 資料並產生綜合報告。若樣本數過小(例如訪客數不足),報告會一併註明此限制。

採集執行後本頁會自動填入。

疑難排解

症狀原因解決
「尚無報告」綜合報告批次尚未執行確認採集/設定狀態,並等待下次執行。
出現「需要設定」連結GA4 資源或 GSC 網站其中之一未註冊透過提示的連結(GA 資源管理 / GSC 網站)完成註冊。
資源/網站下拉選單為空該組織無已註冊資源/網站在對應管理頁面中註冊。
403 / 存取被拒無該資源組織的權限使用您所屬的組織。
AI 分析誤解了我們的服務結構自動頁面分類未涵蓋本組織的特殊情況在 Gareport AI 自訂提示詞頁面中補充說明。

🔌 供 AI 使用的最新資料查詢 API

這是一個唯讀 API,讓外部 AI 無需解讀畫面或登入 Google 帳號,僅憑組織識別值(csn)與該組織的密鑰(SK),即可一次讀取 GIIP 已採集的 GA4/GSC 最新快照與綜合報告。它不包含任何重新採集、重新分析或修改設定的功能。

⚠️ 範圍限制: 此 API 僅提供最新的一份快照,不包含畫面上的歷史清單(按日期查看的歷史報告)或完整的每日歷史表格 — 只能查詢最近一次採集/產生的資料。

請求

項目值
方法GET
URLhttps://giipfaw.azurewebsites.net/api/giipGareportSnapshot?csn={CSN}
標頭x-api-key: {SK}
參數僅一個正整數 csn

成功回應 (HTTP 200)

{
  "csn": 47,
  "retrievedAt": "2026-09-01T00:00:00Z",
  "sources": {
    "gsc": { "status": "READY", "siteCount": 1 },
    "ga4": { "status": "READY", "propertyCount": 1 },
    "combinedReport": { "status": "READY" }
  },
  "gscSites": [ { "siteUrl": "...", "label": "...", "collectedAt": "...", "data": { } } ],
  "ga4Properties": [ { "propertyId": "...", "label": "...", "collectedAt": "...", "data": { } } ],
  "combinedReport": { "reportId": 0, "generatedAt": "...", "dataSources": "ga+gsc", "missingConfig": null, "language": "zh-TW", "content": "## 1. 目前狀況\n最近28天的活躍使用者比前28天增加了12%...\n\n## 2. 今日核心瓶頸\n到達頁A的跳出率高達78%,阻礙了流量轉換...\n\n## 3. 依據\n[MEASURED] ...\n\n## 4. 現在應執行的動作\n對象: /pricing ...\n\n## 5. 暫緩判斷\n..." }
}
  • gscSites[].data 原樣保存該網站的最新 GSC 原始 JSON(totals、topQueries、topPageQueries、date、range、collectedAt、source)。
  • ga4Properties[].data 是該資源的最新 GA4 原始 JSON 物件,包含以下欄位(依據 giipfaw ProcessGaCollect 的採集結構):
    • propertyId、range(採集對應日期)、collectedAt、source
    • metrics: activeUsers、sessions、screenPageViews、bounceRate、conversions、averageSessionDuration
    • topPages: 按瀏覽量排名前 10 的頁面陣列 — 每項包含 pagePath、screenPageViews、bounceRate、averageSessionDuration
    • landingPages: 按工作階段數排名前 10 的到達頁陣列 — 每項包含 landingPage、sessions、bounceRate
    • events: 按發生次數排名前 20 的事件陣列 — 每項包含 eventName、eventCount
    • coreWebVitals: 僅當同時設定了網站 URL 與組織自有的 PageSpeed API 金鑰時才有值,否則為 null。有值時,mobile/desktop 各自包含 performanceScore、lcpMs、clsScore、inpMs、fcpMs、ttfbMs
    • periods: 依比較區間(current_3d、current_7d、current_28d、previous_28d、current_90d)分組的 startDate/endDate/metrics(該區間採集失敗時為 null)
  • combinedReport 是最新的一份綜合報告(若無則為 null)。content 是如上所示由 5 個部分(目前狀況/今日核心瓶頸/依據/現在應執行的動作/暫緩判斷)組成的 Markdown 字串 —— 以上範例僅用於展示結構,實際數值因組織與區間而異。
  • gscKeyJson、gaKeyJson、Google 服務帳號金鑰、SK、AK、資料庫連線資訊都不會包含在任何回應中。

錯誤回應

錯誤內文始終為 { "error": { "code": "...", "message": "..." } } 格式。

條件HTTPerror.code
SK 缺失或無效401UNAUTHENTICATED
SK 無法存取請求的 csn403FORBIDDEN_CSN
csn 缺失、非數字或 ≤ 0400INVALID_CSN
伺服器或資料庫錯誤500INTERNAL_ERROR

呼叫範例 (不含真實密鑰,使用環境變數)

export GIIP_API_BASE_URL="https://giipfaw.azurewebsites.net"
export GIIP_CSN="47"
export GIIP_SK="僅在執行時設定"

curl --fail-with-body \
  -H "x-api-key: ${GIIP_SK}" \
  "${GIIP_API_BASE_URL}/api/giipGareportSnapshot?csn=${GIIP_CSN}"

⚠️ 安全: 不要將 SK 放入 URL、Issue、程式碼儲存庫、提示詞內文或日誌。只能從執行環境變數或密鑰儲存中傳遞。

狀態值與 AI 應採取的行動

GSC 資料通常延遲兩到三天(Google 確定延遲)。

狀態意義AI 應採取的行動
READY有活動資源且有最新採集的原始資料將該資料作為事實進行摘要
NOT_CONFIGURED該 csn 無活動資源不要臆測,原樣報告為「未設定」
NO_DATA有活動資源但無最新採集資料不要臆測,原樣報告為「無資料」

AI 呼叫固定流程

  1. 只查詢一次快照。
  2. 先檢查 sources 中的每個狀態。
  3. 只將 READY 的資料作為事實摘要,NOT_CONFIGURED/NO_DATA 不臆測、原樣報告。
  4. 將綜合報告的 content 視為建議,將 GSC/GA4 data 中的數字視為事實資料,兩者區分對待。
  5. 即使需要歷史報告或每日歷史資料,此 API 也無法查詢 —— 只將最新快照視為事實,如收到需要歷史資料的請求,應明確告知「此 API 僅提供最新資料」。

版本: 1.5 最後更新: 2026-09-18 變更紀錄: giip 2709 —— 為綜合報告新增「產生報告時自動登記 issue」開關（開關關閉時保留手動登記按鈕）。 / giip #2068 —— 明確說明該 API 僅提供最新的一份快照,補充 ga4Properties[].data 的實測欄位結構,並擴充了 combinedReport.content 範例。 原始檔: giipv3/public/help/gareport.zh-TW.md

相關指南

實時安全代理自主AI的主動威脅監控和審計智能體循環與任務分發基於 GitHub Issue 透過智能體循環執行任務的便捷方法任務狀態流轉指南智能體分發系統中任務狀態變化的方式
← PreviousGA 資源管理Back to Overview知識中心