Danh mục & biến thể | SDK 2.0

Sử dụng đúng định danh

ID sản phẩm mặt tiền cửa hàng, SKU hoặc ID biến thể không tự động là ID hàng may mặc SPREEAI. Duy trì ánh xạ được tạo thông qua quá trình nhập hoặc quy trình đồng bộ hóa Shopify của bạn. Trang phục phải thuộc về đối tác đã được xác thực và có sẵn để mặc thử.

Lập bản đồ lựa chọn sản phẩm

TypeScript

import type { RenderTryOnButtonOptions } from "@spreeai/web-sdk";

export const productOptions: RenderTryOnButtonOptions = {
  elementId: "spreeai-try-on",
  garments: [{
    garmentId: "SPREEAI_GARMENT_ID",
    variant: { color: "blue", fit: "regular" },
    availableSizes: ["S", "M", "L"],
    price: "$59.00",
  }],
  showSizes: true,
  showPrices: true,
};

variant có thể lọc màu sắc, độ vừa vặn, giới tính và phong cách. Đối sánh tài liệu không phân biệt chữ hoa chữ thường. Ghép màu theo tên của nó, chẳng hạn như blue, thay vì theo giá trị hex.

Sự sẵn sàng của hàng may mặc

Trạng thái hoặc điều kiện	Hành động tích hợp
Chưa được đồng bộ hóa/quá trình nhập chưa hoàn tất	Giữ trải nghiệm sản phẩm bình thường; không hứa hẹn có sẵn dùng thử.
Sẵn sàng nhưng bị vô hiệu hóa trong Shopify	Xem xét và kích hoạt rõ ràng sản phẩm dự định. Sẵn sàng một mình không làm cho nó tồn tại.
Có sẵn hàng may mặc và biến thể phù hợp	Hiển thị nút cho lựa chọn đó.
Không có trang phục phù hợp	Dự kiến sẽ có dự phòng cho sản phẩm may mặc đầu tiên trong mảng.
Xác thực không thành công	Không có nút nào được hiển thị; điều tra bảng điều khiển và ánh xạ sản phẩm.

Luôn cập nhật dữ liệu sản phẩm

Cập nhật giá hiển thị và kích thước trong kho khi lựa chọn sản phẩm thay đổi.
Sử dụng ID vùng chứa duy nhất cho các nút sản phẩm riêng biệt.
Khi hiển thị lại một nút, hãy chuyển lựa chọn hàng may mặc và biến thể hiện tại.
Xem lại dữ liệu giỏ hàng được trả lại so với danh mục của riêng bạn trước khi tạo đột biến giỏ hàng.

Chuẩn bị tài sản may mặc

Sử dụng hiện tại tiêu chuẩn hình ảnh trang phục để biết hình ảnh và siêu dữ liệu được hỗ trợ. Giải quyết các vấn đề xử lý trước khi kích hoạt sản phẩm; không thay thế ID hàng may mặc giữ chỗ cho dữ liệu sản xuất.

Nguồn tham khảo