dibina dengan
SPREEAI.

Aplikasi Shopify

Use the managed app when the store runs on Shopify and does not need a custom backend. The current onboarding flow connects the store after agreements and subscription; it does not require copying API keys into the setup screen.

1. Pastikan pegawai SPREEAI app dan melengkapkan aliran persetujuan yang dikendalikan.
2. Sinkronkan kumpulan katalog awal dan ulasan status kesediaan produk.
3. Menyesuaikan penempatan dan gaya dalam tema duplikat.
4. Validate eligible products, variants, mobile behavior and add-to-cart.
5. Hanya selepas jenama dan kelulusan QA.

Buka Panduan Perahu Shopify

Permulaan pantas SDK Web

Penggunaan @ spreeai Web-sdk dalam untuk penempatan tersuai, gaya, acara, saiz dan tingkah laku keranjang.

npm install @spreeai/web-sdk

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

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

sdk.renderTryOnButton({
  selector: "#spreeai-try-on",
  productId: product.id,
  enableAddToCart: true
});

Initialize once, render only for an eligible product and connect documented client callbacks to your existing analytics. Confirm the current interface in the Rujukan API rasmi Web SDK

Penyertaan api

Use the public Swagger reference only for server-side workflows approved during onboarding. Keep secrets on your server, separate test and production access, and scope credentials to the minimum required environment.

Direct REST endpoints, webhooks or authentication behaviors not present in the approved public reference should be treated as unavailable until Partner Engineering confirms them.

Membuka rujukan API awam yang diluluskan

Peralatan Aset Baseline

• JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
• Satu pakaian per imej, berpusat dengan tepi bersih dan neutral, walaupun pencahayaan.
• pandangan hadapan diperlukan; pandangan belakang disyorkan apabila pengalaman itu diaktifkan.
• Stable SKU, style or garment ID included in the filename and catalogue record.
• No hands, hangers, styling props, watermarks or unrelated garments blocking the item.
• Variant mapping diperiksa sebelum membolehkan pengalaman.

QA dan pelancaran

• Ujian perjalanan pelanggan lengkap pada pelayar mudah alih dan desktop semasa.
• Semak produk dan varian peta, kesediaan pakaian dan tingkah laku keranjang.
• Semak akses keyboard, fokus perintah, nama yang boleh diakses dan tingkah laku fallback.
• Mengukur prestasi halaman produk sebelum dan selepas pemberian SPREEAI.
• Exercise loading, empty, unavailable, timeout and retry states.
• Mengesahkan bahasa persetujuan dan pemprosesan imej pelanggan yang diluluskan.
• Dapatkan kejuruteraan, perdagangan, QA dan tanda tangan jenama sebelum pengeluaran.

Penyelesaian masalah

Butang tidak muncul

Confirm SDK initialization, client and partner identifiers, the target selector, product eligibility, garment readiness and variant mapping. Then check browser console and network errors without sharing tokens.

Produk atau varian yang salah muncul

Bandingkan produk kedai dan varian ID dengan rekod yang dihantar kepada SPREEAI. Mengesahkan bahawa permintaan yang dikemukakan berubah apabila pembeli mengubah varian.

Pengalaman yang lambat atau tidak tersedia

Test a known-ready product, verify the active environment, inspect blocked requests and compare a clean browser session. Capture a timestamp and reproducible sequence for support.

Dapatkan sokongan pemaju

E-mel support@spreeai.com dengan persekitaran, produk atau pakaian ID, pelayar atau vic e, jangka masa yang kira-kira, tingkah laku yang dijangka dan langkah-langkah pembiakan. Jangan masukkan rahsia atau imej pelanggan.