Незабаром приїжджайте до мережі партнерів Amazon та інших платформ, з більш різними способами інтеграції SPREEAI Ввімкніть свій торговельний стак.Оновлення з'являтимуться тут першими

Швидкий старт із Web SDK

Ваша перша інтеграція.

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

npm install @spreeai/web-sdk

# або
yarn add @spreeai/web-sdk

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

const sdk = await init({
  clientId: "your-client-id",
  partnerId: "your-partner-id",
});

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

events: {
  onTryOnButtonClick: (event) => {
    analytics.track("try_on_started", event);
  },
  onAddToCartClicked: async (event) => {
    // Підключіть до наявного робочого процесу кошика.
  },
}

Модель інтеграції

Чотири системи.
Один момент із клієнтом.

01Ваш каталог

Індетифікатори товарів, варіанти, зображення та контекст мерчандайзингу.

02Інгестія SPREEAI

Одяг проходить через стадії обробки, перевірки та готовності.

03SDK чи API

Ваша вітрина запитує враження для прийнятного товару.

04Дія клієнта

Приміряйте, знайдіть розмір, доповніть образ і поверніться до оформлення замовлення.

Наступна статтяКто чего не ест

Підготуйтеся Зв'яжіться
Живіть з впевненістю.

Три мілістонії, з практичною перевіркою для кожного.

01 Підготовка
Яскравий початковий пункт.
Збалансуйте подорож, доступ і каталог.
Підготовка перевірки
- Виберіть один канал, каталог групу та показник успіху.
- Підтверджуйте партнерський доступ, акредитації та дозволи на перехід.
- Забезпечити чистий, SKU-алійований зображення одягу.
Продукція · Інженерія · Каталог
02 · Зв'язок
Зробіть його відчуватись нацистським.
Будівництво в стадіоні. Проведіть весь шлях.
Інтеграція перевірки
- Оренда на вигідні продукти та зв'язок варіантів і поведінки кошика.
- Збіг досвіду з брендом.
- Перевірте стан мобільного, робочого столу, доступності, продуктивності та невдачі.
Фронт-енд · QA · Бренд
03 - Початок
Вчимося від реальної використання.
Використовуйте готові продукти та вимірюйте їх.
Запуск перевірки
- Підтверджуйте готовність продукту та опублікуйте стадійний досвід.
- Моніторинг прийняття, завершення та конвертації.
- Використовуйте результати, щоб направляти наступну категорію або подорож.
Торгівля · Аналіз

Базовий стан активів

Добрий вхідний результат дає кращий результат.

JPEG чи PNG
мінімум 2000 × 2000 пікселів
Потрібен вид спереду
Рекомендується вигляд ззаду
Нейтральне, рівне освітлення
SKU або ідентифікатор стилю в назві файлу

Відкрийте перевірку активів

Довідка для розробників

Знайди наступне
корисна відповідь.

/

Почати тут

Початок роботи

Зрозумійте доступ, підтримувані платформи та перші рішення, які має прийняти ваша команда.

Офіційна референція Керована інтеграція

Онбординг у Shopify

Встановіть додаток, прийміть угоди, синхронізуйте одяг, налаштуйте кнопку та починайте трансляцію.

Офіційна референція Веб-SDK

Поверхня API

Огляньте ініціалізацію, параметри відтворення, визначення розмірів, налаштування та типізовані інтерфейси.

Офіційна референція Партнерський API

Довідник публічного API

Досліслійте затверджений інтерфейс на боці сервера, доступний для автентифікованих партнерів.

Світовий референт Якість

Елементи одягу

Підготуйте зображення та метадані товарів, які безперешкодно проходять завантаження та перевірку.

SPREEAI Керівництво Виробництво

Тестування та запуск

Використовуйте спільний чекліст для браузерів, продуктивності, доступності та запуску.

SPREEAI Керівництво Підтримка

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

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

SPREEAI Керівництво Документація

Посібники з впровадження

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

Відкрита документація

Зібрати для продакшну

Деталі, що захищають
клієнтський досвід.

Безпека

Зберігайте секрети на сервері, використовуйте лише видані середовища та ротуйте облікові дані через робочий процес партнерів.

Конфіденційність

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

Продуктивність

Завантажуйте досвід там, де це необхідно, тестуйте реальні пристрої та відстежуйте регресії сторінок продуктів.

Доступність

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

ЧаПи для розробників

Запитання перед
перший коміт.

Якую інтеграцію нам обрати?

Використовуйте додаток Shopify для найшвидшого керованого шляху, Web SDK для кастомного або безголового (headless) веб-розміщення, нативні SDK для додатків, а також затверджену довідкову документацію з API для серверних робочих процесів, погоджених під час інтеграції.

Звідки беруться облікові дані?

SPREEAI видає ідентифікатор партнера (partner ID) та затверджені облікові дані під час підключення. Браузерний SDK використовує ідентифікатор клієнта (client ID) та ідентифікатор партнера (partner ID). Ніколи не вбудовуйте секрет клієнта (client secret) у код інтерфейсної частини (front-end).

Чи потрібні додатку Shopify ключі API?

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

Чому кнопка «Приміряти» не з'являється?

Підтвердьте, що обробку одягу завершено, його ввімкнено для примірки (Try-On), він прив'язаний до активного товару або варіанта, а блок додатка або контейнер SDK присутній у шаблоні товару.

Якие події клієнта доступні?

Документовані зворотні виклики SDK охоплюють кліки по кнопці «Приміряти» та взаємодії з додаванням до кошика. Підключіть їх до свого рівня аналітики без включення зображень клієнтів або непотрібних персональних даних.

Чи доступні вебхуки сервера?

Вебхуки на основі виштовхування сервером (server-push) не входять до поточної опублікованої документації SDK. Узгоджуйте будь-які вимоги щодо подій на стороні сервера з інженерною командою партнерів (Partner Engineering), перш ніж покладатися на них.

Де розробники беруть допомогу?

Використовуйте шлях технічної підтримки, наданий під час адаптації або в електронному листі support@spreeai.com. Включіть середовище, ідентифікатор продукту, браузер або пристрій, мітку часу та стислий шлях відтворення — ніколи не надсилайте секрети.

Коли буде доступна підтримка партнерської мережі Amazon?

Інтеграція з партнерською мережею Amazon перебуває в розробці. Вона навмисно позначена як "Скоро" (Coming Soon), доки інтерфейс адаптації та робочого середовища не будуть готові для сторонніх розробників.

Готові будувати?

Обери шлях.
Ми допоможемо вам це доставити.

Забронювати технічне дослідження Переглянути всі доки Відкрити робочий простір партнерів

Облаштуйте примірочнуу кожен екран.

Почніть там, де вашікомерційний стек живий.

Додаток Shopify

Веб-SDK

СДК

Android SDK

Публічні API

Партнерська мережа Amazon

Ваша перша інтеграція.

Чотири системи.Один момент із клієнтом.

Підготуйтеся Зв'яжітьсяЖивіть з впевненістю.

Яскравий початковий пункт.

Зробіть його відчуватись нацистським.

Вчимося від реальної використання.