转化 API 的作用
转化 API（CAPI）从 Storeep 的服务器把转化事件直接发送到广告平台，绕过买家的浏览器。因为它是服务器到服务器运行的，所以不受广告拦截器、浏览器隐私设置或 iOS 追踪限制的影响，并且它携带经过哈希处理的客户详情，以提升智能出价和相似受众的匹配质量。关于客户端像素，请参阅配套文章浏览器像素。
你可以同时为同一个平台运行浏览器像素和 CAPI。Storeep 用一个由事件类型和订单号构成的共享事件 ID 给两者打上戳记，所以平台会把它们去重合并为一次转化，而不是计为两次。
哪些平台提供 CAPI
- Facebook / Meta 转化 API。
- TikTok 事件 API。
- Snapchat 转化 API。
X 和 Google Ads 在 Storeep 中没有服务器端转化 API；它们仅为浏览器端。
发送的内容
在每个符合条件的订单上，Storeep 发送订单价值和货币、商品行项目，以及买家的信号：哈希后的邮箱、哈希后的电话、哈希后的客户 ID（external_id）、IP 地址、用户代理，以及（对于 Facebook 和 Snapchat）哈希后的市场国家。它还会转发在买家 Cookie 中找到的任何广告点击 ID（Facebook 的 _fbc 和 _fbp、TikTok 的 ttclid、Snapchat 的 ScCid），以便平台把转化归因到最初的点击。
转化事件类型
- Facebook：仅 Lead 或 Purchase。Facebook CAPI 不发送加入购物车或结账事件。
- TikTok：Lead、Purchase、Place an order 或 Complete payment。
- Snapchat：Purchase 或 Reserve。
货币和零价值订单
当平台支持时，每个事件使用订单自己的货币；否则价值会换算为 USD。Facebook CAPI 会跳过任何合计为 0 的订单，因为 Meta 拒绝没有价值的转化，这与 Facebook 浏览器像素保持一致。
被放弃订单的门控
这是需要理解的关键行为。一个全新的订单总是会触发 CAPI 发送。被放弃的订单则不同：它只在你为该 CAPI 条目打开被放弃的订单开关时才发送，而且只在订单状态从已放弃变为任何其他状态的那一刻发送。
- 当被放弃的订单关闭时，已恢复的被放弃订单绝不会被转发到平台。
- 当它开启时，当订单移出已放弃状态时事件就会触发，无论你是手动更改状态还是 Automator 应用自动更改。
- 如果未安装 Automator，你必须自己把订单移到另一个状态，事件才会触发。
- 该开关是按条目的，所以你可以为一个 Pixel ID 启用被放弃订单追踪，而为另一个保持关闭。
安装 CAPI 及其字段
- 在左侧菜单中打开应用。
- 找到你想要的转化 API 应用并点击安装，然后确认。
- 再次打开应用并点击添加新像素以创建一个条目。
每个条目都有这些字段：
- 激活：开启时，转化事件以服务器到服务器方式发送。默认开启。
- 被放弃的订单：上面描述的门控开关。默认关闭。
- 广告账户名称：仅供你自己参考的标签。
- Pixel ID：你的 Meta、TikTok 或 Snapchat 的 Pixel ID。
- 市场：此条目覆盖的店铺市场。选择一个或多个。
- 转化事件类型：上面列出的平台选项。
- 访问令牌：你在平台的事件管理工具中生成的转化 API 访问令牌。必填。
- 激活测试模式：开启时，事件作为测试事件发送。
- 测试代码：来自平台的测试事件代码，例如 TEST_1234。测试模式开启时必填。
测试模式
测试模式开启时，事件出现在平台的测试事件视图中，让你无需触碰真实数据即可确认集成。测试事件不会喂给广告出价或优化，所以在你投放线上广告系列之前请禁用测试模式。
市场如何为 CAPI 限定范围
一个 CAPI 条目只为在你为它选定的市场中所下的订单触发。在你未选取的市场中的订单不会触发该条目，所以你可以从同一个店铺为每个国家运行不同的 Pixel ID 和访问令牌。
需要检查的事项
- 在你的浏览器像素和你的 CAPI 上使用相同的 Pixel ID，以便平台把这两次投递去重合并为一次转化。
- 如果事件不再出现在平台的事件管理工具中，你的访问令牌可能已过期。重新生成它并更新条目。
- 每个条目都是独立的。你可以为每个平台添加多个条目，每个都有自己的 Pixel ID、访问令牌、市场、事件类型和被放弃订单设置。
- 记得在上线前禁用测试模式，否则你的真实转化将不会被计入。