Marktplatz
SPREEAI für Entwickler
Bau die Umkleidekabine
in jeden Bildschirm.
Beginnen Sie mit Shopify, dem Web-SDK oder einer genehmigten API-Integration. Dieser Hub führt Ihr Team von der ersten Entscheidung bis zu einem getesteten Launch.
- 04
- Integrationspfade
- v2.1
- aktuelles Web SDK
- 01
- Start-Checkliste
Wähle deinen Weg
Fange dort an, wo deine
Commerce Stack lebt.
Wählen Sie den schnellsten Weg, der zu Ihrem Shop passt. Sie können von einer verwalteten App zu einer benutzerdefinierten SDK- oder API-Integration wechseln, wenn die User Experience wächst.
LiveDemnächst
Schnellster Pfad
Shopify-App
Installieren, Kleidungsstücke synchronisieren, anpassen und ohne ein eigenes Backend starten.Am besten für Shopify-Storefronts ↗ v2.1.0Maßgeschneidertes Web
Web-SDK
Steuern Sie die Platzierung, das Styling, die Ereignisse, die Größeneinstellung und das „In den Warenkorb“-Verhalten.JavaScript + TypeScript ↗ DokumenteNative Mobile
iOS-SDK
Integriere das SPREEAI-Erlebnis in eine bestehende iOS-Shopping-Journey.iOS-Anleitung öffnen ↗ DokumenteNative Mobile
Android SDK
Integrieren Sie Try-On mit nativen Steuerelementen in ein Android-Produkt-Erlebnis.Android-Anleitung öffnen ↗ PartnerzugriffMaßgeschneiderte Systeme
Öffentliche APIs
Verwenden Sie die genehmigte API-Referenz für serverseitige Workflows und Katalog-Workflows.Open-API-Referenz ↗Web-SDK-Schnellstart
Von der Installation bis
funktionierende Taste.
Einmal authentifizieren, dann Anprobe oder Größenbestimmung beliebig auf der Seite rendern. Verwenden Sie die während des Onboardings ausgestellten Test-Anmeldeinformationen und platzieren Sie niemals einen Client Secret im Browser-Code.
npm install @spreeai/web-sdk
# oder
yarn add @spreeai/web-sdkimport { init } from "@spreeai/web-sdk";
const sdk = await init({
clientId: "your-client-id",
partnerId: "your-partner-id",
});
if (sdk) {
await sdk.renderTryOnButton({
elementId: "spreeai-try-on",
garments: [{ garmentId: "your-garment-id" }],
enableAddToCart: true,
});
}events: {
onTryOnButtonClick: (event) => {
analytics.track("try_on_started", event);
},
onAddToCartClicked: async (event) => {
// Verbinden Sie dies mit Ihrem bestehenden Warenkorb-Workflow.
},
}Das Integrationsmodell
Vier Systeme.
Ein Kundenerlebnis.
Produkt-IDs, Varianten, Bildmaterial und Merchandising-Kontext.
Kleidungsstücke durchlaufen die Phasen Bearbeitung, Überprüfung und Bereitstellung.
Ihr Schaufenster fordert das Erlebnis für ein berechtigtes Produkt an.
Anprobieren, Größe finden, Look vervollständigen und zur Kasse zurückkehren.
Produktionsweg
Nimm die Integration
über die Ziellinie.
Ein sauberer Launch ist mehr als nur ein funktionierender Button. Nutzen Sie diese Sequenz, um Zugriff, Assets, Verhalten, Qualität und Messung aufeinander abzustimmen.
- 01Eigentümer · Produkt + Handel
Den ersten Weg eingrenzen
Wählen Sie einen Kanal, eine Kataloggruppe, einen Kundenmoment und ein Erfolgsmaß.
- 02Inhaber · Engineering
Zugang vorbereiten
Bestätigen Sie die Partner-ID, die genehmigten Client-Anmeldeinformationen, die Storefront-Berechtigungen und die Staging-Umgebung.
- 03Inhaber · Katalog-Team
Reichen Sie saubere Assets ein
Pro Bild ein Kleidungsstück, Vorderansicht erforderlich, hohe Auflösung, saubere Beleuchtung und auf die Artikelnummer abgestimmte Dateinamen.
- 04Inhaber · Front-End
In Staging integrieren
Nur für berechtigte Produkte ausspielen, Varianten und Warenkorb-Verhalten verknüpfen und den Einstiegspunkt an die Marke anpassen.
- 05Inhaber · QS + Marke
Launch-QA ausführen
Testen Sie Mobilgeräte und Desktops, Browserabdeckung, Barrierefreiheit, Leistung, visuelle Genauigkeit und Fehlerzustände.
- 06Eigentümer · Handel + Analytik
Aktivieren und messen
Schalten Sie fertige Produkte frei, veröffentlichen Sie das vorbereitete Erlebnis und überwachen Sie die Annahme, den Abschluss und die Conversion.
Bestandsbasislinie
Guter Input sorgt für ein besseres Ergebnis.
- JPEG oder PNG
- Mindestens 2.000 × 2.000 px
- Vorderansicht erforderlich
- Rückansicht empfohlen
- Neutrales, gleichmäßiges Licht
- SKU oder Stil-ID im Dateinamen
Entwicklerreferenz
Finde das Nächste
nützliche Antwort.
Hier beginnen
Erste Schritte
Verstehen Sie den Zugriff, unterstützte Plattformen und die ersten Entscheidungen, die Ihr Team treffen muss.
Offizielle Referenz ↗ Verwaltete IntegrationShopify-Onboarding
Installieren Sie die App, akzeptieren Sie die Vereinbarungen, synchronisieren Sie die Kleidungsstücke, passen Sie den Button an und gehen Sie live.
Offizielle Referenz ↗ Web-SDKAPI-Oberfläche
Überprüfung von Initialisierung, Render-Optionen, Größenanpassung, Anpassbarkeit und typisierten Schnittstellen.
Offizielle Referenz ↗ Partner-APIÖffentliche API-Referenz
Erkunden Sie die genehmigte serverseitige Schnittstelle, die für authentifizierte Partner verfügbar ist.
Swagger-Referenz ↗ QualitätBekleidungs-Assets
Bereiten Sie Produktabbildungen und Metadaten vor, die reibungslos durch Erfassung und Überprüfung gelangen.
SPREEAI-Anleitung ↗ ProduktionQualitätssicherung & Launch
Verwenden Sie die gemeinsame Checkliste für Browser, Performance, Barrierefreiheit und Go-Live.
SPREEAI-Anleitung ↗ SupportFehlerbehebung
Beheben Sie die häufigsten Authentifizierungs-, Berechtigungs-, Darstellungs- und Leistungsprobleme.
SPREEAI-Anleitung ↗ DokumentationImplementierungsleitfäden
Durchsuche öffentliche Schnellstartanleitungen, Asset-Standards, Checklisten für den Start und Anleitungen zur Fehlerbehebung.
Dokumentation öffnen ↗Keine passenden Entwicklerressourcen gefunden. Versuchen Sie “Shopify”, “SDK”, “assets” oder “QA”.”
Für die Produktion erstellen
Die Details, die schützen
das Kundenerlebnis.
Sicherheit
Bewahren Sie Geheimnisse serverseitig auf, verwenden Sie ausschließlich bereitgestellte Umgebungen und rotieren Sie Zugangsdaten über den Partner-Workflow.
Datenschutz
Fordern Sie Kundenbilder mit ausdrücklicher Einwilligung an und stimmen Sie die Datenverarbeitung auf Ihren genehmigten Integrationsplan ab.
Leistung
Laden Sie die Experience dort, wo sie benötigt wird, testen Sie reale Geräte und überwachen Sie Regressionen der Produktseite.
Barrierefreiheit
Bewahren Sie den Tastaturzugriff, die Fokusreihenfolge, barrierefreie Namen und einen nutzbaren Pfad bei, wenn die Funktion nicht verfügbar ist.
Entwickler-FAQ
Fragen zuvor
Der erste Commit.
Welche Integration sollten wir wählen?
Verwenden Sie die Shopify App für den schnellsten verwalteten Pfad, das Web-SDK für benutzerdefinierte oder Headless-Web-Platzierungen, die nativen SDKs für App-Erlebnisse und die während des Onboardings vereinbarte, genehmigte API-Referenz für serverseitige Workflows.
Woher kommen Anmeldeinformationen?
SPREEAI vergibt während des Onboardings die Partner-ID und die genehmigten Zugangsdaten. Das Browser-SDK verwendet eine Client-ID und eine Partner-ID. Binden Sie niemals ein Client-Secret in Frontend-Code ein.
Erfordert die Shopify-App API-Schlüssel?
Der aktuelle Shopify App Onboarding-Prozess verbindet den Shop nach den erforderlichen Vereinbarungen und dem Abonnement-Schritt; die Managed App erfordert kein Kopieren von Schlüsseln in den Einrichtungsbildschirm.
Warum wird der Anprobieren-Button nicht angezeigt?
Bestätigen Sie, dass die Verarbeitung des Kleidungsstücks abgeschlossen ist, für Try-On aktiviert ist, dem aktiven Produkt oder der aktiven Variante zugeordnet ist und dass der App-Block oder der SDK-Container auf der Produktvorlage vorhanden ist.
Welche Client-Ereignisse sind verfügbar?
Die dokumentierten SDK-Callbacks decken Try-On-Button-Klicks und Add-to-Cart-Interaktionen ab. Verbinden Sie diese mit Ihrer Analytics-Ebene, ohne Kundenbilder oder unnötige personenbezogene Daten einzubeziehen.
Sind Server-Webhooks verfügbar?
Server-Push-Webhooks sind nicht Teil der aktuell veröffentlichten SDK-Dokumentation. Stimmen Sie alle Anforderungen an serverseitige Ereignisse vor der Verwendung mit der Partner Engineering ab.
Wo bekommen Entwickler Hilfe?
Nutzen Sie den während des Onboardings bereitgestellten technischen Support-Pfad oder schreiben Sie eine E-Mail support@spreeai.com. Schließen Sie die Umgebung, die Produkt-ID, den Browser oder das Gerät, den Zeitstempel und einen prägnanten Replikationspfad ein – senden Sie niemals Geheimnisse.
Wann wird der Support für das Amazon Partner Network verfügbar sein?
Die Integration in das Amazon Partner Network befindet sich in der Entwicklung. Sie ist absichtlich als „Demnächst verfügbar“ gekennzeichnet, bis die Onboarding- und Produktionsoberfläche für externe Entwickler bereit sind.
Bereit zum Bauen?