# 將 Google Analytics 4 連接到 cPixel {#doc-title}

作者：[B2B Gold](/about/#how-we-write) 更新日期：2026年9月25日 [使用 AI 工具從英文翻譯](/docs/cpixel/connect-ga4/) [cPixel 頁面](/shopify/cpixel/) [Shopify App Store 上的 cPixel](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=zh-tw/docs/cpixel/connect-ga4&utm_term=docs-header)

## 如何將 GA4 連接到 cPixel？ {#how-do-i-connect-ga4-to-cpixel}

在 Google Analytics 中，前往 Admin、Data collection and modification、Data streams，開啟你的網頁串流並複製以 G- 開頭的評估 ID。在同一個面板中，開啟 Measurement Protocol API secrets 並建立一個密鑰。將兩者都貼到 cPixel，然後用一筆真實訂單確認，因為 GA4 會悄悄接受錯誤的密鑰。

### 貼到 cPixel 中 {#paste-them-into-cpixel}

1. 在 cPixel 中，開啟**目的地**，點擊**連接平台**底下的 GA4 圖示。**設定 Google Analytics 4** 會開啟並停在**貼上你的 ID**。
2. 將評估 ID 貼到**評估 ID**，密鑰貼到**Measurement Protocol API 密鑰（選填）**。如果你想要，可以在**為這個帳戶命名（選填）**底下命名這個帳戶，然後點擊**繼續**。
3. 在**選擇選項**中，保持**從瀏覽器傳送事件**與**從我們的伺服器傳送事件**勾選。除非另一個工具也會傳送到這個資源，否則請保持**沒有 — 由 cPixel 負責處理 Google Analytics 4（建議）**：儘管名稱是這樣，**有 — 請保留它，cPixel 將停止對 Google Analytics 4 進行伺服器端傳送**會停止 cPixel 對它的瀏覽器與伺服器傳送。
4. 在**進階設定**底下，**資料所在地**可以將伺服器端事件傳送到 Google 的歐盟端點；只有端點會改變。點擊**儲存並繼續**。**測試連線**會確認**Google Analytics 4 已連接**。

> **重要：** 密鑰在精靈中是選填的，但沒有它，帳戶會維持**僅瀏覽器**狀態：只有瀏覽事件，沒有購買事件。

## 我要去哪裡找我的 GA4 評估 ID？ {#where-do-i-find-my-ga4-measurement-id}

在 GA4 **Admin** 中你網頁串流的詳細資料裡：`G-` 加上英文字母與數字，通常共 10 碼（[Google](https://support.google.com/analytics/answer/12270356)）。

1. 在 [Google Analytics](https://analytics.google.com/analytics/web/) 中選擇你的資源，點擊左下角的 **Admin**，在 **Data collection and modification** 底下點擊 **Data streams**。
2. 點擊你商店的網頁串流。**評估 ID** 位於 **Stream details** 的第一列；可以使用旁邊的複製圖示。

> **注意：** 評估 ID 不是同一列上一個純數字的 **Stream ID**，也不是資源 ID。cPixel 要的是以 `G-` 開頭的那個。

## 我要如何建立 Measurement Protocol API 密鑰？ {#how-do-i-create-a-measurement-protocol-api-secret}

在同一個串流面板中：開啟 **Measurement Protocol API secrets**，建立一個密鑰並複製它的值，大約 22 個字元。Google 的指南：[Measurement Protocol for GA4](https://developers.google.com/analytics/devguides/collection/protocol/ga4)。

1. 捲動到 **Events** 區塊，點擊最後一列的 **Measurement Protocol API secrets**。現有的密鑰會列在這裡，你也可以重複使用其中一個。
2. 點擊 **Create**，取一個暱稱，例如 cPixel，再次點擊 **Create**，然後將 **Secret value** 複製到 cPixel 中。

Google 可能會先要求你確認其使用者資料收集條款（[Google](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/properties/acknowledgeUserDataCollection)）。

## 為什麼 GA4 不會對錯誤的密鑰發出警告？ {#why-doesnt-ga4-warn-about-a-wrong-secret}

因為 Measurement Protocol 從不回報錯誤。Google 表示它「即使事件格式錯誤，也不會回傳 HTTP 錯誤碼」，而且它的驗證伺服器不會檢查 API 密鑰（[Google](https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events)）。

因此，錯誤的密鑰在各處看起來都像是成功的：即時畫面顯示**已接受**，帳戶顯示**已驗證**，也不會觸發任何警示，而 GA4 則會直接捨棄資料。**測試連線**使用的是 Google 的驗證伺服器，因此它檢查的是酬載內容，而不是密鑰。

## cPixel 會傳送什麼給 GA4？從哪裡傳送？ {#what-does-cpixel-send-to-ga4-and-from-where}

購買與退款事件來自 cPixel 的伺服器；其他所有事件則來自顧客的瀏覽器，或是在瀏覽器端的副本沒有送出時改由伺服器傳送。

| 傳送來源 | 事件 |
| --- | --- |
| 瀏覽器：Shopify 的網頁像素，涵蓋包含結帳在內的每一頁 | page_view、view_item、view_item_list、search、view_cart、add_to_cart、remove_from_cart、begin_checkout、add_shipping_info、add_payment_info |
| 伺服器：Measurement Protocol | purchase，以訂單作為交易 ID；refund，在你退款時送出 |
| 僅在瀏覽器無法送出時，改由伺服器傳送 | 從未離開顧客裝置的瀏覽器事件，在即時中會標示為重新傳送一個被封鎖的瀏覽器事件 |

GA4 會在網頁串流上依交易 ID 對購買事件去重複（[Google](https://support.google.com/analytics/answer/12313109)），但不會對其他事件去重複，因此 cPixel 只會傳送一次那些事件。當封鎖工具同時擋下 cPixel 自己的請求時，它就無法復原該事件，也無法得知 GA4 是否拒絕了某個瀏覽器事件。

購買事件需要 cPixel 的像素在結帳時記錄的瀏覽器工作階段。如果沒有，例如封鎖工具擋下了 cPixel 的請求，即時畫面會顯示「資料不足，無法為這個目的地建立酬載內容」，GA4 也不會收到購買事件。

伺服器端購買事件會攜帶 GA4 的用戶端與工作階段 ID、雜湊過的電子郵件與電話，以及未經雜湊處理、以 `user_id` 形式傳送的 Shopify 顧客 ID。兩種途徑都需要顧客的分析同意。

> **注意：** 只有在事件於工作階段開始 24 小時內送達時，GA4 才會賦予伺服器端事件其造訪的來源、媒介與活動資訊（[Google](https://developers.google.com/analytics/devguides/collection/protocol/ga4/use-cases)）。較晚傳送的購買事件，例如在**設定**中選擇**訂單出貨時**，可能會遺失其活動資訊。

Shopify 的 Google & YouTube App 也可以將頁面瀏覽與購買事件傳送到你的資源，因此請保持[每個像素一個傳送來源](/zh-tw/docs/cpixel/official-channel-apps/)。cPixel 每天的掃描會標示出貼在你佈景主題中的 GA4 標記：

## 我要如何檢查它是否成功？ {#how-do-i-check-it-worked}

下一筆真實訂單，然後在 cPixel 的**即時**與 GA4 的 **Realtime** 報表中尋找這筆購買。測試訂單預設會被略過：請使用真實的付款方式，或取消勾選**設定** → **測試訂單**。

1. 在 cPixel 中，開啟**即時**，點擊**開始工作階段**，然後在另一個分頁下單。
2. 開啟這筆購買的**伺服器**列。Google Analytics 4 顯示**已接受**，這只代表 Google 有回應。
3. 在 GA4 中，開啟 **Realtime** 報表並尋找這筆購買。Realtime 通常需要幾分鐘，其他報表則需要 24 到 48 小時（[Google](https://support.google.com/analytics/answer/11198161)）。

DebugView 不會顯示它：它只列出以偵錯模式送出的事件，而 cPixel 的真實傳送並非如此（[Google](https://support.google.com/analytics/answer/7201382)）。

## 如果沒有成功該怎麼辦？ {#what-if-it-doesnt-work}

大多數失敗都會顯示在 cPixel 的**即時**中；錯誤的密鑰則什麼都不會顯示，因此要直接檢查 GA4 本身。

| 你看到的畫面 | 代表的意思 | 該怎麼做 |
| --- | --- | --- |
| 即時中顯示**已接受**，但 48 小時後 GA4 中仍沒有購買事件 | 密鑰或評估 ID 錯誤，或來自另一個串流 | 在同一個串流上建立一個密鑰，貼到**目的地**頁面的**管理 Google Analytics 4**，然後點擊**繼續**與**儲存並繼續** |
| **已略過**，並附上原因 | cPixel 選擇不傳送，例如沒有分析同意或是測試訂單 | 以真實方式付款，或取消勾選**測試訂單** |
| 帳戶顯示**僅瀏覽器** | 沒有儲存密鑰 | 在**管理 Google Analytics 4**中新增一個 |
| 頁面瀏覽數變成兩倍，營收正確 | 另一個傳送來源，例如 Google & YouTube App 或佈景主題中的標記 | 保持[每個資源一個傳送來源](/zh-tw/docs/cpixel/official-channel-apps/) |

在**管理 Google Analytics 4**中點擊**移除**會停止對該帳戶的傳送，並刪除它的密鑰。

## 相關頁面 {#related}

- [為什麼 GA4 的購買數字與 Shopify 對不上](/blog/ga4-shopify-purchases/)
- [在即時中觀看每次傳送](/zh-tw/docs/cpixel/live-events/)
- [每個像素一個傳送來源](/zh-tw/docs/cpixel/official-channel-apps/)
- [cPixel 如何讓每筆購買只計算一次](/zh-tw/docs/cpixel/deduplication/)

[cPixel Facebook Pixel CAPI GA4](/shopify/cpixel/)

[從 Shopify App Store 免費安裝](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=zh-tw/docs/cpixel/connect-ga4&utm_term=card) [方案與價格](/shopify/cpixel/#pricing)

需要 cPixel 的相關協助嗎？請寄送電子郵件至 [support@b2bgold.app](mailto:support@b2bgold.app)。