将 Snap Pixel 和 Conversions API 连接到 cPixel
我该如何将 Snapchat 连接到 cPixel?
在 Snapchat Ads Manager 中打开 Events Manager,然后在 Event Sources 下找到您的 Snap Pixel:Pixel ID 会显示在它的名称下方,包括其中的连字符。对于令牌,请选择 Set Up Conversions API,然后选择 Manual Setup。将两者粘贴到 cPixel 中,cPixel 会在您的 Shopify 店铺前台触发 Snap Pixel,并从服务器发送结账、付款步骤和购买事件。
粘贴到 cPixel
- 在 cPixel 中打开目的地,点击连接平台下的 Snapchat 图标。设置 Snapchat 会打开并显示粘贴您的 ID。
- 填写 Snap Pixel ID 和 Conversions API 访问令牌,两者均为必填。上方的灰色提示说购买事件不被跟踪,这条提示早于 cPixel 与 Snapchat 的服务器连接。如果需要,可在为此账户命名(可选)中为账户命名。
- 点击测试连接:Snapchat 会用该令牌核对您的像素,但不会记录事件,确认的是访问权限,而不是送达情况。
- 点击继续。在选择选项中,保持从浏览器发送事件和从我们的服务器发送事件两项勾选。除非有其他工具正在向该像素发送数据,否则请保持否——由 cPixel 负责 Snapchat(推荐);尽管名称如此,选择是——保留该应用,cPixel 将停止对 Snapchat 的服务器端发送会停止 cPixel 向它的浏览器端和服务器端发送。
- 点击保存并继续。测试一下会确认Snapchat 已连接。
重要: Snapchat 官方的 Shopify 应用 Snapchat Ads 也会向一个 Snap Pixel 发送数据(Snapchat),因此请保持每个像素一个发送方。
我该在哪里找到 Snap Pixel ID?
在 Snapchat 的 Events Manager 中,位于您像素名称下方:一个由五组字母和数字通过连字符连接而成的 UUID,格式类似 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
- 在 Snapchat Ads Manager 中打开左上角菜单(Create Ads 或 Manage Ads,取决于您所在的页面),选择 Events Manager。
- 在左侧栏的 Event Sources 下打开您的 Snap Pixel。如果账户中还没有,请使用 New Event Source。
- 将像素名称下方的 ID(包括连字符)复制到 cPixel 的 Snap Pixel ID 字段中。它也会出现在地址栏中,位于
/events/pixel/之后。
- 广告账户 ID 同样是一个 UUID,是地址栏中的第一个。
- 请跳过 Set Up Snap Pixel:cPixel 通过其应用嵌入加载 Snap Pixel,重复安装一份 Snapchat 代码可能会导致页面浏览被计算两次。
我该如何获取 Conversions API 令牌?
在 Snapchat Ads Manager 中生成它,可以从您像素自己的设置里操作,或者以 Organization Admin 身份,在 Business Details 下操作。这是必填项。
从您的 Snap Pixel
- 在您像素的页面上,在 Send events from a server 下点击 Set Up Conversions API。
- 在 Set Up Method 中选择 Manual Setup,而不是 Partner Integration 或 Conversions API Gateway。
- 按步骤操作到最后,点击 Copy Access Token。Snapchat 还会显示令牌的端点
https://tr.snapchat.com/v3/<pixel-id>/events,其中应包含您的 Pixel ID。
从 Business Details
这是 Snapchat 官方指南给出的路径(Snapchat):
- 在 Ads Manager 中打开左上角菜单,进入 Business Dashboard → Business Details。
- 在 Conversions API Tokens 下点击 Generate Token 并复制它。
Snap 表示这些令牌不会过期,并且只能用于创建它们的组织所拥有的像素(Snap)。cPixel 会保存您的令牌,并且不会再次显示。
cPixel 会向 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)。
注意: cPixel 与 Snapchat 的服务器连接是新功能:自 2026 年 9 月起已投入生产环境,但尚未在真实广告账户上得到确认。请在实时中检查您的第一笔结账和购买事件。
我该如何确认它已经生效?
在 cPixel 的实时中查看一次结账和一笔购买,服务器端发送会显示 Snapchat 的回复,然后在 Snapchat 的 Events Manager 中确认。
- 在 cPixel 中打开实时并点击开始会话。
- 在另一个标签页中浏览您的店铺并加入购物车。浏览器行会将 Snapchat 列为已从浏览器发送,没有回复:平台不会回复浏览器端发送。
- 开始结账并下一笔真实订单;cPixel 默认会跳过测试订单。它们的服务器行应该会显示 Snapchat 已接受。
- 在 Events Manager 的主屏幕上,服务器端事件会标注“via Conversions API”;Snapchat 表示最长需要 1–2 小时才会显示(Snapchat)。
目的地会在首次成功的服务器端发送(通常是第一次结账)后将该账户标记为已验证。Events Manager 也会显示 Snapchat 自己的 Event Quality Score;cPixel 不会读取它。
如果不生效该怎么办?
如果 Snapchat 没有收到 cPixel 的事件,请打开实时中的 Snapchat 行:未显示已接受的发送会注明原因。
| 您看到的情况 | 应对方法 |
|---|---|
| 测试连接拒绝了该令牌 | 重新复制一次令牌,并确认它来自拥有该像素的组织 |
| 已拒绝或错误 | 查看该行详情中 Snapchat 的回复;cPixel 会自行重试错误 |
| 您的像素没有收到任何数据 | 检查 Pixel ID:可能丢失了连字符,或者填成了广告账户 ID |
| 首页上出现修复 Snapchat:令牌被拒绝或已删除,服务器端发送已停止,并已发送一封紧急提醒邮件 | 生成一个新令牌,点击修复 Snapchat,或在目的地中点击该账户旁边的管理,粘贴并保存 |
| 没有浏览器行提及 Snapchat | 应用嵌入已关闭(浏览器徽章显示需要应用嵌入):开启 cPixel 跟踪并保存主题,更换主题后需再次操作 |
| 购买事件丢失或显示已跳过 | 查看原因,然后参阅购买未显示 |
| 页面浏览或购买被重复计算 | 有其他工具(如 Snapchat Ads 应用或主题中的像素代码)正在向该像素发送数据 |
在管理 Snapchat中点击移除会停止向该账户发送数据并删除其令牌。
