# 开始使用 cPixel {#doc-title}

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

## 我该如何设置 cPixel？ {#how-do-i-set-up-cpixel}

从 Shopify App Store 安装 cPixel 后，它会打开**设置 cPixel**页面，共四个步骤：开启应用嵌入、连接您的第一个平台、选择套餐，以及查看首批事件到达。最后一步会打开已在运行会话的**实时**页面，让您在离开设置流程前就能看到真实事件被发送出去。

在您完成或跳过设置之前，打开任何页面都会显示设置流程，菜单中也只会显示**设置 cPixel**。

1. **开启应用嵌入**：点击**打开主题编辑器**会打开您已发布的主题，并停留在 **App embeds** 页面，此时 **cPixel 跟踪** 已经开启。在那里点击**保存**，该步骤会自动标记为完成。只有这一步才有**跳过此步骤**。
2. **连接您的第一个平台**：**选择平台**会列出全部七个平台，尽管正文只提到了其中四个。
3. **选择您的套餐**：点击**免费开始**，或选择一个付费套餐（例如**选择 Starter**），然后在 Shopify 的页面上确认（[比较套餐](/shopify/cpixel/#pricing)）。
4. **查看您的首批事件到达**：点击**开始查看**即可完成设置，并打开正在运行会话的**实时**页面；在 Free 套餐上，这会消耗您的一次实时会话额度。

**跳过设置**会跳转到**首页**，之后可以通过**完成设置**回到这里。侧边栏的**cPixel 的两种跟踪方式**说明了这两条路径。

> **注意：** 在您保存某个平台之前，系统不会在您的店铺中注册任何内容；保存后，**cPixel** 像素会出现在 **Settings** → **Customer events** 下。

## cPixel 会向哪些平台发送数据，又是从哪里发送的？ {#which-platforms-does-cpixel-send-to-and-from-where}

cPixel 会向七个平台发送数据。其中六个平台还会从 cPixel 的服务器接收事件，这些事件是根据 Shopify 订单而不是感谢页面构建的每一笔购买；Google Ads 只通过浏览器代码接收数据。浏览器端的数据来自 Shopify 的 Web Pixel（在包括结账页在内的每个页面上运行），或者来自应用嵌入加载的店铺前台代码。

| 平台 | 浏览器端 | 服务器端事件 | 购买来源 | 需要粘贴的内容 |
| --- | --- | --- | --- | --- |
| Meta | Web Pixel，所有页面 | PageView、ViewContent、Search、AddToCart、InitiateCheckout、AddPaymentInfo、Purchase | 服务器；浏览器作为后备 | **Pixel / 数据集 ID**；**Conversions API 访问令牌**（可选） |
| TikTok | 应用嵌入：Pageview | Pageview、ViewContent、Search、AddToCart、InitiateCheckout、AddPaymentInfo、CompletePayment | 服务器 | **像素代码**、**Events API 访问令牌** |
| Google Analytics 4 | Web Pixel，所有页面 | purchase、refund | 服务器 | **衡量 ID**；**Measurement Protocol API 密钥**（可选；发送购买事件时需要） |
| OpenAI Ads | 应用嵌入：页面浏览、商品查看、加入购物车 | checkout_started、order_created | 服务器 | **Pixel ID**、**Conversions API 密钥** |
| Snapchat | 应用嵌入：页面浏览、加入购物车 | START_CHECKOUT、ADD_BILLING、PURCHASE | 服务器 | **Snap Pixel ID**、**Conversions API 访问令牌** |
| Pinterest | 应用嵌入：页面访问、加入购物车 | initiate_checkout、checkout | 服务器 | **标签 ID**、**广告账户 ID**、**Conversions API 访问令牌** |
| Google Ads | Web Pixel，仅感谢页面 | 无 | 浏览器 | **转化 ID**、**转化标签** |

- 每个套餐都会进行服务器端发送；只有 Free 套餐会在达到月度订单额度时暂停（安装后最初几天除外）（[价格](/shopify/cpixel/#pricing)）。浏览器端跟踪从不计入额度。
- 如果 GA4、OpenAI Ads、Snapchat 或 Pinterest 的浏览器事件未能离开设备，cPixel 会改由服务器发送。
- Snapchat 和 Pinterest 的服务器端发送是新功能：自 2026 年 9 月起已投入生产环境，但尚未在真实广告账户上得到确认。
- 退款仅会发送给 GA4。暂不支持 Microsoft Advertising 和 X。

## cPixel 为什么需要应用嵌入？ {#why-does-cpixel-need-its-app-embed}

应用嵌入（**cPixel 跟踪**）会加载 TikTok、OpenAI Ads、Snapchat 和 Pinterest 的店铺前台代码，并让 cPixel 了解顾客的浏览行为，从而让更多事件能够与客户匹配。

关闭它之后，结账、购买、所有服务器端路径，以及 Meta、GA4 和 Google Ads 的浏览器事件仍会继续运行。会停止的是：这四个店铺前台代码、TikTok 浏览器与服务器页面浏览的配对、OpenAI 的点击 Cookie，以及按合集或标签进行的店铺前台定向。**首页**会显示**您的店铺前台未开启增强跟踪**。

### 开启应用嵌入 {#turn-on-the-app-embed}

1. 在**首页**点击**立即开启**，或点击**应用嵌入**旁的**开启**。您的主题编辑器会打开，并且 **App embeds** 下的 **cPixel 跟踪** 已经开启（[Shopify 的指南](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/apps)）。
2. 点击**保存**，然后返回 cPixel：**应用嵌入**会显示为**开启**。

> **重要：** 应用嵌入只属于一个主题。发布另一个主题后，请同样在该主题中开启 **cPixel 跟踪**；如果您忘记了，cPixel 会提醒您。

## 我该如何连接第一个平台？ {#how-do-i-connect-my-first-platform}

打开**目的地**，在**连接平台**下选择一个平台，然后按照向导操作：**粘贴您的 ID**、**选择选项**和**测试一下**。每份平台指南都会说明对应值的位置，可以先从[连接 Meta](/zh-cn/docs/cpixel/connect-meta/) 和[连接 OpenAI Ads](/zh-cn/docs/cpixel/connect-openai-ads/) 开始。

您不必一次性完成某个平台的设置：Meta 和 GA4 只需 ID 即可保存，状态为**仅浏览器端**，直到您添加令牌或密钥为止。TikTok、OpenAI Ads、Snapchat 和 Pinterest 从一开始就需要令牌。

## 我如何知道事件是否已送达？ {#how-do-i-know-events-are-arriving}

打开**实时**，点击**开始会话**，然后在另一个标签页中浏览您的店铺。在接下来的 10 分钟内，事件会随发送实时出现，服务器端发送还会显示平台的回复：[在实时中查看您的首批事件](/zh-cn/docs/cpixel/live-events/)。

在**目的地**页面，**已验证**表示服务器端发送已经成功，**凭证正常**表示**测试连接**已通过，**仅浏览器端**表示只有 ID、没有令牌。**首页**上的**显示检查项**会列出六项健康检查。每份连接指南都会说明在对应平台中应查看的位置。

> **提示：** cPixel 默认会跳过测试订单，包括开发商店中的所有订单，实时会将它们标记为**已跳过**；如需查看购买事件，请使用真实付款方式下单，或取消勾选**设置** → **测试订单**。

## 接下来该设置什么？ {#what-should-i-set-up-next}

接下来可以连接其他平台。您可以[继续使用 Facebook 和 Instagram 应用](/zh-cn/docs/cpixel/official-channel-apps/)，以及其他平台自己的应用来管理目录和商店，只需确保每个像素只有一个发送方即可。

- 如果购买事件丢失，请参阅[购买未显示](/zh-cn/docs/cpixel/purchases-missing/)；关于额度，请参阅 [cPixel 套餐](/zh-cn/docs/cpixel/plans/)；关于货到付款，请参阅[订单规则](/zh-cn/docs/cpixel/order-rules/)。
- 如需帮助：**首页** → **获取帮助** → **联系支持**，通常会在一个工作日内得到回复。

### 卸载 cPixel {#removing-cpixel}

cPixel 不会修改任何主题文件，也无法添加脚本标签，因此不需要手动清理任何内容。

1. 如果您使用的是付费套餐，请先在**套餐** → **取消套餐**中取消订阅（费用会按比例结算）；[卸载应用](https://help.shopify.com/en/manual/apps/uninstalling-apps)仍可能会对当前计费周期收费。
2. 在 Shopify 中，前往 **Settings** → **Apps**，点击 cPixel 旁边的 **…**，然后选择 **Uninstall**。Shopify 会自动移除 cPixel 的像素和[应用嵌入](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions/ux)。

cPixel 会立即删除您的访问令牌，其余数据大约在 48 小时后删除；如果您在此之前重新安装，设置会恢复，但令牌不会恢复。

## 相关内容 {#related}

- [连接 Meta](/zh-cn/docs/cpixel/connect-meta/)
- [连接 OpenAI Ads](/zh-cn/docs/cpixel/connect-openai-ads/)
- [在实时中查看您的首批事件](/zh-cn/docs/cpixel/live-events/)
- [继续使用 Facebook 和 Instagram 应用](/zh-cn/docs/cpixel/official-channel-apps/)

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

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