Створити з
SPREEAI.

Shopify Додаток

Використовуйте керований застосунок, коли магазин працює на Shopify і не потребує спеціального бекенду. Поточний процес адаптації підключає магазин після укладення угод та підписки; він не вимагає копіювання ключів API на екран налаштування.

1. Встановіть офіційний застосунок SPREEAI та завершіть процес отримання керованої згоди.
2. Синхронізуйте початкову групу каталогу та перегляньте стан готовності продукту.
3. Налаштуйте розміщення та стиль у дублікатній темі.
4. Перевірте відповідні товари, варіанти, поведінку на мобільних пристроях та додавання до кошика.
5. Публікувати лише після схвалення бренду та контролю якості.

Відкрийте офіційний посібник з адаптації Shopify

Короткий посібник з веб-SDK

Використання @spreeai/web-sdk для налаштування розміщення, стилю, подій, розмірів та поведінки кошика.

npm install @spreeai/web-sdk@3.0.0

import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";

// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });

if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "your-garment-id" }],
    enableAddToCart: true,
  });
}

Ініціалізуйте один раз, відтворюйте лише для відповідного продукту та підключайте задокументовані зворотні виклики клієнтів до вашої існуючої аналітики. Підтвердьте поточний інтерфейс у офіційний довідник API веб-SDK

Доступ до API

Використовуйте публічне посилання Swagger лише для робочих процесів на стороні сервера, затверджених під час адаптації. Зберігайте секрети на своєму сервері, розділяйте доступ до тестування та виробництва, а також обмежуйте облікові дані мінімально необхідним середовищем.

Прямі кінцеві точки REST, вебхуки або поведінка автентифікації, які відсутні у затвердженому публічному посиланні, слід вважати недоступними, доки їх не підтвердить інженерний партнер.

Відкрийте затверджений публічний довідник API

Базовий показник активів одягу

• JPEG або PNG; мінімум 2000 × 2000 пікселів, бажано приблизно 4K.
• Один предмет одягу на зображення, по центру, з чіткими краями та нейтральним, рівномірним освітленням.
• Потрібен вид спереду; вид ззаду рекомендується, якщо цей режим увімкнено.
• Стабільний артикул, ідентифікатор стилю або предмета одягу, включений до назви файлу та запису каталогу.
• Жодних рук, вішалок, стилізаційних елементів, водяних знаків чи не пов'язаного одягу, що загороджує виріб.
• Зіставлення варіантів перевірено перед активацією функції.

Контроль якості та запуск

• Перевірте повний шлях клієнта на сучасних мобільних та настільних браузерах.
• Перевірте зіставлення товарів та їх варіантів, готовність одягу та поведінку кошика.
• Перевірте доступ з клавіатури, порядок фокусування, доступні імена та резервну поведінку.
• Виміряйте ефективність сторінки товару до та після ввімкнення SPREEAI.
• Стани завантаження, порожньо, недоступно, тайм-аут та повторної спроби вправи.
• Підтвердьте формулювання згоди та схвалену обробку зображень клієнта.
• Отримайте узгодження з інженерами, комерційними відділами, відділами контролю якості та бренду перед початком виробництва.

Усунення несправностей

Кнопка не відображається

Підтвердьте ініціалізацію SDK, ідентифікатор клієнта, ідентифікатор елемента хоста, придатність продукту, готовність одягу та зіставлення варіантів. Потім перевірте консоль браузера та помилки мережі без спільного використання токенів.

Відображається неправильний продукт або варіант

Порівняйте ідентифікатори товарів та варіантів у магазині із записами, надісланими на SPREEAI. Переконайтеся, що відображений запит змінюється, коли покупець змінює варіанти.

Робота повільна або недоступна

Тестуйте продукт, готовий до використання, перевірте активне середовище, перевірте заблоковані запити та порівняйте чистий сеанс браузера. Зафіксуйте позначку часу та відтворювану послідовність для підтримки.

Отримайте підтримку розробників

Електронна пошта support@spreeai.com із середовищем, ідентифікатором продукту чи одягу, браузером чи пристроєм, приблизною міткою часу, очікуваною поведінкою та кроками відтворення. Не додавайте секрети чи зображення клієнтів.