文档

SDK 2.0 · 功能指南

尺寸感知贴合

启用支持的尺码建议,并将其与尺码和价格显示区分开来。

Shopify配置

尺寸感知合身开始并独立于虚拟试穿而工作。添加 SPREEAI 找到您的尺码 块靠近产品的尺寸选择器,保存主题并测试启用的产品。关闭尺码感知适配功能会隐藏该按钮并停止尺码建议。

Web SDK配置

enableSizingRecommendation 请求试穿中的尺码推荐流程。 showSizes 显示提供的可用尺寸; showPrices 显示提供的价格。所有三个都默认为 false。仅显示尺码标签并不能提供推荐。

TypeScript
import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";

const sdk = await init({ clientId: "YOUR_ISSUED_CLIENT_ID" });
if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{
      garmentId: "YOUR_READY_GARMENT_ID",
      availableSizes: ["XS", "S", "M", "L"],
      price: "$89.00",
    }],
    enableSizingRecommendation: true,
    showSizes: true,
    showPrices: true,
    defaultUnits: "metric",
  });
}

数据和行为

  • 提供当前库存尺寸标签并从您的店面显示价格。
  • 确认通过入职支持产品所需的合身性和尺码数据。
  • 使用 defaultUnits 在配置文件中选择公制或英制测量值。
  • 保留该品牌的尺码表。视觉预览或建议并不能保证身体适合。

独立尺寸

返回的v3.0.0 SDK暴露 renderTryOnButton()。它不公开可调用的 renderSizingButton(),即使与大小相关的类型仍保留在包中。使用支持的嵌入式流或 Shopify 块。

购物车验证

在Shopify上, 启用添加到购物袋 开始。启用后,验证当前产品是否按照试衣间中选择的尺寸添加。在自定义 Web 上,验证回调数据并将其映射到您自己的购物车的产品和型号 ID。

来源参考

搜索页面标题和内容。 Escape 关闭搜索。

选择您的语言。