Google Analytics

Google Analytics 是一個連接器：它把 MeDo 應用程式連接到一個可開啟你 Google Analytics 4（GA4）媒體資源的 Google 帳戶，讓應用程式可以列出帳戶與媒體資源、讀取標準報表與即時報表，並查詢網站資料串流的 Measurement ID。應用程式看到的一切都來自你連接的帳戶，而且只有唯讀權限。

#可以建立什麼

• 流量看板。 選擇一個媒體資源，以每日圖表顯示指定日期範圍內的瀏覽量、工作階段與使用者，並列出熱門頁面。
• 每週報表。 依流量來源、國家或裝置比較本週與上週，並標出變化最大的項目。
• 即時訪客面板。 顯示過去 30 分鐘內有多少人在網站上，以及他們正在瀏覽哪些頁面。
• 應用程式自身的追蹤。 讀取網站資料串流的 Measurement ID，讓應用程式把自己的頁面瀏覽與事件（例如 sign_up）傳送到 Google Analytics。

當應用程式需要業主真實的流量資料時，Google Analytics 就很合適。它不能建立或修改媒體資源、資料串流或設定，詳見限制。

#建立範例

把以下其中一段複製到提示框中。第一段是最小可用的起點。

Use @Google Analytics to build a traffic dashboard that only I can sign in to, where I pick a GA4 property and see the last 7 days of page views, sessions, and users as a daily chart, plus the top pages.

Use @Google Analytics to build a weekly traffic report that only I can sign in to, comparing this week with last week by traffic source and highlighting the biggest changes.

Use @Google Analytics to build a live visitors panel that shows how many people are on my site right now and which pages they are viewing.

Use @Google Analytics to add Google Analytics tracking to this app with my GA4 web stream's measurement ID, and send a sign_up event when someone registers.

用詞很重要：說明這個頁面給誰看、要顯示什麼。「只有我能登入的看板」與「公開的訪客計數器」會產生完全不同的應用程式。

#準備與連接

你需要一個可以開啟目標 GA4 媒體資源的 Google 帳戶。不需要 API 金鑰、Google Cloud 專案或帳單設定。

1. 點擊側欄的 Skills & Connectors（技能與連接器），然後搜尋 Google Analytics。
2. 開啟 Google Analytics 卡片並點擊 Connect（連接）。
3. 登入該 Google 帳戶，並同意 MeDo 要求的唯讀存取權限。
4. 按鈕變成 Connected（已連接） 即為成功，不需要把任何資訊複製回應用程式。

如果在連接前就開始建立，MeDo 會注意到，並在回覆下方顯示 Google Analytics 連接按鈕。也可以改走上面的連接器卡片。若沒有按鈕，就用連接器卡片。

#在應用程式中使用

• 應用程式使用建立者連接的帳戶，不是每位訪客自己的 Google 帳戶。 能看到流量頁面的訪客，看到的都是同一個帳戶的資料。讓訪客選擇多個媒體資源或自由查詢報表的看板，必須放在應用程式自己的登入之後；標題寫「私人」本身不是存取控制。只顯示單一固定網站概要數字的頁面可以公開，前提是媒體資源在伺服器端固定，訪客無法改選其他資源。
• 媒體資源 ID 要從已連接帳戶原樣複製。 使用 Google Analytics 回傳的 properties/<id>，不要自行猜測，也不要沿用其他帳戶的 ID。
• 標準報表有延遲。 新流量可能要 24 至 48 小時才會出現在標準報表中。即時資料幾分鐘內可見，涵蓋約過去 30 分鐘。空報表代表該區間沒有流量，不是失敗。
• 報表的數值是文字。 繪製圖表前，請依報表標題的順序把每個值轉成數字。報表比較兩個日期範圍時，Google Analytics 會多加一欄日期範圍。
• 大型報表要分頁。 單次請求最多回傳 1,000 列，需要更多時請讀取下一頁。
• 不要顯示捏造的數字。 帳戶未連接或報表為空時，頁面應如實說明，而不是顯示範例資料。
• 查詢 Measurement ID，不要憑記憶填寫。 MeDo 會從媒體資源的網站資料串流讀取，讓追蹤程式碼使用真實的 ID。

#限制與疑難排解

應用程式出現「Connection required」。 Google Analytics 連接歸應用程式業主。請業主打開連接器卡片並點擊 Connect，然後重新載入。

報表顯示 0 或圖表是空的。 通常代表該媒體資源在該區間沒有流量，或資料尚未入帳。請擴大日期，或確認網站確實把資料傳送到這個媒體資源。

媒體資源清單是空的。 已連接的 Google 帳戶無法開啟任何 GA4 媒體資源。請連接擁有這些媒體資源的帳戶。

訪客不該看到分析資料時卻看得到。 連接是共用的。為應用程式加上登入與伺服器端限制，見管理存取與角色。

#相關內容

• 連接器目錄 — 其他連接器及其用途。
• 技能與連接器 — 技能如何調用、計價與限制。
• 管理登入與使用者 — 在公開已連接資料前，先給應用程式自己的帳戶。