跳转到内容

订单排查与归因

Orders 标签列出最近的购买,每一笔显示订单号、时间、金额,以及各平台的推送结果:

状态含义
Sent已推送成功
Test event配置了测试码,进入平台的测试工具
Retrying暂时失败,正在按退避策略重试
Failed平台拒绝,且不会重试
Not verified购买未通过验证,只入库不推送
No consent访客未同意营销用途
Not enough data匹配信息太少,不足以推送

Inspect 打开一笔订单,可以看到这次购买之前的所有事件、携带了哪些身份与同意信号,以及每一条投递的状态和平台返回的追踪 id。也可以直接搜索订单号或结账 token。

公开的 key 意味着任何人都能伪造一条“购买完成”。Hydrogen 店铺默认只推送验证通过的购买:店面服务器在真实购物车上向 Gosper 取得签名,写进购物车属性,结账像素把它带回来。常见原因:

原因说明
The cart was not registered by the storefront结账属性里没有签名。通常是 server.ts 没接好,或缺少 Storefront 环境变量
The cart proof did not match签名无效
Shopify did not confirm the cartGosper 读不到这个购物车
The currency differs from the cart’s币种与购物车不符
The amount is far above the cart’s total金额远超购物车金额
The cart was already purchased under another order同一个购物车已经对应过另一个订单

主题店无法登记购物车,所以默认关闭这项验证;也可以在 Settings 里手动开关(选项名为 Send only verified purchases)。

Health 标签显示每个平台最近 7 天的推送情况:成功、失败、未验证、无同意,以及最近一次成功和失败的时间、等待重试的批次数,和需要注意的告警。

失败会自动重试,间隔从 1 分钟逐步拉长到 1 天;平台返回的 4xx(除限流外)不重试。

Live events 显示最近 100 条事件:来自店面还是结账像素、事件类型、金额、给浏览器下发了哪些平台的像素调用、访客的同意状态。刚装好时用它确认事件确实到达。

Attribution 按渠道、来源和广告系列汇总订单与收入,可选最近 7/30/90 天、归因模型(末次点击、首次点击、线性)和回溯窗口。配置了 Meta 广告账户后,还会显示花费、归因收入和 ROAS。