更新时间:2026年8月10日
这一篇介绍在服务端sGTM完成Facebook转化API(Conversions API)的部署。
前置条件:本方案假设你已搭建好服务端sGTM环境,请看:用Stape实现Google Tag Manager服务端布署
Step 1:在Facebook里创建资料来源
首先,在Facebook事件管理工具中创建一个新的数据源,以获取后续配置所需的核心凭证:
- Pixcel ID:2017375668743628
- API Access Token:EAAUdU0ztf38BO2DGljx38AZB8tILAZBvSyrWt58eKfN3uR9x0wGtgKMym9vElEZARJhY9O9tmZB03ZB1bk6D6ZCSohmdAE3ww4ztM7f0MHBaBITLTODsQWas9dpnmtx8fbl8itx01xRiZBIXW2nFZBUrgtfX0cxTqEl4VCLs3cmKDf7gFfYqkjCW7iPuc32QJSYGUgZDZD
Step 2:在sGTM里安装Facebook Pixel代码模板
在sGTM中点击「代码」——「新建」——「选择一个变量类型以开始设置…」——「在社区模板库中发现更多代码类型 」,在搜索框中输入 Facebook,找到对应的 Conversions API 社区模板并安装。
将其安装后,命名为“Facebook-Page View”, 并填入 Step 1 中获取的 Pixel ID 与 Access Token:
Step 3:在网站GTM中配置数据转发参数
为了实现浏览器端到服务端的数据传递,您需要在网站 GTM(Web Container) 中,对需要发送给 Facebook 的触发器或代码进行额外配置:
设置解析:
- first_party_collection:启用第一方数据收集,允许数据从浏览器端直接透传至服务端容器,例如用户提供的邮箱、电话等信息可通过此设置自动传递。
- 传递必填参数:Facebook 服务端跟踪要求必须传递 event_name(事件名称)和 event_time(事件时间戳)。
- 传递推荐参数(用于广告归因与去重):
- x-fb-ck-fbp:浏览器Cookie中的_fbp参数
- x-fb-ck-fbc:浏览器Cookie中的_fbc参数,用于点击归因
- event_id:事件唯一标识符,用于后续去重
Step 4:在sGTM中预览测试
正式上线前,强烈建议通过 Facebook 的测试工具验证配置是否正确。
在 Facebook 数据源的“测试事件”面板中,点击“图形 API 测试工具”进入测试接收状态
将获取到的测试编号,填入 sGTM 中“Facebook-Page View”代码的 Test ID 字段(测试结束,这个ID需要移除):
保存后就可以点击「预览」,然后打开网站,再返回到测试页面,在「摘要」这边找到page_view,确认“Facebook-Page View”代码已触发:
可以看到Facebook-Page View是触发,点击打开:
Facebook的转化API的节点是graph.facebook.com。
可以看到服务端发给FB的请求,点击打开可以看到具体发送的数据:
请求正文就是具体发送的数据,做测试的时候主要就是看请求正文是否有设置的字段,字段的值是否准确。
同时可以在Facebook的资料来源的测试事件里实时看到接收到的数据:
常见问题
数据接收延迟
如果在浏览器端同时安装了传统的 Facebook 像素(Browser Pixel)和服务端跟踪,测试期间您可能会发现服务端的数据在 Facebook 测试面板中出现较慢。这是因为服务端数据需要经过中间服务器转发,存在一定的网络延迟,属于正常现象。正式环境中建议以服务端数据为主要归因依据。
数据去重策略
若同时启用浏览器像素(Client-side Pixel)和服务端转化 API,必须配置 event_id 进行去重。Facebook 基于 event_name 与 event_id 的组合进行去重判定:
若浏览器端与服务端发送的 event_name 和 event_id 完全相同,Facebook 会判定为重复事件,通常会删除后到达的请求(实践中,部分情况下系统会保留较先到达的请求)。
调试时邮箱参数显示为 “redacted”(已隐去)
这是因为邮箱(Email)属于个人身份信息(PII)。为了保障用户隐私和符合合规要求,Facebook 在测试面板中会自动隐去此类明文字段。
请勿直接传递明文邮箱,而应在服务器端将邮箱地址转化为 SHA-256 哈希值(Hash) 后再进行传递。这样既能通过验证,又符合数据安全规范。









