# 将 Meta Pixel 和 Conversions API 连接到 cPixel {#doc-title}

作者：[B2B Gold](/about/#how-we-write) 更新于 2026年9月25日 [使用 AI 工具从英文翻译](/docs/cpixel/connect-meta/) [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-meta&utm_term=docs-header)

## 我该如何将 Meta 连接到 cPixel？ {#how-do-i-connect-meta-to-cpixel}

在 cPixel 中打开目的地，选择 Meta，并粘贴来自 Meta Events Manager 的两个值：位于您数据集 **Settings** 下的 Pixel ID，以及在同一标签页更下方生成的 Conversions API 访问令牌。当 Meta 询问时，选择 Set up without Dataset Quality API。然后在实时中查看 Meta 对每次服务器端发送的回复。

### 粘贴到 cPixel {#paste-them-into-cpixel}

1. 在 cPixel 中打开**目的地**，点击**连接平台**下的 Meta 图标。**设置 Meta** 会打开并显示**粘贴您的 ID**。
2. 粘贴**Pixel / 数据集 ID**（[在哪里找到](#where-do-i-find-my-meta-pixel-id)）和 **Conversions API 访问令牌**（[如何获取](#how-do-i-get-a-conversions-api-access-token)）。没有令牌时，该账户将是**仅浏览器端**。
3. 如果需要，可在**为此账户命名（可选）**中为账户命名，然后点击**继续**。
4. 在**选择选项**中，保持**从浏览器发送事件**和**从我们的服务器发送事件**两项勾选。除非有其他工具向该数据集发送数据，否则请保持**否——由 cPixel 负责 Meta（推荐）**；尽管名称如此，选择**是——保留该应用，cPixel 将停止对 Meta 的服务器端发送**会同时停止 cPixel 向该像素的浏览器端和服务器端发送（[每个像素一个发送方](/zh-cn/docs/cpixel/official-channel-apps/)）。**高级设置**是可选的（[订单规则](/zh-cn/docs/cpixel/order-rules/)）。
5. 点击**保存并继续**。**测试一下**会确认**Meta 已连接**。

您可以连接多个 Meta 像素，它们会共享 cPixel 的事件 ID，但不能重复连接同一个像素。

## Meta Pixel ID 在哪里可以找到？ {#where-do-i-find-my-meta-pixel-id}

在 [Meta Events Manager](https://business.facebook.com/events_manager2) 中选择您店铺的 Web 数据集并打开 **Settings**：其中的 **Pixel ID**（约 15 位数字）需要填入 cPixel 的**Pixel / 数据集 ID**字段。Meta 在几乎其他所有地方都将其称为数据集 ID。

1. 找到您的数据集。Shopify 店铺使用的 Web 数据集带有显示器图标；电话图标表示应用数据集。
2. 选择它。在事件到达之前，新数据集会显示 **Your pixel hasn’t received any activity**。
3. 打开 **Settings**，复制 **Details** → **Pixel ID** 下方的数字。

> **提示：** 两个数据集可能使用相同的名称。如果只有其中一个能够生成令牌，那么它们其实是不同的数据集：请检查 ID。

## 我该如何获取 Conversions API 访问令牌？ {#how-do-i-get-a-conversions-api-access-token}

在同一个 **Settings** 标签页的 **Conversions API** 下，选择 **Set up without Dataset Quality API**，然后点击 **Generate access token**。勾选该店铺的数据集，并立即复制以 `EAA` 开头的长字符串令牌：Meta 只会显示一次，也不会保存它。

1. 将 **Settings** 向下滚动到 **Conversions API**。下面的截图与 Meta 自身的界面一样，在 **Set up direct integration** 下显示这些选项；而 Meta 的指南文字中写的是 **Set up manually**。请以您账户中实际显示的为准。
2. 选择 **Set up without Dataset Quality API**（[原因](#should-i-set-up-the-dataset-quality-api)）。
3. 点击 **Generate access token**，并勾选该店铺的数据集。
4. 在关闭面板之前复制令牌。Meta 的提示原文如此：**Copy and save this token somewhere safe. It won’t be stored by Facebook.**
5. 将其粘贴到 cPixel 的 **Conversions API 访问令牌**字段中。

> **重要：** 如果 **Generate access token** 显示为灰色（悬停时提示 **Missing prerequisite**），说明您不是拥有该数据集的商务组合的管理员或开发者（[Meta](https://developers.facebook.com/documentation/ads-commerce/conversions-api/get-started)）；使用个人广告账户创建的数据集就会出现这种情况。请联系商务组合的管理员，或在 Meta Business Suite 的 **Settings** 中的 **Data sources** 下[将数据集添加到商务组合](https://www.facebook.com/business/help/1910428752389787)。

令牌只对您勾选的数据集有效。Meta 没有说明 Events Manager 生成的令牌能使用多久，但如果其系统用户失去了对该数据集的访问权限，令牌就会失效，Meta 会将其报告为权限错误。

## 我需要设置 Dataset Quality API 吗？ {#should-i-set-up-the-dataset-quality-api}

不需要。cPixel 不需要它，而且 Meta 的对话框会提示，一旦某个数据集使用了 Quality API，目前就无法选择退出。Meta 将其标记为 **Recommended**，并表示它会增加诸如事件匹配率之类的指标；不使用它创建的令牌仍会发送相同的事件。

如果不设置，cPixel 的**事件质量**页面可能会显示**此种类型的令牌无法获取 Meta 的评分**，这正是 Quality API 会额外提供的唯一项目。发送本身不受影响。

## cPixel 会向 Meta 发送什么？ {#what-does-cpixel-send-to-meta}

PageView、ViewContent、Search、AddToCart、InitiateCheckout 和 AddPaymentInfo 会同时从买家的浏览器和 cPixel 的服务器发送，二者共用同一个事件 ID。Purchase 只从服务器发送，由 Shopify 订单重新构建而成。这里没有需要配置的去重设置。

- 只要 cPixel 向该像素的服务器端发送处于活动状态，浏览器端的 Purchase 就会被关闭。它只会在服务器端发送关闭或暂停时才会触发：没有令牌、令牌被拒绝、服务器端发送开关被关闭，或 Free 套餐暂停期间。
- 浏览器端的路径运行在 Shopify 的 Web Pixel 中，会在包括结账页在内的每个页面上执行，因此不需要应用嵌入。
- 服务器端发送携带经过哈希处理的邮箱、电话号码、客户 ID 和设备 ID，`_fbp` 和 `_fbc`，IP 地址和用户代理，以及默认情况下根据 IP 地址推测并经过哈希处理的位置信息。Meta 需要营销同意。详情请参阅[cPixel 发送的内容，以及同意如何改变它](/zh-cn/docs/cpixel/event-quality-and-consent/)。

## 我应该使用测试事件代码吗？ {#should-i-use-a-test-event-code}

只有在您想使用**测试连接**时才需要。cPixel 只会将该代码用于该测试，以及对 7 天内没有成功发送记录的账户进行的夜间检查，无论向导中的提示怎么写，实际事件从不携带该代码。该测试会发送一个真实的 PageView，[Meta 会保留它](https://developers.facebook.com/documentation/ads-commerce/conversions-api/using-the-api)用于定向和衡量。

- 从数据集的 **Test events** 标签页复制以 `TEST` 开头的代码，粘贴到**测试事件代码（可选）**中，然后点击**测试连接**：显示**运行正常**即表示 Meta 已接受该测试事件。
- 真实事件不携带该代码，因此您的购买事件不会出现在 **Test events** 中；请在数据集的 **Overview** 中查看。

## 我该如何确认它已经生效？ {#how-do-i-check-it-worked}

在**实时**中开始一个会话并浏览您的店铺：每次向 Meta 发送的服务器端事件都会显示 Meta 的回复——**已接受**、**已拒绝**或**错误**，以及 HTTP 状态码。然后在 Events Manager 中确认，[Meta 表示](https://developers.facebook.com/documentation/ads-commerce/conversions-api/using-the-api)您应该能在 20 分钟内看到事件。

1. 在 cPixel 中打开**实时**并点击**开始会话**。
2. 在另一个标签页中查看某个商品并将其加入购物车。
3. 打开一个**服务器**行：在**发送至**下，**Meta** 显示**已接受**。浏览器行不携带回复。
4. 在**目的地**中，该账户现在会显示为**已验证**。
5. 在 Events Manager 中，数据集的 **Overview** 会将 Purchase 的集成方式显示为 **Conversions API**，其他事件则显示为 **Multiple**，表示同时来自浏览器和服务器。

要查看购买事件，请下一笔真实订单：cPixel 默认会跳过测试订单。

## 如果不生效该怎么办？ {#what-if-it-doesnt-work}

如果 Meta 将访问令牌拒绝为无效或已过期，cPixel 会将该账户标记为**令牌无效**，停止其服务器端发送，并向您店铺的联系地址发送一封紧急提醒邮件；**首页**会显示**修复 Meta**。浏览器跟踪会继续运行。

1. 点击**首页**上的**修复 Meta**，或在**目的地**中点击该账户旁边的**管理**。
2. [生成一个新令牌](#how-do-i-get-a-conversions-api-access-token)，并粘贴到**已保存——粘贴新值即可替换**上方。
3. 点击**继续**，然后点击**保存并继续**。

| 您看到的情况 | 应对方法 |
| --- | --- |
| **Generate access token** 显示为灰色 | 获取该数据集所属商务组合的管理员或开发者权限 |
| **测试连接**：平台拒绝了此令牌 | 生成一个新令牌 |
| **测试连接**：平台拒绝了该账户的测试事件 | ID 有误，或该令牌属于另一个数据集 |
| **首页**上出现**Meta rejected an event**，原因是权限问题 | 恢复系统用户的访问权限，或生成一个新令牌 |
| 实时中购买显示**已跳过** | 查看原因，然后参阅[购买未显示](/zh-cn/docs/cpixel/purchases-missing/) |
| 购买被重复计算 | 有其他工具正在向该数据集发送数据：[每个像素一个发送方](/zh-cn/docs/cpixel/official-channel-apps/) |

在**管理 Meta**中点击**移除**会停止发送并删除已保存的令牌；您可以使用相同的 ID 重新连接。Meta 官方指南：[Conversions API: get started](https://developers.facebook.com/documentation/ads-commerce/conversions-api/get-started)。

## 相关内容 {#related}

- [在实时中查看每次发送](/zh-cn/docs/cpixel/live-events/)
- [每个像素一个发送方](/zh-cn/docs/cpixel/official-channel-apps/)
- [cPixel 如何做到每笔购买只计一次](/zh-cn/docs/cpixel/deduplication/)
- [在 Shopify 上设置 Conversions API](/blog/shopify-conversions-api/)

[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-meta&utm_term=card) [套餐和价格](/shopify/cpixel/#pricing)

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