KI Virtuelle Anprobe für Shopware 6 — Anleitung

Dieses Modul fügt den Produktseiten von Shopware 6 ein virtuelles Anprobe-Widget hinzu. Der Kunde fügt ein Foto von sich hinzu und Google Vertex AI erzeugt eine Vorschau des getragenen Kleidungsstücks. Kompatibel mit Shopware 6.5, 6.6 und 6.7.

So funktioniert es

Das Widget erscheint auf der Produktseite unter dem Kaufen-Button. Der Kunde lädt ein Foto hoch (oder nimmt eines mit der Kamera auf dem Smartphone auf). Das Foto wird im Browser verkleinert und an Ihren Server gesendet. Der Server ruft das Produktbild ab, ruft die Google Vertex AI-API (Modell virtual-try-on-001) auf und gibt die erzeugte Vorschau zurück.

Google-Cloud-Voraussetzungen

Das Modul basiert auf Vertex AI. Eine einmalige Einrichtung in Google Cloud ist erforderlich.

1. Projekt erstellen und Abrechnung aktivieren

• Erstellen oder wählen Sie ein Projekt in der Google-Cloud-Konsole.
• Aktivieren Sie die Abrechnung für das Projekt (für Vertex AI erforderlich).

2. Die Vertex-AI-API aktivieren

Aktivieren Sie die Vertex-AI-API (aiplatform.googleapis.com) für das Projekt.

3. Ein Dienstkonto erstellen

• Erstellen Sie ein Dienstkonto.
• Weisen Sie ihm die Rolle Vertex AI User (roles/aiplatform.user) zu.
• Erstellen Sie einen JSON-Schlüssel und laden Sie ihn herunter.

Installation

Installieren Sie das Modul wie jede Shopware-Erweiterung (ZIP unter Erweiterungen und dann Meine Erweiterungen hochladen oder den Ordner in custom/plugins/DfVirtualTryOn ablegen), anschließend über die Kommandozeile:

bin/console plugin:refresh
bin/console plugin:install --activate DfVirtualTryOn
bin/console cache:clear

Konfiguration

Öffnen Sie in der Shopware-Administration die Modulkonfiguration und tragen Sie ein:

• Google-Cloud-Projekt-ID: die Kennung Ihres Projekts.
• Region: eine Region, in der das Modell verfügbar ist (standardmäßig us-central1).
• Modell: virtual-try-on-001 (empfohlen).
• JSON-Schlüssel des Dienstkontos: fügen Sie die vollständige heruntergeladene JSON-Datei ein.
• Anzahl der Bilder: 1 bis 4 Vorschauen pro Anprobe.
• Einwilligung verlangen: standardmäßig aktiviert, empfohlen.
• URL der Datenschutzerklärung: wird im Einwilligungshinweis angezeigt.
• Button-Beschriftung: optional, ersetzt den übersetzten Standardtext.

Datenschutz und DSGVO

Kundenfotos sind personenbezogene Daten. Dieses Modul sendet das Foto ausschließlich an Google Vertex AI, um die Vorschau zu erzeugen, speichert weder das Foto noch das Ergebnis auf Ihrem Server, kann vor jeder Generierung eine ausdrückliche Einwilligung verlangen und ermöglicht die Verlinkung Ihrer Datenschutzerklärung im Einwilligungshinweis.

Sie bleiben Verantwortlicher. Aktualisieren Sie Ihre Datenschutzerklärung mit dem Hinweis, dass Anprobebilder von Google Cloud verarbeitet werden.

Kosten

Vertex AI berechnet jedes erzeugte Bild (Imagen-Preise). Diese Kosten liegen bei Google Cloud, unabhängig vom Preis des Moduls. Stellen Sie die Anzahl der Bilder auf 1, um die Kosten zu steuern.

Tipps für gute Ergebnisse

• Verwenden Sie ein klares, gut ausgeleuchtetes Ganzkörperfoto.
• Bevorzugen Sie saubere Produktbilder (flach liegend oder am Model).
• Oberteile, Unterteile und einteilige Kleidungsstücke wie Kleider liefern die besten Ergebnisse.

Fehlerbehebung

• Nicht autorisiert: Dem Dienstkonto fehlt die Rolle Vertex AI User oder der Schlüssel ist falsch.
• Modell in der Region nicht gefunden: Die Region bietet das Modell nicht an. Verwenden Sie us-central1.
• Nicht konfiguriert: Die Projekt-ID oder der JSON-Schlüssel ist leer.
• Ratenbegrenzung: Vertex-AI-Kontingent überschritten. Versuchen Sie es später erneut oder beantragen Sie eine Kontingenterhöhung.