Utilizza l'identificatore corretto
L'ID prodotto della vetrina, lo SKU o l'ID variante non è automaticamente un ID capo SPREEAI. Mantieni una mappatura creata tramite il flusso di lavoro di acquisizione o di sincronizzazione Shopify. Il capo deve appartenere al partner autenticato ed essere disponibile per la prova.
Mappa una selezione di prodotti
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 può filtrare colore, vestibilità, genere e stile. La corrispondenza documentata non fa distinzione tra maiuscole e minuscole. Abbina il colore con il suo nome, ad esempio blue, anziché da un valore esadecimale.
Prontezza dell'indumento
| Stato o condizione | Azione di integrazione |
|---|---|
| Non sincronizzato/acquisizione incompleta | Mantieni la normale esperienza del prodotto; non promettono la disponibilità della prova. |
| Pronto ma disabilitato in Shopify | Esaminare e abilitare esplicitamente il prodotto previsto. Essere pronti da soli non basta a vivere. |
| Capo disponibile e variante abbinata | Renderizza il pulsante per quella selezione. |
| Nessun outfit corrispondente disponibile | Aspettatevi il fallback al primo capo dell'array. |
| La convalida fallisce | Nessun pulsante viene visualizzato; esaminare la console e la mappatura del prodotto. |
Mantieni aggiornati i dati del prodotto
- Aggiorna il prezzo visualizzato e le taglie disponibili quando cambia la selezione del prodotto.
- Utilizza ID contenitore univoci per pulsanti di prodotto separati.
- Quando si esegue nuovamente il rendering di un pulsante, passare l'indumento corrente e la selezione della variante.
- Esamina i dati del carrello restituiti rispetto al tuo catalogo prima di creare una mutazione del carrello.
Preparare le risorse dell'abbigliamento
Usa la corrente standard di immagine degli indumenti per immagini e metadati supportati. Risolvere i problemi di elaborazione prima di abilitare i prodotti; non sostituire gli ID degli indumenti segnaposto con i dati di produzione.