> ## 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 API 常见问题

> 查找关于使用 Upcart API 的常见问题解答，包括设置、问题排查和第三方集成。

<div id="overview">
  # 概览
</div>

以下是关于使用 Upcart API 的一些最常见问题的解答。

* **[在哪里添加 Upcart API 脚本？](#where-to-add-upcart-api-scripts)**
* **[使用 Upcart 的 API 需要是开发者吗？](#do-i-need-to-be-a-developer-to-use-upcarts-api)**
* **[Upcart 的 API 可以与其他第三方应用集成吗？](#can-upcarts-api-integrate-with-other-third-party-apps)**
* **[如何测试我的 API 更改是否生效？](#how-do-i-test-if-my-api-changes-are-working)**
* **[如果 API 脚本不起作用该怎么办？](#what-should-i-do-if-an-api-script-isnt-working)**
* **[如果添加的脚本破坏了某些功能，如何撤销更改？](#how-do-i-undo-changes-if-i-add-a-script-that-breaks-something)**

***

<div id="where-to-add-upcart-api-scripts">
  ## **在哪里添加 Upcart API 脚本？**
</div>

你可以在 Upcart 的 Custom HTML 设置中添加脚本，或直接在 Shopify 主题代码中添加。最佳选择取决于你的自定义需求。

<div id="how-do-i-use-upcarts-custom-html">
  ## 如何使用 Upcart 的 Custom HTML？
</div>

1. 导航至 **Upcart → Settings → Custom HTML**
2. 使用 API 脚本修改购物车行为，例如打开时机或 upsell 展示
3. 调整 Upcart 之外的元素，例如隐藏产品页面按钮

<div id="example-hide-the-sticky-cart-button-when-the-cart-is-empty">
  #### 💡 *示例：购物车为空时隐藏悬浮购物车按钮*
</div>

```
<script>  
  window.upcartSubscribeCartLoaded((event) => {  
    const itemCount = event.cart.items.reduce((total, item) => total + item.quantity, 0);  
    document.querySelector("#upCartStickyButton").style.display = itemCount === 0 ? "none" : "block";  
    console.log("Sticky Cart is hiding!");  
  });  
</script>
```

<Note>
  **旧版说明：** `window.upcartOnCartLoaded` 回调仍然有效，但已被弃用并会在控制台记录警告。所有新脚本请使用 `upcartSubscribeCartLoaded`。请注意，`event.cart` 没有 `item_count` 属性——请使用 `event.cart.items.reduce((total, item) => total + item.quantity, 0)` 来计算商品总数。
</Note>

***

<div id="do-i-need-to-be-a-developer-to-use-upcarts-api">
  # **使用 Upcart 的 API 需要是开发者吗？**
</div>

不需要！即使没有编程技能，Upcart 的 API 也很容易使用。许多功能都是内置的，我们的[自定义文档](/zh/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)中包含可直接复制到 Upcart Custom HTML 设置中的预写脚本——无需编写代码！

如果你想编写自定义脚本，掌握基础的 JavaScript 知识会有帮助。如果你是 JavaScript 新手，别担心！这些适合初学者的资源——**W3Schools** 和 **[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)**——可以帮助你入门。

***

<div id="can-upcarts-api-integrate-with-other-third-party-apps">
  # Upcart 的 API 可以与其他第三方应用集成吗？
</div>

可以！Upcart 的 API 可与翻译、分析、upsell 等各类应用协同工作。有些应用会自动集成，有些则可能需要一小段脚本。

例如，如果你使用 **[TripleWhale](https://kb.triplewhale.com/en/articles/6610178-adding-the-triple-pixel-to-third-party-checkouts#h_eccf979512)** 进行跟踪，则需要添加以下脚本以确保它正确记录购物车活动：

```
<script>  
window.upcartSubscribeAddedToCart((event) => {  
	window.TriplePixel('AddToCart', {item: event.item.variantId, q: event.item.quantityAdded});  
});  
</script>
```

<Note>
  **旧版说明：** `window.upcartOnAddToCart` 回调仍然有效，但已被弃用并会在控制台记录警告。所有新脚本请使用 `upcartSubscribeAddedToCart`。请注意，事件属性位于 `event.item` 上（包含 `variantId` 和 `quantityAdded`），而不是作为单独的参数传递。
</Note>

由于每个应用各不相同，请咨询你所用应用的支持团队，确认是否需要额外代码。Upcart 不为第三方应用提供脚本支持，但你的应用提供商可能有集成指南。

***

<div id="how-do-i-test-if-my-api-changes-are-working">
  # 如何测试我的 API 更改是否生效？
</div>

在 Upcart 的 Custom HTML 设置中添加脚本后，请按照以下步骤确认它是否有效：

1. **刷新你的商店**并向购物车添加一件商品。

2. **清除缓存**并重试，以查看最新更改。

3. **添加测试消息**：在 `</script>` 之前插入 `console.log("The script works!");` 以检查脚本是否运行。

4. 检查浏览器控制台：

   * 打开 **Dev Tools**（Windows 上按 `F12` 或 `Ctrl + Shift + J`，Mac 上按 `Cmd + Option + J`）。
   * 前往 **Console 选项卡**并查找 **"The script works!"**
   * 如果看到该消息，说明你的脚本正在运行！如果没有，脚本可能未正确执行。

5. **测试不同的操作**（例如，移除一件商品）以确保行为符合预期。

**排查问题**时，请检查拼写错误或控制台错误，并根据需要调整代码。

***

<div id="what-should-i-do-if-an-api-script-isnt-working">
  # 如果 API 脚本不起作用该怎么办？
</div>

如果你的 API 脚本不起作用，请尝试以下排查步骤：

* **检查拼写错误**——即使是小错误也可能导致脚本失效。检查是否缺少字符或语法不正确。

* **确认脚本位置**——确保脚本位于 Upcart → Settings → Custom HTML 下的正确部分。Upcart 有十个脚本部分（九个 HTML 注入点加一个 Scripts-before-load 部分）——[在此查看这些部分。](/zh/upcart/custom_html)

* **检查浏览器控制台**——按照上面的步骤查找错误。

* **测试其他脚本**——尝试另一个预写的 Upcart API 脚本，以确定问题是否出在你的代码上。

* **仍然无法解决？**——如果你正在修改 Shopify 主题或集成第三方应用，[Shopify Partner Directory](https://www.shopify.com/partners/directory) 中的 Shopify 专家可以提供帮助。

这些步骤应能帮助你识别并解决大多数脚本问题！

***

<div id="how-do-i-undo-changes-if-i-add-a-script-that-breaks-something">
  # 如果添加的脚本破坏了某些功能，如何撤销更改？
</div>

如果你添加的脚本未按预期工作，可以**轻松移除或禁用它**：

* **前往添加脚本的 Upcart Custom HTML 设置**。

* **移除脚本**，或通过在每行开头添加 `//` 临时禁用它（这会将其变为注释，阻止其运行）。

* **保存更改并刷新商店**，检查问题是否已解决。

如果问题仍然存在，请尝试清除缓存或还原最近的主题更改——这通常能解决隐藏的冲突。

***

🚧 **需要高级自定义？**

需要全店范围的自定义或第三方应用集成？你可能需要开发者将 Upcart 的 API 添加到你的 Shopify 主题中。

可以考虑通过 **[Shopify Partner Directory](https://www.shopify.com/partners/directory)** 聘请 Shopify 专家，并将我们的 [API 文档](/zh/upcart/introduction_to_upcarts_public_api)分享给他们以获得协助