Skip to main content

​
概览

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

​
在哪里添加 Upcart API 脚本？

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

​
如何使用 Upcart 的 Custom HTML？

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

​
💡 示例：购物车为空时隐藏悬浮购物车按钮

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

​
使用 Upcart 的 API 需要是开发者吗？

不需要！即使没有编程技能，Upcart 的 API 也很容易使用。许多功能都是内置的，我们的自定义文档中包含可直接复制到 Upcart Custom HTML 设置中的预写脚本——无需编写代码！ 如果你想编写自定义脚本，掌握基础的 JavaScript 知识会有帮助。如果你是 JavaScript 新手，别担心！这些适合初学者的资源——W3Schools 和 MDN Web Docs——可以帮助你入门。

​
Upcart 的 API 可以与其他第三方应用集成吗？

可以！Upcart 的 API 可与翻译、分析、upsell 等各类应用协同工作。有些应用会自动集成，有些则可能需要一小段脚本。 例如，如果你使用 TripleWhale 进行跟踪，则需要添加以下脚本以确保它正确记录购物车活动：
旧版说明： window.upcartOnAddToCart 回调仍然有效，但已被弃用并会在控制台记录警告。所有新脚本请使用 upcartSubscribeAddedToCart。请注意，事件属性位于 event.item 上（包含 variantId 和 quantityAdded），而不是作为单独的参数传递。
由于每个应用各不相同，请咨询你所用应用的支持团队，确认是否需要额外代码。Upcart 不为第三方应用提供脚本支持，但你的应用提供商可能有集成指南。

​
如何测试我的 API 更改是否生效？

在 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. 测试不同的操作（例如，移除一件商品）以确保行为符合预期。
排查问题时，请检查拼写错误或控制台错误，并根据需要调整代码。

​
如果 API 脚本不起作用该怎么办？

如果你的 API 脚本不起作用，请尝试以下排查步骤：
  • 检查拼写错误——即使是小错误也可能导致脚本失效。检查是否缺少字符或语法不正确。
  • 确认脚本位置——确保脚本位于 Upcart → Settings → Custom HTML 下的正确部分。Upcart 有十个脚本部分（九个 HTML 注入点加一个 Scripts-before-load 部分）——在此查看这些部分。
  • 检查浏览器控制台——按照上面的步骤查找错误。
  • 测试其他脚本——尝试另一个预写的 Upcart API 脚本，以确定问题是否出在你的代码上。
  • 仍然无法解决？——如果你正在修改 Shopify 主题或集成第三方应用，Shopify Partner Directory 中的 Shopify 专家可以提供帮助。
这些步骤应能帮助你识别并解决大多数脚本问题！

​
如果添加的脚本破坏了某些功能，如何撤销更改？

如果你添加的脚本未按预期工作，可以轻松移除或禁用它：
  • 前往添加脚本的 Upcart Custom HTML 设置。
  • 移除脚本，或通过在每行开头添加 // 临时禁用它（这会将其变为注释，阻止其运行）。
  • 保存更改并刷新商店，检查问题是否已解决。
如果问题仍然存在，请尝试清除缓存或还原最近的主题更改——这通常能解决隐藏的冲突。
🚧 需要高级自定义？ 需要全店范围的自定义或第三方应用集成？你可能需要开发者将 Upcart 的 API 添加到你的 Shopify 主题中。 可以考虑通过 Shopify Partner Directory 聘请 Shopify 专家，并将我们的 API 文档分享给他们以获得协助