Construire avec
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.
Choisir le chemin d’intégration
Application 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.
- Installez le fonctionnaire SPREEAI App et complète le flux de consentement géré.
- Synchroniser un groupe de catalogue initial et réviser les états de prédisposition du produit.
- Customiser la position et le styling dans un thème dupliqué.
- Validate eligible products, variants, mobile behavior and add-to-cart.
- Il n'est publié que après la marque et l'approbation QA.
Démarrage rapide du SDK Web
Utiliser @ spreeai /WEB et SDA pour la placement personnalisée, le styling, les événements, la taille et le comportement de carton.
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 Le site officiel SDK API
Accès à l’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 de base
- JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
- Un vêtement par image, centré avec des bords propres et neutres, même éclairage.
- Vue avant requise; Vue arrière recommandée lorsque cette expérience est activée.
- 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 carte de variante a été vérifiée avant d'autoriser l'expérience.
QA et lancement
- Testez le voyage complet des clients sur les navigateurs mobiles et de bureau actuels.
- Vérifiez le produit et la cartographie des variantes, la préparation des vêtements et le comportement de la chaise.
- Vérifiez l’accès au clavier, l’ordre de focalisation, les noms accessibles et le comportement de descente.
- Mesurer la performance de la page du produit avant et après l'engagement SPREEAI.
- Exercise loading, empty, unavailable, timeout and retry states.
- Confirmation du langage de consentement et traitement approuvé de l'image client.
- Obtenez l'ingénierie, le commerce, la QA et la marque sign-off avant la production.
Dépannage
Le bouton ne apparaît pas
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.
Le produit ou la variante incorrecte apparaît
Comparaison du produit de la boutique et des identifiants variantes avec les enregistrements envoyés à SPREEAI. Confirmez que la demande rendue change lorsque le acheteur change les variantes.
L’expérience est lente ou inaccessible
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.
Obtenez le soutien de développeur
Courriel support@spreeai.com avec l’environnement, le produit ou le ID de vêtement, le navigateur ou vic e, le timing approximatif, les étapes de comportement et de reproduction attendues. Ne pas inclure des secrets ou des images client.