Используйте правильный идентификатор
Идентификатор продукта, артикул или идентификатор варианта на витрине не является автоматически идентификатором одежды SPREEAI. Поддерживайте сопоставление, созданное в ходе рабочего процесса приема или синхронизации Shopify. Одежда должна принадлежать проверенному партнеру и быть доступной для примерки.
Карта выбора продуктов
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 может фильтровать цвет, посадку, пол и стиль. Документированное сопоставление не учитывает регистр. Сопоставьте цвет по его названию, например blue, а не шестнадцатеричным значением.
Готовность одежды
| Состояние или состояние | Интеграционное действие |
|---|---|
| Не синхронизировано/загрузка не завершена | Сохраняйте нормальный опыт работы с продуктом; не обещайте наличие примерки. |
| Готов, но отключен в Shopify | Просмотрите и явно включите предполагаемый продукт. Одна только готовность не делает его живым. |
| Доступный предмет одежды и соответствующий вариант | Отрисуйте кнопку для этого выделения. |
| Нет подходящего наряда | Ожидайте возврата к первому предмету одежды в массиве. |
| Проверка не удалась | Ни одна кнопка не отображается; изучите консоль и сопоставление продуктов. |
Поддерживайте актуальность данных о продукте
- Обновите отображаемую цену и размеры на складе при изменении выбора продукта.
- Используйте уникальные идентификаторы контейнеров для отдельных кнопок продукта.
- При повторном рендеринге кнопки передайте текущий предмет одежды и выбор варианта.
- Прежде чем создавать мутацию корзины, проверьте возвращенные данные корзины по своему собственному каталогу.
Подготовьте материалы для одежды
Используйте текущий стандарты имиджа одежды для поддерживаемых изображений и метаданных. Решайте проблемы обработки перед включением продуктов; не заменяйте производственные данные идентификаторами одежды.