Skip to main content
本文介绍如何排查应用与 Upcart 的兼容性问题，并提供实现最佳性能的最佳实践。

​
概述

Upcart 旨在与大多数 Shopify 应用顺畅集成。但是，某些第三方应用可能会导致功能问题，具体取决于它们如何修改 Shopify 的购物车、checkout、定价或货币逻辑。
​ Upcart 以 cart drawer 叠加层的形式运行，在不完全替换 Shopify 原生购物车或 checkout 的情况下增强购物车体验。
​ 覆盖 Shopify 购物车行为、拦截 Add to Cart 操作或替换 Shopify 原生定价或货币系统的应用可能会与 Upcart 冲突。 我们建议尽可能使用 Shopify 的原生功能（例如使用 Shopify Markets 进行货币转换）。对于会大幅改变 Shopify 默认购物车结构的第三方应用，我们团队的支持范围有限。 即使某个应用在 Shopify App Store 中上架，它仍可能被归类为第三方应用，与 Upcart 一起使用时可能存在某些限制。

​
不兼容的应用

以下应用已被发现会持续导致 Upcart 出现问题，因此不受支持： BUCKS（货币转换应用）
Upcart 与第三方货币转换应用不兼容。Upcart 通过 Shopify Markets 使用 Shopify 的原生货币转换。像 BUCKS 这样的货币转换应用只是在店面上以视觉方式更改价格，并不会修改实际的购物车货币。因此，它们不会影响 Upcart 内的货币显示，并可能导致不一致。 如果你需要多货币功能，我们建议使用 Shopify Markets。 CloudFox Checkout
第三方 checkout 替换应用与 Upcart 不兼容。 CartPanda
不支持第三方 checkout 系统。

​
可能导致问题的应用

据报告，以下应用可能与 Upcart 产生冲突，或无法完全按预期与 Upcart 配合工作：
  • qikify Quick View Popups
  • Vitals
  • Bundle Bear
虽然这些应用在某些情况下可以正常工作，但 Upcart 的某些元素或功能可能无法按预期显示或运行。 如果你在使用这些应用时遇到问题，我们建议启用下文所述的兼容性设置。
​ 开发者也可以利用 Upcart Public API 来寻求解决方案。

​
Enhanced AJAX API Compatibility

如果你遇到与其他应用的冲突，我们建议启用： Enhanced AJAX API Compatibility 启用此设置的方法： 前往 Upcart → Cart editor → Settings → Cart settings → Advanced Settings → Enhanced Ajax API compatibility。Upcart 管理后台没有顶层的 Settings 入口——该设置位于购物车编辑器内，藏在折叠的 Advanced Settings 展开项之下。 此设置会让 Upcart 停止拦截 Add to Cart 调用。 它还有一个从名称上看不出来的第二个作用：它会让 Upcart 将对 Shopify Ajax 购物车 API 的调用（/cart/add、/cart/add.js、/cart/update.js、/cart/change.js）加入队列，逐一执行，防止来自不同脚本的同时更新相互覆盖。由于该队列机制会修补页面上所有购物车网络请求，请仅在需要时开启此设置，并在开启后测试店面。 这样一来，其他应用（例如捆绑销售应用、页面构建器、自定义应用和商品选项应用）就可以不受干扰地运行。

​
重要提示：

此设置确实存在一定的权衡。 由于 Upcart 不再拦截 Add to Cart 调用，它无法阻止其他应用将客户重定向到原生购物车页面。 如果启用此设置后客户被重定向离开 cart drawer：
  1. 检查冲突应用的设置。
  2. 查找类似以下的选项：
    • Disable redirect to cart
    • Stay on page after add to cart
    • Enable AJAX add to cart
  3. 调整这些设置以防止强制跳转到购物车页面。
强烈建议在启用此设置后进行测试。 上面列出的应用只是已表现出与 Upcart 兼容性问题的示例。可能还有尚未识别的其他应用。随着新案例的报告，此列表将持续更新。

​
如果 Upcart 无法打开或发生重定向

如果 Upcart 无法正常打开，或被重定向到购物车页面，请参阅我们的故障排查指南： 排查 Upcart 无法打开或重定向到购物车页面的问题 该指南将逐步讲解常见原因和解决方案，包括：
  • 与主题或自定义代码的冲突
  • AJAX 购物车设置的问题
  • 应用兼容性检查
  • 浏览器和缓存排查步骤
如果按照指南操作后问题仍然存在，请联系支持团队，并提供你的商店 URL 和问题的简要描述。

​
测试建议

在正式上线任何更改之前，我们建议在主题的副本上测试 Upcart。 操作方法：
  • 在 Shopify 管理后台，前往 Online Store > Themes
  • 点击当前主题旁边的 Actions，然后选择 Duplicate
  • 打开副本主题并点击 Preview
  • 测试购物车交互、捆绑销售、折扣、货币显示和 upsell
  • 确认无误后，发布更新后的主题
提前测试有助于在问题影响客户之前防止显示或性能问题。