Costruito con
SPREEAI.
A practical path from integration choice to a tested launch. Start with one commerce journey, use issued test access and keep credentials out of browser code.
Scegli il percorso di integrazione
App 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.
- Installare il funzionario SPREEAI App e completare il flusso di consenso gestito.
- Sincronti un gruppo di catalogo iniziale e valuta gli stati di disponibilità del prodotto.
- Personalizzare la posizione e lo stile in un tema duplicato.
- Validate eligible products, variants, mobile behavior and add-to-cart.
- Pubblicato solo dopo la marchio e l'approvazione QA.
Sito web SDK Quickstart
Utilizzo @ spreeai Il web-sdk per la posizione personalizzata, lo stile, gli eventi, la dimensione e il comportamento della carrozzeria.
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 Web SDK API di riferimento
Accesso 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.
Asset di base
- JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
- Un vestito per immagine, centrato con bordi puliti e neutrali, anche illuminazione.
- Visto frontale richiesto; visualizzazione posteriore raccomandata quando è abilitata quella esperienza.
- 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.
- La variante di mappatura è stata controllata prima di consentire l'esperienza.
QA e lancio
- Testare il percorso completo del cliente sui browser mobili e desktop attuali.
- Verificare il prodotto e la cartografia variante, la disponibilità del vestito e il comportamento della cartuccia.
- Controlla l'accesso alla tastiera, l'ordine di focalizzazione, i nomi accessibili e il comportamento fallback.
- misurare le prestazioni della pagina del prodotto prima e dopo SPREEAI.
- Exercise loading, empty, unavailable, timeout and retry states.
- Confirmare il linguaggio di consenso e approvato il trattamento dell'immagine del cliente.
- Ottieni ingegneria, commercio, QA e marchio prima della produzione.
Risoluzione dei problemi
Il pulsante non appare
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.
Il prodotto o la variante sbagliata appare
Confronta il prodotto e le ID di variante con i record inviati a SPREEAI. Confirmare che la richiesta presentata cambia quando il compratore cambia le varianti.
L’esperienza è lenta o inutilizzabile
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.
Ottieni il supporto dello sviluppatore
e-mail support@spreeai.com con l'ambiente, il prodotto o il ID di abbigliamento, il browser o vic e, orario approfondito, comportamento atteso e fasi di riproduzione. Non includere segreti o immagini dei clienti.