# 将 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-cn/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，打开您的 Web 数据流，复制以 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** 中您 Web 数据流的详情里：以 `G-` 开头，后接字母和数字，通常共十位（[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. 点击您店铺的 Web 数据流。**Measurement 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 的 Web Pixel，在包括结账页在内的每个页面上 | 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 会在 Web 数据流上按事务 ID 对购买事件去重（[Google](https://support.google.com/analytics/answer/12313109)），但不会对其他事件去重，因此 cPixel 只会各发送一次这些事件。当拦截程序同时也阻止了 cPixel 自身的请求时，它就无法恢复该事件，也无法察觉 GA4 拒绝了某个浏览器端事件。

购买事件需要 cPixel 的像素在结账时记录的浏览器会话。如果没有这个会话——例如拦截程序阻止了 cPixel 的请求——实时会显示“数据不足，无法为此目的地构建负载”，GA4 也不会收到购买事件。

服务器端购买事件携带 GA4 的客户端 ID 和会话 ID、经过哈希处理的邮箱和电话号码，以及未经哈希处理、作为 `user_id` 的 Shopify 客户 ID。两条路径都需要买家的分析同意。

> **注意：** 只有在会话开始后 24 小时内到达时，GA4 才会为服务器端事件赋予该次访问的来源、媒介和广告系列信息（[Google](https://developers.google.com/analytics/devguides/collection/protocol/ga4/use-cases)）。使用**设置**中的**订单发货时**等选项较晚发送的购买事件，可能会丢失其广告系列信息。

Shopify 的 Google & YouTube 应用也可以向您的媒体资源发送页面浏览和购买事件，因此请保持[每个像素一个发送方](/zh-cn/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 应用或主题中的代码 | 保持[每个媒体资源一个发送方](/zh-cn/docs/cpixel/official-channel-apps/) |

在**管理 Google Analytics 4**中点击**移除**会停止向该账户发送数据并删除其密钥。

## 相关内容 {#related}

- [为什么 GA4 购买数据与 Shopify 对不上](/blog/ga4-shopify-purchases/)
- [在实时中查看每次发送](/zh-cn/docs/cpixel/live-events/)
- [每个像素一个发送方](/zh-cn/docs/cpixel/official-channel-apps/)
- [cPixel 如何做到每笔购买只计一次](/zh-cn/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-cn/docs/cpixel/connect-ga4&utm_term=card) [套餐和价格](/shopify/cpixel/#pricing)

需要 cPixel 方面的帮助？请发送电子邮件至 [support@b2bgold.app](mailto:support@b2bgold.app)。