Skip to main content

API 模式的工作原理

大多数 Upcart API 脚本都遵循同一个简单模式: 监听购物车事件 → 检查条件 → 执行操作 例如:“当购物车加载时 → 检查购物车是否为空 → 隐藏悬浮按钮。” 💡 **刚接触 API?**在深入下面的示例之前,请先阅读什么是 API?

在哪里添加脚本

以下所有脚本均添加到: Cart Editor → Settings → Custom HTML → Scripts (before load) 将每个代码片段包裹在 <script>...</script> 标签中并保存。测试时,打开浏览器的开发者工具控制台(F12),查看是否有 console.log 消息。

关于旧版与新版回调的说明

Upcart 有两种监听购物车事件的方式: 以下所有示例均使用新版 API。使用旧风格的现有脚本仍将继续工作。

示例 1:购物车为空时隐藏悬浮购物车按钮

工作原理:upcartSubscribeCartLoaded 在每次购物车加载时触发。回调会收到一个 event,其中的 cart 对象包含一个 items 数组。我们将每个商品的 quantity 相加来判断购物车是否为空。 ⚠️ 重要提示:event.cart 没有 item_count 属性。你必须通过遍历 event.cart.items 来计算总数。

示例 2:记录商品被添加到购物车的日志

event.item 上可用的属性:

示例 3:与第三方分析应用集成(例如 TripleWhale)

**注意:**每个第三方应用都不相同。请向该应用的支持团队确认正确的事件格式。

示例 4:添加商品后自动打开购物车

**注意:**如果已在 Cart Editor → Settings → Cart settings 中启用了 “Open cart drawer on add to cart”,则不需要此脚本。

快速参考:订阅函数(新版 API)


直接操作函数

完整的 API 文档请参阅 Upcart Public API 文档

故障排查

  • **脚本没有运行?**请仔细检查放置位置:应该放在 Scripts (before load) 中,而不是 after load。
  • **找不到元素?**请确保选择器(例如 #upCartStickyButton)与购物车中实际的元素 ID 匹配。
  • **出问题了?**在每行开头添加 // 将脚本注释掉,保存后刷新。
  • **仍然卡住?**请参阅 API 常见问题获取更多排查步骤。