Shopify 知识库 · 概念
App Pixel、Custom Pixel 与 GTM 的边界
Shopify App Pixel 与 Custom Pixel 的沙箱差异，GTM 能否放进 Pixel，以及如何按同意状态验证事件链，避免混淆运行位置。
讨论“GTM 能不能放进 Pixel”时，必须先说明是哪一种 Pixel。它们的沙箱不同，普通页面脚本的行为不能直接套用。
两类 Pixel
| 类型 | 环境 | 对实现的影响 |
|---|---|---|
| App Pixel（Web Pixel App Extension） | strict 沙箱，运行在 Web Worker 中 | 不能依赖传统的页面 DOM 读写脚本 |
| Custom Pixel | lax 沙箱，即带 sandbox 属性（允许脚本和表单）的 iframe | 不能等同于顶层页面环境，需要按沙箱限制配置 |
这些边界来自Web Pixels 文档。因此“GTM 脚本不能放进 Web Pixel”这类笼统说法并不准确，需要按 Pixel 类型分别讨论。
Shopify 提供使用 GTM 创建 Custom Pixel 的教程，建议用 Shopify Pixel Helper 检查事件是否无误地进入沙箱，并说明 Google Tag Assistant 的 Troubleshoot tag 功能与 Custom Pixel 不兼容。能加载容器不代表所有标签都能正确运行，更不代表页面 URL、事件和金额已映射正确。GTM Custom Pixel。
验证一条事件链
先列出要验证的动作，再检查 Shopify 事件、转换后的载荷、采集端接收与最终分析结果。记录事件名称、时间、标识、币种和金额等实际需要的字段，并说明字段来源。
例如完成一次测试购买后，分别检查是否产生预期事件、是否到达采集端、是否重复以及金额是否与业务口径一致。仅观察到网络请求成功，不能证明最终统计正确。
同意状态与调试
同意状态属于测试条件。分别观察相关状态下的行为，不把没有触发直接解释为代码故障。Tag Assistant 检测不到 Custom Pixel 内由 GTM 加载的标签，不能据此判断未安装；也不要把顶层页面的调试结果当作 iframe 内所有标签的结果。
部署方式比较见浏览器、服务端与标签网关。主题组件的安装与事件采集是不同任务，分别验收。