Dokumentacja

SDK 2.0 · INTEGRACJA

Katalog i warianty

Połącz produkty dostępne w sklepie z kwalifikującą się odzieżą SPREEAI i aktualnymi danymi produktów.

Użyj odpowiedniego identyfikatora

Identyfikator produktu, SKU lub identyfikator wariantu w sklepie nie jest automatycznie identyfikatorem odzieży SPREEAI. Zachowaj mapowanie utworzone w procesie przetwarzania lub synchronizacji Shopify. Odzież musi należeć do uwierzytelnionego partnera i być dostępna do przymierzenia.

Zamapuj wybór produktów

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 może filtrować kolor, krój, płeć i styl. Udokumentowane dopasowanie nie uwzględnia wielkości liter. Dopasuj kolor według jego nazwy, np blue, a nie wartość szesnastkową.

Gotowość odzieży

Stan lub warunekAkcja integracyjna
Niezsynchronizowane / przetwarzanie niekompletneZachowaj normalne wrażenia z produktu; nie obiecuj dostępności do przymiarki.
Gotowy, ale wyłączony w ShopifyPrzejrzyj i wyraźnie włącz zamierzony produkt. Samo przygotowanie nie sprawi, że przeżyje.
Dostępna odzież i pasujący wariantRenderuj przycisk dla tego zaznaczenia.
Brak odpowiedniego strojuSpodziewaj się powrotu do pierwszego elementu odzieży w tablicy.
Weryfikacja kończy się niepowodzeniemŻaden przycisk nie jest renderowany; sprawdź konsolę i mapowanie produktu.

Dbaj o aktualność danych produktów

  • Zaktualizuj wyświetlaną cenę i rozmiary dostępne w magazynie, gdy zmieni się wybór produktów.
  • Użyj unikalnych identyfikatorów kontenerów dla oddzielnych przycisków produktów.
  • Podczas ponownego renderowania przycisku należy przekazać bieżący wybór odzieży i wariantu.
  • Przed utworzeniem mutacji koszyka przejrzyj zwrócone dane koszyka w porównaniu z własnym katalogiem.

Przygotuj zasoby odzieżowe

Użyj prądu standardy wizerunku odzieży dla obsługiwanych obrazów i metadanych. Rozwiąż problemy z przetwarzaniem przed włączeniem produktów; nie zastępuj zastępczych identyfikatorów odzieży danymi produkcyjnymi.

Odniesienia źródłowe

Wyszukaj tytuły stron i treść. Ucieczka zamyka wyszukiwanie.

Wybierz swój język.