mit bauen
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.
Wählen Sie den Integrationsweg
Shopify-App
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.
- Installieren Sie den Offiziellen SPREEAI App und vollständige den verwalteten Einwilligungstrom.
- Synchronisieren Sie eine ursprüngliche Kataloggruppe und überprüfen Sie die Produktbereitschaftsstaaten.
- Anpassung der Position und Styling in einem duplikierten Thema.
- Validate eligible products, variants, mobile behavior and add-to-cart.
- Veröffentlicht nur nach Marke und QA Genehmigung.
Web-SDK-Schnellstart
Gebrauch @ spreeai /Web-Sdk für die angepasene Positionierung, Styling, Veranstaltungen, Größen und Kartenverhalten.
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 Offizielle Web SDK API Referenz
Feuerzugang
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.
Garment Asset Baseline
- JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
- Ein Kleid pro Bild, mit sauberen Randen und neutral, sogar Beleuchtung zentralisiert.
- Front View erforderlich; Rücksicht empfohlen, wenn diese Erfahrung aktiviert ist.
- 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.
- Varianten-Mapping überprüft, bevor die Erfahrung erlaubt wird.
QA und Start
- Testen Sie die komplette Kundenreise auf aktuellen mobilen und Desktop-Browsern.
- Überprüfen Sie Produkt und Variantenmapping, Kleidungsbereitschaft und Kartenverhalten.
- Überprüfen Sie Keyboard-Zugang, Fokus-Order, zugängliche Namen und Fallback-Verhalten.
- Messung der Produkt-Seite Leistung vor und nach der Erlaubnis SPREEAI.
- Exercise loading, empty, unavailable, timeout and retry states.
- Bestätigen Sie die Zustimmungsprache und genehmigt die Verarbeitung des Kundenbildes.
- Erhalten Sie Ingenieur, Handel, QA und Markenzeichen vor der Produktion.
Fehlerbehebung
Der Button erscheint nicht
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.
Das falsche Produkt oder Variante erscheint
Vergleichen Sie das Storefront-Produkt und VariantenIDs mit den auf SPREEAI. Bestätigen Sie, dass die angegebenen Anfrage sich ändert, wenn der Käufer Varianten ändert.
Die Erfahrung ist langsam oder nicht verfügbar
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.
Entwickler unterstützt
E-Mail support@spreeai.com mit der Umwelt, Produkt oder Kleidungs-ID, Browser oder vic e, ungefährer Zeitstempel, erwartete Verhaltensweisen und Reproduktionsstage. Nicht Geheimnisse oder Kundenbild enthalten.