Catalog at mga variant | SDK 2.0

Gamitin ang tamang identifier

Ang storefront product ID, SKU o variant ID ay hindi awtomatikong SPREEAI garment ID. Panatilihin ang isang pagmamapa na ginawa sa pamamagitan ng iyong ingestion o Shopify sync workflow. Ang damit ay dapat na pagmamay-ari ng napatotohanan na kasosyo at magagamit para sa pagsubok.

I-map ang pagpili ng produkto

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 maaaring mag-filter ng kulay, akma, kasarian at istilo. Ang dokumentadong pagtutugma ay case-insensitive. Itugma ang kulay sa pangalan nito, gaya ng blue, sa halip na sa pamamagitan ng isang hex na halaga.

Paghahanda ng damit

Estado o kundisyon	Pagsasama-sama ng pagkilos
Hindi naka-sync / hindi kumpleto ang pag-ingest	Panatilihin ang normal na karanasan sa produkto; huwag ipangako ang pagkakaroon ng try-on.
Handa ngunit hindi pinagana sa Shopify	Suriin at tahasang paganahin ang nilalayong produkto. Ang handa na nag-iisa ay hindi ito nabubuhay.
Magagamit na damit at katugmang variant	I-render ang button para sa pagpipiliang iyon.
Walang katugmang magagamit na damit	Asahan ang fallback sa unang damit sa array.
Nabigo ang pagpapatunay	Walang button na nai-render; imbestigahan ang console at pagmamapa ng produkto.

Panatilihing napapanahon ang data ng produkto

I-update ang ipinapakitang presyo at mga in-stock na laki kapag nagbago ang pagpili ng produkto.
Gumamit ng mga natatanging container ID para sa hiwalay na mga button ng produkto.
Kapag nagre-render muli ng button, ipasa ang kasalukuyang pagpili ng damit at variant.
Suriin ang ibinalik na data ng cart laban sa sarili mong catalog bago gumawa ng mutation ng cart.

Maghanda ng mga asset ng damit

Gamitin ang kasalukuyang mga pamantayan ng imahe ng damit para sa suportadong koleksyon ng imahe at metadata. Lutasin ang mga isyu sa pagproseso bago i-enable ang mga produkto; huwag palitan ang mga placeholder garment ID para sa data ng produksyon.

Mga sanggunian sa pinagmulan