ConverlayConverlay

像素的工作原理

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,代码更改才能生效。设置更改可以通过批量更新程序远程推送。