用途:解决浏览器像素信号丢失问题,通过 Meta Pixel 与 Conversions API(CAPI)并行发送服务端事件,共享 event_id 去重,并传哈希用户数据以提升事件匹配质量(EMQ)。
主要能力:
- 审计现有像素:scripts/pixel-audit.sh <account_id_or_pixel_id>,输出逐项通过/警告/失败记分卡、按事件类型估算 EMQ、优先级修复清单。
- 按平台生成安装说明:scripts/pixel-setup.sh <platform> <pixel_id>,支持 nextjs、shopify、wordpress、webflow、ghl、clickfunnels、custom。
- 测试 CAPI:scripts/capi-test.sh <pixel_id> [test_event_code],发送测试 PageView 与 Purchase。
- EMQ 检查优化:scripts/emq-check.sh <pixel_id>,按影响排序给出建议。目标值:Purchase 9.3+ 优秀、8.0-9.2 良好、6.0-7.9 待改进、<6.0 严重;Lead 8.0+ 优秀、6.5-7.9 良好、5.0-6.4 待改进、<5.0 严重。
- 手动发送服务端事件:scripts/capi-send.sh <pixel_id> <event_name> [options],支持 email、phone、value、currency、url、event-id、ip、ua、fbp、fbc 等参数,PII 自动 SHA-256 哈希。
使用方式:先读 references/pixel-capi-reference.md;检查 workspace/brand/stack.md 中已存的 pixel/account ID。设置 META_TOKEN,需 ads_management 与 ads_read 权限,建议用 Business Manager System User 生成。可用 curl 调 Graph API 列出像素。
限制与注意:EMQ 分数为基于匹配字段的估算,实际值需在 Events Manager 验证;脚本自动哈希 PII,手动实现需 lowercase、trim 后 sha256;IP 与 UA 不哈希,fbp/fbc 不哈希;像素与 CAPI 必须使用同一 event_id 否则重复计数;token 仅存 .env,切勿提交。