בונה עם
ספריאיי.
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.
בחר את מסלול האינטגרציה
אפליקציית שופיפיי
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.
- התקנת המפקח SPREEAI אפליקציה ולסיים את זרימת ההסכמה המנוהלת.
- סינכרון קבוצת קטגוריה ראשונית ומצב ההכנה של המוצר.
- התאמה אישית של מיקום ועיצוב בנושא כפול.
- Validate eligible products, variants, mobile behavior and add-to-cart.
- פרסום רק לאחר אישור המותג ו-QA.
אתר SDK QuickStart
שימוש @ spreeai WEB - Sdk עבור מיקום מותאם אישית, סגנון, אירועים, גודל והתנהגות חגורה.
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 אתר אינטרנט רשמי SDK API
גישה ל- 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.
רכישת נכסים בסיס
- JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
- אחד בגדים לכל תמונה, ממוקד עם קצות נקיות ונייטרליות, אפילו תאורה.
- צפייה קדמית נדרשת; צפייה אחורית מומלצת כאשר החוויה הזו מופעלת.
- 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.
- המפה הבולטת נבדקה לפני שהחוויה תהיה אפשרית.
QA והפתיחה
- בדוק את מסע הלקוח המלא על דפדפנים ניידים ועבודה מקוונים הנוכחיים.
- בדוק את המוצר ואת מפת הבוררות, הכנה בגדים והתנהגות החולצה.
- בדוק את גישה למקלדת, סדר המוקד, שמות נגישים והתנהגות fallback.
- מדידת ביצועי דף המוצר לפני ואחרי האפשרות SPREEAI.
- Exercise loading, empty, unavailable, timeout and retry states.
- אישור שפת הסכמה וניהול מאושר של תמונת הלקוח.
- קבל הנדסה, מסחר, QA וסימן מותג לפני הייצור.
פתרון בעיות
הכפתור לא מופיע
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.
מוצר או שונה לא נכונים מופיעים
השוואת המוצר של חנות ו- Variant IDs עם הרשומות שנשלחו ל SPREEAI. אישור שהבקשה המוצעת משתנה כאשר הקונה משנה את התכונות.
החוויה איטית או לא זמינה
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.
קבל תמיכה מפתח
דוא״ל support@spreeai.com עם הסביבה, המוצר או שמלת כלה, דפדפן או vic א, טווח זמן קרוב, התנהגות צפויה ושלבים של התפרקות. אל תכלול סודות או תמונות של לקוחות.