Bruk riktig identifikator
En butikkfrontprodukt-ID, SKU eller variant-ID er ikke automatisk en SPREEAI plagg-ID. Oppretthold en kartlegging opprettet gjennom inntak eller Shopify synkroniseringsarbeidsflyt. Plagget må tilhøre den autentiserte partneren og være tilgjengelig for prøving.
Kartlegg et produktutvalg
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 kan filtrere farge, passform, kjønn og stil. Dokumentert samsvar skiller mellom store og små bokstaver. Match farge etter navnet, for eksempel blue, i stedet for med en hex-verdi.
Klesklarhet
| Tilstand eller tilstand | Integreringsaksjon |
|---|---|
| Ikke synkronisert / ufullstendig inntak | Behold den normale produktopplevelsen; ikke lov å prøve-på tilgjengelighet. |
| Klar, men deaktivert i Shopify | Se gjennom og aktiver det tiltenkte produktet eksplisitt. Klar alene gjør det ikke live. |
| Tilgjengelig plagg og matchende variant | Gjengi knappen for det valget. |
| Ingen matchende tilgjengelig antrekk | Forvent fallback til det første plagget i serien. |
| Validering mislykkes | Ingen knapp gjengis; undersøke konsollen og produktkartleggingen. |
Hold produktdata oppdatert
- Oppdater vist pris og lagerstørrelser når produktutvalget endres.
- Bruk unike beholder-ID-er for separate produktknapper.
- Når du gjengir en knapp, passerer du det gjeldende utvalget av plagg og varianter.
- Se gjennom de returnerte handlekurvdataene mot din egen katalog før du oppretter en handlekurvmutasjon.
Forbered plagg eiendeler
Bruk strømmen standarder for plaggbilde for støttede bilder og metadata. Løs behandlingsproblemer før du aktiverer produkter; ikke erstatt plassholder plagg IDer for produksjonsdata.