Bauen Sie mit
SPREEAI.

Shopify App

Nutzen Sie die verwaltete App, wenn der Shop unter Shopify läuft und kein benutzerdefiniertes Backend benötigt. Der aktuelle Onboarding-Prozess verbindet den Shop nach Vertragsabschluss und Abonnement; API-Schlüssel müssen nicht in die Einrichtungsmaske kopiert werden.

1. Installieren Sie die offizielle SPREEAI-App und schließen Sie den verwalteten Einwilligungsfluss ab.
2. Synchronisieren Sie eine erste Kataloggruppe und überprüfen Sie die Produktbereitschaftsstatus.
3. Passen Sie Platzierung und Stil in einem duplizierten Design an.
4. Prüfen Sie, ob berechtigte Produkte, Varianten, das Nutzerverhalten auf Mobilgeräten und der Warenkorb hinzugefügt werden.
5. Veröffentlichung erst nach Marken- und QA-Genehmigung.

Öffnen Sie den offiziellen Shopify Onboarding-Leitfaden

Web SDK Schnellstart

Verwenden @spreeai/web-sdk für individuelle Platzierung, Gestaltung, Ereignisse, Größenanpassung und Warenkorbverhalten.

npm install @spreeai/web-sdk@3.0.0

import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";

// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });

if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "your-garment-id" }],
    enableAddToCart: true,
  });
}

Einmal initialisieren, nur für ein berechtigtes Produkt rendern und dokumentierte Kundenrückrufe mit Ihren vorhandenen Analysen verbinden. Bestätigen Sie die aktuelle Schnittstelle im offizielle Web SDK API-Referenz

API-Zugriff

Verwenden Sie die öffentliche Swagger-Referenz ausschließlich für serverseitige Workflows, die während des Onboardings genehmigt wurden. Bewahren Sie vertrauliche Daten auf Ihrem Server auf, trennen Sie Test- und Produktionszugriffe und beschränken Sie die Zugangsdaten auf die minimal erforderliche Umgebung.

Direkte REST-Endpunkte, Webhooks oder Authentifizierungsverhalten, die in der genehmigten öffentlichen Referenz nicht vorhanden sind, sollten als nicht verfügbar behandelt werden, bis Partner Engineering sie bestätigt.

Öffnen Sie die genehmigte öffentliche API-Referenz

Basislinie für Bekleidungs-Assets

• JPEG oder PNG; Mindestens 2.000 × 2.000 Pixel, vorzugsweise etwa 4K.
• Ein Kleidungsstück pro Bild, zentriert mit sauberen Kanten und neutraler, gleichmäßiger Beleuchtung.
• Vorderansicht erforderlich; Rückansicht wird empfohlen, wenn diese Erfahrung aktiviert ist.
• Stabile Artikelnummer, Stil- oder Kleidungsstück-ID sind im Dateinamen und im Katalogdatensatz enthalten.
• Keine Hände, Kleiderbügel, Styling-Requisiten, Wasserzeichen oder damit zusammenhängende Kleidungsstücke blockieren den Artikel.
• Die Variantenzuordnung wurde vor der Aktivierung der Funktion überprüft.

Qualitätssicherung und Einführung

• Testen Sie die gesamte Customer Journey auf aktuellen mobilen und Desktop-Browsern.
• Produkt- und Variantenzuordnung, Verfügbarkeit der Kleidungsstücke und Warenkorbverhalten überprüfen.
• Überprüfen Sie den Tastaturzugriff, die Fokusreihenfolge, die zugänglichen Namen und das Fallback-Verhalten.
• Messen Sie die Leistung der Produktseite vor und nach der Aktivierung von SPREEAI.
• Übungsstatus „Laden“, „Leer“, „Nicht verfügbar“, „Zeitüberschreitung“ und „Wiederholen“.
• Bestätigen Sie die Einwilligungserklärung und den genehmigten Umgang mit Kundenbildern.
• Holen Sie vor der Produktion die technische, kommerzielle, Qualitätssicherungs- und Markenfreigabe ein.

Fehlerbehebung

Der Button wird nicht angezeigt

Bestätigen Sie die SDK-Initialisierung, die Client-ID, die Host-Element-ID, die Produktberechtigung, die Bekleidungsbereitschaft und die Variantenzuordnung. Überprüfen Sie dann die Browser-Konsolen- und Netzwerkfehler, ohne Tokens freizugeben.

Das falsche Produkt oder die falsche Variante erscheint

Vergleichen Sie die Storefront-Produkt- und Varianten-IDs mit den an SPREEAI gesendeten Datensätzen. Bestätigen Sie, dass sich die gerenderte Anfrage ändert, wenn der Käufer Varianten ändert.

Die Verbindung ist langsam oder nicht verfügbar.

Testen Sie ein einsatzbereites Produkt, überprüfen Sie die aktive Umgebung, untersuchen Sie blockierte Anfragen und vergleichen Sie diese mit einer fehlerfreien Browsersitzung. Erfassen Sie einen Zeitstempel und eine reproduzierbare Sequenz für den Support.

Holen Sie sich Entwicklerunterstützung

E-Mail support@spreeai.com Bitte geben Sie die Umgebung, die Produkt- oder Kleidungsstück-ID, den Browser oder das Gerät, den ungefähren Zeitstempel, das erwartete Verhalten und die Reproduktionsschritte an. Geheimnisse oder Kundenbilder dürfen nicht enthalten sein.