像素的工作原理
Converlay 使用 Shopify 的 Web Pixels API 来捕获店面事件。 Pixel 在由 Shopify 管理的沙盒 iframe 中运行,对性能的影响为零。
沙盒执行
Shopify 在隔离的沙箱中加载自定义像素。这意味着 Pixel 无法访问主页 DOM、Cookie,也无法干扰您的店面。它通过 Shopify 的事件总线接收事件。
可用的浏览器 API
| API | 可用 |
|---|---|
browser.localStorage | 是的 |
browser.cookie | 否 |
document.cookie | 否 |
window.localStorage | 否(使用 browser.localStorage) |
fetch / sendBeacon | 是的 |
捕获的数据
每个事件有效负载包括:
- Client ID — 存储在
browser.localStorage中的持久标识符 - Session ID — 30 分钟滚动窗口,也保留在 localStorage 中
- Click ID — 从页面 URL 中提取的
gclid、fbclid、ttclid - UTM 参数 —
utm_source、utm_medium、utm_campaign、utm_term、utm_content - Facebook 浏览器 ID —
_fbp从客户端 ID 生成,_fbc从 fbclid 生成 - 来自结账的 PII — 电子邮件、电话、姓名、地址(转发前使用 SHA-256 在服务端进行哈希处理)
- 同意状态 — 从 Shopify 的客户隐私 API 映射到 Google 同意模式 v2 信号
交通
使用 navigator.sendBeacon 将事件发送到 Converlay 收集端点,以确保页面卸载期间的可靠性。如果 sendBeacon 不可用,像素将回退到标准 fetch POST 请求。
坚持
客户端 ID 和会话 ID 存储在 browser.localStorage 中。如果 localStorage 不可用(例如,在某些注重隐私的浏览器中),像素将回退到内存存储中。在这种情况下,每次页面加载时都会重新生成 ID。
像素版本控制
每个像素部署都包含版本号和提交哈希。您可以在 Converlay 仪表板或浏览器控制台中通过搜索 [Converlay] 日志条目来检查正在运行的版本。
缓存
Shopify 积极缓存 Web 像素代码。部署新的 Pixel 版本后,商店必须在 设置 → 客户事件 中断开并重新连接 Pixel,代码更改才能生效。设置更改可以通过批量更新程序远程推送。