Bevor Sie beginnen
- A
clientIdausgestellt von SPREEAI für Ihre zugelassene Umgebung. - Ein Kleidungsstück, dessen Einnahme abgeschlossen ist, gehört zu Ihrem Konto und steht zum Anprobieren zur Verfügung.
- Eine Produktseite, die Sie bearbeiten können, und ein Container mit einer eindeutigen HTML-ID.
1. Installieren
Terminal
npm install @spreeai/web-sdk@3.0.0Das Stylesheet ist Teil des Pakets und muss in Ihrem Bundle enthalten sein.
2. Fügen Sie einen Container hinzu
HTML
<div id="spreeai-try-on"></div>3. Initialisieren und rendern
TypeScript
import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";
// Add <div id="spreeai-try-on"></div> to your product page.
const sdk = await init({ clientId: "YOUR_ISSUED_CLIENT_ID" });
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "YOUR_READY_GARMENT_ID" }],
});
} else {
// Keep the normal product and purchase journey available.
console.warn("SPREEAI could not initialize.");
}init() kann zurückkehren null. Überprüfen Sie das Ergebnis vor dem Rendern und initialisieren Sie es einmal pro Seite und nicht für jede Schaltfläche.
4. Überprüfen Sie das Ergebnis
- Laden Sie die Produktseite. Ein gültiges, verfügbares Kleidungsstück stellt einen Anprobeknopf dar.
- Öffnen Sie die Umkleidekabine und bestätigen Sie das gewünschte Kleidungsstück und die Farbe.
- Schließen Sie es und öffnen Sie es erneut. Überprüfen Sie das Erlebnis auf einem Telefon und einem Desktop.
- Probieren Sie ein nicht verfügbares Kleidungsstück in Ihrer Testumgebung aus. Bestätigen Sie, dass Ihr normaler Produkt- und Bezahlpfad weiterhin nutzbar ist.
Wohin als nächstes?
Daten
Produkte und Varianten zuordnen
Verwenden Sie SPREEAI-Kleidungsstück-IDs und prüfen Sie die Bereitschaft vor dem Rendern.
KasseWarenkorb und Ereignisse verbinden
Aktivieren Sie Add-to-Cart und implementieren Sie Ihren Storefront-Handler.
PasstFügen Sie eine Größenanleitung hinzu
Aktivieren Sie unterstützte Empfehlungen und optionale Größenanzeige.
OptionenDurchsuchen Sie die API
Sehen Sie sich die vollständig verifizierte Option und die Rückrufoberfläche an.