將 Google Analytics 4 (GA4) 連接到你的 Atoms 專案，以追蹤網站流量並了解使用者如何與你已發佈的網站互動。

本指南將帶你完成完整的設定流程：開啟 GA4 連接、授權正確的 Google 帳戶、選取你正式上線網站所使用的資源、發佈追蹤更新、確認資料正在收集，以及為之後的 Google Search Console 驗證準備好連接。

GA4 連接的運作方式

GA4 資源 是 Google Analytics 中用來收集並報告網站或 app 資料的資源。Atoms 會使用你授權的 Google 帳戶，尋找該帳戶可存取的 Analytics 帳戶與資源。請為你目前的 Atoms 專案連接已發佈網站所使用的資源。

設定分為三個部分：

1. 授權 Google 帳戶。登入可存取正確 GA4 資源的帳戶，並核准所要求的 Google 權限。
2. 連接相符的資源。選取你的專案正式網站所使用的 Analytics 帳戶與 GA4 資源。
3. 加入追蹤設定、發佈並檢查報表。等待 Atoms 加入追蹤設定，檢查並發佈更新後的網站，然後確認已連接正確的資源且正在接收資料。

GA4 連接與 Sarah 的 SEO 內容工作流程是分開的。Sarah 即使沒有 GA4，也能規劃並產生 SEO 頁面。此連接是用於 Analytics 報表。

如果連接符合 Google 的要求，由使用者授權的 GA4 連接也可在你之後連接 Google Search Console 時支援自動網站驗證。

開始之前

在連接 Google Analytics 4 (GA4) 之前，請確認：

• 你是 專案擁有者。其他協作者可能可以檢視專案，但只有擁有者可以管理其 GA4 連接。
• 你擁有可存取網站所使用 GA4 資源的 Google 帳戶。
• 你知道哪個 GA4 資源屬於已發佈的網站。如果有多個名稱相似的資源，請先在 Google Analytics 中檢查網站或網站資料串流。
• 你的網站已產生完成，且已發佈或準備發佈。如果 Marketing → Analytics 提示你先開始建置網站，請先完成產生後再繼續。
• 你的瀏覽器允許來自 Atoms 的 Google 授權彈出視窗。
• 在你變更 Marketing 連接之前，目前任何 Sarah 或 Alex 任務都已完成。

你可以在自訂網域正式上線前先連接 GA4。不過，在 Analytics 報表出現之前，你已發佈的網站必須先將資料傳送到已連接的資源。

如果你打算使用 GA4 協助在 Google Search Console 中驗證網站，請對兩個連接都使用相同的 Google 帳戶。該帳戶也必須對 GA4 資源具有 編輯權限。

如果你無法存取該資源，請要求其 Google Analytics 管理員授予你所需的存取權。請參閱 Google 的 Analytics 使用者存取指南。

如果你的 Google 帳戶尚未擁有 Analytics 帳戶、資源或網站資料串流，Atoms 可能會在設定期間引導你建立。你也可以直接在 Google Analytics 中依照 Google 的 網站 Analytics 設定指南 建立這些項目。

Google Analytics 權限：請使用可存取此網站之 Analytics 帳戶與 GA4 資源的 Google 帳戶。選取現有資源或網站資料串流需要對該資源具有存取權。在設定中建立 Analytics 帳戶、GA4 資源或網站資料串流，則需要在相關 Analytics 層級具有 Editor 權限（或同等權限）。如果缺少某項資源，或你沒有所需權限，請要求 Analytics 管理員先授予存取權或在 Google Analytics 中建立該資源，然後回到 Atoms 並選取 Refresh。

請勿將 Google 密碼、驗證碼、存取 Token 或其他憑證貼到 Chat 中。

連接 Google Analytics 4

開啟 GA4 連接器

1. 開啟你想要衡量其已發佈網站的 Atoms 專案。
2. 在專案工具列中選取 Marketing。
3. 開啟 Analytics。如果你是從 Overview 開始，也可以在 Marketing 下找到 Analytics 卡片，並選取 Set up Analytics。
4. 選取 Authorize GA4。這會授權 Google 帳戶；你將在後續步驟中連接資源。

從 Marketing 授權 Google Analytics 4

授權 Google 帳戶

1. 在 Google 授權視窗中，登入可存取此網站 GA4 資源的 Google 帳戶。
2. 確認已選取正確的 Google 帳戶。
3. 檢查 Atoms 要求的存取權限。只有在你同意時才繼續。
4. 返回 Atoms，並等待授權步驟完成。

如果瀏覽器封鎖授權視窗，請允許 Atoms 的彈出視窗後再試一次。如果 Atoms 提供 Open authorization page，請使用它在新分頁中繼續。

連接正式網站的資源

在你授權 Google 帳戶後，Atoms 會顯示你可存取的 Google Analytics 帳戶與資源。接下來看到的內容可能會因你的帳戶連結了多少 Analytics 資源而有所不同。

1. 如果 Atoms 要求你選擇 Analytics account，請選取包含你網站資源的帳戶。
2. 選取已發佈網站所使用的 GA4 property。如果你不確定該選哪一個，請先在 Google Analytics 中檢查該資源。
3. 如果出現 web data stream，請確認它使用的是正確的正式網站網址。
4. 選取 Connect property。
5. 保持頁面開啟，直到 Atoms 確認連接完成。

如果缺少部分 Analytics 設定：

• 沒有 Analytics 帳戶：如果可用，請選取 Let Atoms create it for you fast，完成 Google 設定後返回 Atoms，並選取 Refresh。
• 沒有 GA4 資源：選取正確的 Analytics 帳戶，然後選擇 Create property in Atoms，並等待新資源出現。
• 沒有網站資料串流：選取該資源，並在 Create web stream 下選擇 Quick Create，或在 Google Analytics Admin 中手動建立。

如果本來應該已存在的帳戶、資源或資料串流沒有出現，請確認你使用的是正確的 Google 帳戶，且你對其具有存取權。如果它是最近才建立或分享給你的，請稍候片刻後選取 Refresh。

連接正式網站所使用的 GA4 資源

完成追蹤更新並發佈

連接 Google 資源本身並不會讓已發佈的網站立即開始收集資料。在 Atoms 確認資源連接後，它會啟動一個專案任務，將 Analytics 追蹤設定加入網站。

1. 等待追蹤任務完成。在更新執行期間，避免啟動其他建置或 Marketing 任務。
2. 檢查已完成的變更並預覽網站。確認網站仍可正常載入且行為符合預期。
3. 發佈更新後的專案。如果網站已經上線，請確認目前已發佈的是最新更新版本。
4. 在新分頁中開啟已發佈的首頁，並正常使用網站以產生一次測試造訪。
5. 返回 Marketing → Analytics 檢查連接狀態，並在 Google 處理該次造訪後檢查報表狀態。

預期結果：Atoms 會顯示預期的資源已連接，追蹤更新已存在於已發佈版本中，而正式網站開始將新的活動傳送到該資源。連接 GA4 不會為開始收集之前發生的活動建立歷史資料。

檢查連接是否成功

1. 返回 Marketing → Analytics。
2. 確認 Google Analytics 4 設定不再顯示初始連接提示。
3. 檢查已連接的帳戶或資源是否與正式網站相符。
4. 如果 Analytics 報表區域可用，請開啟它並選擇最近的日期範圍。
5. 如果網站是新的，請造訪已發佈網站，之後再回來檢查是否已有處理完成的資料。

空白報表不一定代表授權失敗。請將已連接資源的狀態與報表狀態視為兩個不同的檢查點。請確認追蹤任務已完成、更新後的版本已發佈，且同一個資源正在接收來自正式網站的事件。Google 指出，許多標準 GA4 報表在開始收集後可能需要 24–48 小時才會顯示資料；如果你需要更早確認是否已開始收集，請使用 Google Analytics Realtime。請參閱 Google 的 資料收集驗證指南。

在 GA4 資料可用後檢查 Analytics 報表

從失敗的 GA4 連接中復原

請根據失敗的狀態選擇下一個安全的操作。授權失敗或資源清單載入失敗，通常需要重新開啟授權視窗、使用正確的 Google 身分，或在取得存取權後重新整理。若資源已連接但沒有報表資料，則在重試連接前需要先檢查追蹤任務與發佈狀態。

• 授權或帳戶載入失敗：允許彈出視窗、若有提供則重新開啟 Open authorization page、確認預期的 Google 身分，然後重試一次。
• 缺少帳戶、資源或串流：確認你具有所需的存取權與建立所需的 Editor 權限，然後在最近建立或分享的資源可用後選取 Refresh。
• 資源已連接，但追蹤或報表失敗：等待追蹤任務完成、預覽並發佈最新版本、確認已連接的資源與正式網站相符，並在重試前使用 Google Analytics Realtime 或等待文件中說明的報表延遲時間。

如果同一階段在重試一次後仍然失敗，請聯絡 Atoms Support 或你的工作區管理員。請附上專案名稱、若有顯示則附上已連接的資源名稱、失敗階段、可見的狀態或錯誤文字、大約時間，以及已遮蔽敏感資訊的螢幕截圖。切勿包含密碼、驗證碼、存取 Token、OAuth 代碼或其他憑證。

將 GA4 與 Google Search Console 搭配使用

以 Google Analytics 為基礎的 Search Console 驗證是有條件的。在 Atoms 中，Auto Verify via Google Analytics 需要符合資格且由使用者授權的 GA4 連接。由 Atoms 建立並代管的 GA4 設定無法使用此自動驗證操作。如果你使用 Google 的手動驗證方法，則不需要 GA4。

如需在 Search Console 中設定並驗證你的網站，請參閱 Connect Google Search Console 以取得完整步驟與要求。

Google 的 Analytics 驗證方法也要求公開首頁包含受支援的 Analytics 標籤，且適用於 URL-prefix 類型的 Search Console 資源，而非 Domain 類型資源。如果因為 GA4 設定由 Atoms 代管，或任何 Google 要求未滿足而無法使用自動驗證，請改用 Verify manually in Google Search Console。請參閱 Google 的 網站擁有權驗證要求。

如需相關內容與報表工作流程，請參閱 SEO 智能體。