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

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

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

在 Snapchat Ads Manager 中打开 Events Manager，然后在 Event Sources 下找到您的 Snap Pixel：Pixel ID 会显示在它的名称下方，包括其中的连字符。对于令牌，请选择 Set Up Conversions API，然后选择 Manual Setup。将两者粘贴到 cPixel 中，cPixel 会在您的 Shopify 店铺前台触发 Snap Pixel，并从服务器发送结账、付款步骤和购买事件。

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

1. 在 cPixel 中打开**目的地**，点击**连接平台**下的 Snapchat 图标。**设置 Snapchat** 会打开并显示**粘贴您的 ID**。
2. 填写 **Snap Pixel ID** 和 **Conversions API 访问令牌**，两者均为必填。上方的灰色提示说购买事件不被跟踪，这条提示早于 cPixel 与 Snapchat 的服务器连接。如果需要，可在**为此账户命名（可选）**中为账户命名。
3. 点击**测试连接**：Snapchat 会用该令牌核对您的像素，但不会记录事件，确认的是访问权限，而不是送达情况。
4. 点击**继续**。在**选择选项**中，保持**从浏览器发送事件**和**从我们的服务器发送事件**两项勾选。除非有其他工具正在向该像素发送数据，否则请保持**否——由 cPixel 负责 Snapchat（推荐）**；尽管名称如此，选择**是——保留该应用，cPixel 将停止对 Snapchat 的服务器端发送**会停止 cPixel 向它的浏览器端和服务器端发送。
5. 点击**保存并继续**。**测试一下**会确认**Snapchat 已连接**。

> **重要：** Snapchat 官方的 Shopify 应用 Snapchat Ads 也会向一个 Snap Pixel 发送数据（[Snapchat](https://businesshelp.snapchat.com/s/article/enhanced-signal-integration-shopify)），因此请保持[每个像素一个发送方](/zh-cn/docs/cpixel/official-channel-apps/)。

## 我该在哪里找到 Snap Pixel ID？ {#where-do-i-find-my-snap-pixel-id}

在 Snapchat 的 **Events Manager** 中，位于您像素名称下方：一个由五组字母和数字通过连字符连接而成的 UUID，格式类似 `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`。

1. 在 [Snapchat Ads Manager](https://ads.snapchat.com/) 中打开左上角菜单（**Create Ads** 或 **Manage Ads**，取决于您所在的页面），选择 **Events Manager**。
2. 在左侧栏的 **Event Sources** 下打开您的 Snap Pixel。如果账户中还没有，请使用 **New Event Source**。
3. 将像素名称下方的 ID（包括连字符）复制到 cPixel 的 **Snap Pixel ID** 字段中。它也会出现在地址栏中，位于 `/events/pixel/` 之后。

- 广告账户 ID 同样是一个 UUID，是地址栏中的第一个。
- 请跳过 **Set Up Snap Pixel**：cPixel 通过其应用嵌入加载 Snap Pixel，重复安装一份 Snapchat 代码可能会导致页面浏览被计算两次。

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

在 Snapchat Ads Manager 中生成它，可以从您像素自己的设置里操作，或者以 Organization Admin 身份，在 **Business Details** 下操作。这是必填项。

### 从您的 Snap Pixel {#from-your-snap-pixel}

1. 在您像素的页面上，在 **Send events from a server** 下点击 **Set Up Conversions API**。
2. 在 **Set Up Method** 中选择 **Manual Setup**，而不是 **Partner Integration** 或 **Conversions API Gateway**。
3. 按步骤操作到最后，点击 **Copy Access Token**。Snapchat 还会显示令牌的端点 `https://tr.snapchat.com/v3/<pixel-id>/events`，其中应包含您的 Pixel ID。

### 从 Business Details {#from-business-details}

这是 Snapchat 官方指南给出的路径（[Snapchat](https://businesshelp.snapchat.com/s/article/activate-capi)）：

1. 在 Ads Manager 中打开左上角菜单，进入 **Business Dashboard** → **Business Details**。
2. 在 **Conversions API Tokens** 下点击 **Generate Token** 并复制它。

Snap 表示这些令牌不会过期，并且只能用于创建它们的组织所拥有的像素（[Snap](https://developers.snap.com/marketing-api/Conversions-API/GetStarted)）。cPixel 会保存您的令牌，并且不会再次显示。

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

来自 Snap Pixel（由 cPixel 的应用嵌入加载）的店铺前台事件，以及通过 Snapchat 的 Conversions API（第 3 版）从 cPixel 服务器发送的结账、付款步骤和购买事件；每个事件只走一条路径。

- **`PAGE_VIEW` 和 `ADD_CART`** 来自 Snap Pixel，仅在应用嵌入开启时有效。如果浏览器阻止了该像素，cPixel 会改由服务器发送该事件。
- **`START_CHECKOUT`、`ADD_BILLING` 和 `PURCHASE`** 来自 cPixel 的服务器：结账开始、提交付款信息，以及由 Shopify 订单重新构建而成的购买事件，因为结账页上没有主题代码运行。

在已知的情况下，服务器端事件会携带经过哈希处理的邮箱、电话号码和 Shopify 客户 ID，以及 IP 地址和用户代理；不会采集 Snapchat 的点击 ID。Snapchat 会在 48 小时内按事件 ID 去重，购买事件还会在最长 30 天内按订单 ID 去重（[Snap](https://developers.snap.com/marketing-api/Conversions-API/Deduplication)）。

> **注意：** cPixel 与 Snapchat 的服务器连接是新功能：自 2026 年 9 月起已投入生产环境，但尚未在真实广告账户上得到确认。请在实时中检查您的第一笔结账和购买事件。

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

在 cPixel 的实时中查看一次结账和一笔购买，服务器端发送会显示 Snapchat 的回复，然后在 Snapchat 的 Events Manager 中确认。

1. 在 cPixel 中打开**实时**并点击**开始会话**。
2. 在另一个标签页中浏览您的店铺并加入购物车。**浏览器**行会将 Snapchat 列为**已从浏览器发送**，没有回复：平台不会回复浏览器端发送。
3. 开始结账并下一笔真实订单；cPixel 默认会跳过测试订单。它们的**服务器**行应该会显示 Snapchat **已接受**。
4. 在 **Events Manager** 的主屏幕上，服务器端事件会标注“via Conversions API”；Snapchat 表示最长需要 1–2 小时才会显示（[Snapchat](https://businesshelp.snapchat.com/s/article/capi-verifying-setup)）。

**目的地**会在首次成功的服务器端发送（通常是第一次结账）后将该账户标记为**已验证**。Events Manager 也会显示 Snapchat 自己的 [Event Quality Score](https://businesshelp.snapchat.com/s/article/view-event-quality-score)；cPixel 不会读取它。

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

如果 Snapchat 没有收到 cPixel 的事件，请打开实时中的 Snapchat 行：未显示**已接受**的发送会注明原因。

| 您看到的情况 | 应对方法 |
| --- | --- |
| **测试连接**拒绝了该令牌 | 重新复制一次令牌，并确认它来自拥有该像素的组织 |
| **已拒绝**或**错误** | 查看该行详情中 Snapchat 的回复；cPixel 会自行重试错误 |
| 您的像素没有收到任何数据 | 检查 Pixel ID：可能丢失了连字符，或者填成了广告账户 ID |
| **首页**上出现**修复 Snapchat**：令牌被拒绝或已删除，服务器端发送已停止，并已[发送](/zh-cn/docs/cpixel/alerts-and-reconciliation/)一封紧急提醒邮件 | 生成一个新令牌，点击**修复 Snapchat**，或在**目的地**中点击该账户旁边的**管理**，粘贴并保存 |
| 没有**浏览器**行提及 Snapchat | 应用嵌入已关闭（**浏览器**徽章显示**需要应用嵌入**）：开启 **cPixel 跟踪**并保存主题，更换主题后需再次操作 |
| 购买事件丢失或显示**已跳过** | 查看原因，然后参阅[购买未显示](/zh-cn/docs/cpixel/purchases-missing/) |
| 页面浏览或购买被重复计算 | 有其他工具（如 Snapchat Ads 应用或主题中的像素代码）正在向该像素发送数据 |

在**管理 Snapchat**中点击**移除**会停止向该账户发送数据并删除其令牌。

## 相关内容 {#related}

- [开启应用嵌入](/zh-cn/docs/cpixel/getting-started/)
- [在实时中查看每次发送](/zh-cn/docs/cpixel/live-events/)
- [每个像素一个发送方](/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/connect-snapchat&utm_term=card) [套餐和价格](/shopify/cpixel/#pricing)

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