API 模式的工作原理
在哪里添加脚本
<script>...</script> 标签中并保存。测试时,打开浏览器的开发者工具控制台(F12),查看是否有 console.log 消息。
关于旧版与新版回调的说明
以下所有示例均使用新版 API。使用旧风格的现有脚本仍将继续工作。
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 常见问题获取更多排查步骤。