> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 应用与 Upcart 的兼容性

> 说明哪些第三方应用会与 Upcart 冲突、Enhanced AJAX API Compatibility 设置，以及如何在复制的主题上测试更改。

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

<div id="overview">
  ## **概述**
</div>

Upcart 旨在与大多数 Shopify 应用顺畅集成。但是，某些第三方应用可能会导致功能问题，具体取决于它们如何修改 Shopify 的购物车、checkout、定价或货币逻辑。\
​

Upcart 以 cart drawer 叠加层的形式运行，在不完全替换 Shopify 原生购物车或 checkout 的情况下增强购物车体验。\
​

覆盖 Shopify 购物车行为、拦截 Add to Cart 操作或替换 Shopify 原生定价或货币系统的应用可能会与 Upcart 冲突。

我们建议尽可能使用 Shopify 的原生功能（例如使用 Shopify Markets 进行货币转换）。**对于会大幅改变 Shopify 默认购物车结构的第三方应用，我们团队的支持范围有限。**

即使某个应用在 Shopify App Store 中上架，它仍可能被归类为第三方应用，与 Upcart 一起使用时可能存在某些限制。

<div id="incompatible-apps">
  ## **不兼容的应用**
</div>

以下应用已被发现会持续导致 Upcart 出现问题，因此不受支持：

**BUCKS（货币转换应用）**\
Upcart 与第三方货币转换应用不兼容。Upcart 通过 Shopify Markets 使用 Shopify 的原生货币转换。像 BUCKS 这样的货币转换应用只是在店面上以视觉方式更改价格，并不会修改实际的购物车货币。因此，它们不会影响 Upcart 内的货币显示，并可能导致不一致。

如果你需要多货币功能，我们建议使用 **Shopify Markets**。

**CloudFox Checkout**\
第三方 checkout 替换应用与 Upcart 不兼容。

**CartPanda**\
不支持第三方 checkout 系统。

***

<div id="apps-that-may-cause-issues">
  ## **可能导致问题的应用**
</div>

据报告，以下应用可能与 Upcart 产生冲突，或无法完全按预期与 Upcart 配合工作：

* **qikify Quick View Popups**
* **Vitals**
* **Bundle Bear**

虽然这些应用在某些情况下可以正常工作，但 Upcart 的某些元素或功能可能无法按预期显示或运行。

如果你在使用这些应用时遇到问题，我们建议启用下文所述的兼容性设置。\
​

开发者也可以利用 [<u>Upcart Public AP</u>](https://rokt.notion.site/upcart-public-api)I 来寻求解决方案。

***

<div id="enhanced-ajax-api-compatibility">
  ## **Enhanced AJAX API Compatibility**
</div>

如果你遇到与其他应用的冲突，我们建议启用：

**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`）加入队列，逐一执行，防止来自不同脚本的同时更新相互覆盖。由于该队列机制会修补页面上所有购物车网络请求，请仅在需要时开启此设置，并在开启后测试店面。

这样一来，其他应用（例如捆绑销售应用、页面构建器、自定义应用和商品选项应用）就可以不受干扰地运行。

<div id="important">
  ### **重要提示：**
</div>

此设置确实存在一定的权衡。

由于 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 兼容性问题的示例。可能还有尚未识别的其他应用。随着新案例的报告，此列表将持续更新。

<div id="if-upcart-is-not-opening-or-is-redirecting">
  ### 如果 Upcart 无法打开或发生重定向
</div>

如果 Upcart 无法正常打开，或被重定向到购物车页面，请参阅我们的故障排查指南：

[排查 Upcart 无法打开或重定向到购物车页面的问题](/zh/upcart/troubleshooting_upcart_not_opening_or_redirecting)

该指南将逐步讲解常见原因和解决方案，包括：

* 与主题或自定义代码的冲突
* AJAX 购物车设置的问题
* 应用兼容性检查
* 浏览器和缓存排查步骤

如果按照指南操作后问题仍然存在，请联系支持团队，并提供你的商店 URL 和问题的简要描述。

***

<div id="testing-recommendation">
  ## **测试建议**
</div>

在正式上线任何更改之前，我们建议在主题的副本上测试 Upcart。

操作方法：

* 在 Shopify 管理后台，前往 **Online Store > Themes**
* 点击当前主题旁边的 **Actions**，然后选择 **Duplicate**
* 打开副本主题并点击 **Preview**
* 测试购物车交互、捆绑销售、折扣、货币显示和 upsell
* 确认无误后，发布更新后的主题

提前测试有助于在问题影响客户之前防止显示或性能问题。