将组合添加到购物车的工作原理

当顾客选择一项优惠并点击产品页面上的 加入购物车按钮时，Bundlex 会添加所选产品、数量和符合条件的附加项。通常会将它们一起添加，结账时会检查生成的购物车并计算折扣。

顾客应看到的内容

对于包含一瓶面霜和一瓶精华液的组合，Bundlex 数量为 2表示两套完整组合，即两瓶面霜和两瓶精华液。在此演示中，一套 Daily Glow Duo 的价格为 $54，两套在运费前的价格为 $108。

点击“加入购物车”后，检查每种产品及其数量。此购物车包含两瓶面霜，价格为 $50.40，以及两瓶精华液，价格为 $57.60，总计 $108。两行商品都显示 Daily Glow Duo 折扣。你的主题可能会显示购物车抽屉、购物车页面或其他确认方式；购物车内容和结账小计才是需要关注的结果。

继续结账，在下单前确认相同的产品和折扣。运费、税费和其他符合条件的折扣可能会影响最终总额。如果缺少附加项，不要因为显示加购成功消息，就认为完整组合已成功添加。

Bundlex 如何识别产品表单

小组件会向产品表单添加隐藏的 bx-product-form 标记，并监控发送到 Shopify /cart/add 端点的请求。该标记是识别组合提交的常用方式。

某些主题会重新构建请求并丢弃隐藏字段。当请求的变体和当前选择仍然匹配时，Bundlex 还可以针对已标记表单最近发生的加购操作执行有限的恢复流程。缺少标记是一个有用的诊断线索，但这本身并不意味着组合无法添加。

此恢复流程不适用于所有自定义请求。在仅附加项模式下，如果主题或应用脚本在顾客点击后立即只添加主产品，Bundlex 可以在该加购完成后添加已勾选的附加项。某些设置仍可能导致附加项丢失；如果已勾选的附加项缺失，请将产品页面链接提供给支持团队，我们会进行检查。如果可见优惠添加了错误的商品，请参阅 加购故障排除。

添加所选产品

Bundlex 会读取顾客所选的变体、数量和可选附加项，然后构建组合载荷。这些商品会一起添加，而不是通过顾客分别点击多次来添加。

如果 Shopify 拒绝嵌套加购，Bundlex 可以在不带父级关系的情况下重试。如果附加项仍然不可用，恢复流程可以在保留主产品折扣信息的情况下重试添加主产品。加购被拒绝并不总是会导致添加一件原价产品；最终结果取决于哪次重试成功，以及购物车是否仍符合条件。

结账如何识别优惠

购物车商品行会携带一个私有的 _bundlex 属性，用于标识折扣、优惠和任何附加项。这样可以区分数量相同的优惠，确保单独配置的附加项可被识别，并将带有标记的商品行与其他 Bundlex 折扣隔离开来。

结账会根据实际购物车内容检查数量、必需商品和适用资格。该标签还支持收入归因。Shopify 会在结账时隐藏私有商品行属性，主题和自定义模板代码必须在其他位置对其进行筛选。请参阅 Bundlex 订单代码。

自定义属性和订阅

该集成支持处理常见的 JSON、FormData 和 URL 编码的加购请求。文本属性，例如刻字内容，会复制到第一个主商品行，不会自动复制到每个组合组件。支持的销售计划值会根据每个商品适用的计划单独处理。

文件上传需要进行兼容性检查。常规组合请求重建不会将上传的 File 值保留为上传文件，因此不要仅因为文件上传或个性化应用的文本字段可以正常工作，就假设该应用也能正常运行。请测试完整流程，并通过商品 URL 联系支持团队。

自定义购买按钮和立即购买

单独的购买或货到付款应用可能会绕过标准商品表单和 Shopify 购物车请求。Bundlex 无法保证必需的组合商品、赠品或追加销售优惠会通过该路径传递。请保留主题中的加购按钮，并使用完整优惠测试替代按钮。

立即购买与加购也是不同的路径。不要因为普通购物车运行正常，就假设它会携带每个组合组件。如果希望标准加购操作直接跳转到结账，请使用 跳过购物车直接结账，并验证生成的结账页面。

哪一个数量会进入购物车

• Bundlex 数量选择器已启用：小组件的步进控件会控制数量，主题输入框会反映其结果。
• 常见的阶梯导航设置：准确的原生数量可以选择匹配的阶梯。介于两个阶梯之间的数量可能会保留上一个优惠，因此系统可能会添加优惠中配置的数量。
• 支持团队启用的普通阶梯原生数量：部分商店使用单独的设置，以保留顾客手动输入的数量。

启用可选选择且未选择优惠时，主题控件会正常工作，不会添加优惠赠品或额外商品。如果购物车符合条件，普通数量折扣仍可在结账时应用。取消选择某个优惠并不等于选择退出所有折扣。

请参阅 主题数量行为和 Bundlex 的数量选择器，以选择所需的设置。