升级后 Analytics.Provider 报错怎么替换

现象#

升到 2026-10 后页面白屏，控制台报 Attempted import error: 'Analytics' is not exported from '@shopify/hydrogen'；删掉 import 又提示 useAnalytics is not a function。

原因#

• 2026-10 移除了 Analytics.Provider、ProductView 与 useAnalytics
• 新方案是 ShopifyScripts 加 window.Shopify.analytics 事件总线，事件名已变
• getShopAnalytics() 一并移除，服务端不再注入店铺维度的元数据
• 第三方像素改为通过 addDestination 注册，仍要等 consent 之后才发送

处理步骤#

1. 全局搜索 Analytics.Provider、useAnalytics 并逐个删除
2. 根布局挂 <ShopifyScripts />，从 @shopify/hydrogen/react 导入
3. 商品浏览改用 window.Shopify.analytics 事件总线发送，事件名按新版文档取
4. 购物车相关事件交给 useCartAnalytics()，不要自己拼行项目字段
5. 第三方目的地用 addDestination() 注册，在同意回调里再初始化

验收标准#

Console 不再有 import 报错，Network 里能看到发往 Shopify 的分析请求，后台报表出现浏览与加购事件。