KI-Anprobe für WooCommerce — Dokumentation

Was das Plugin macht

DF Google Try-On fügt Ihren WooCommerce-Produktseiten eine Schaltfläche zur virtuellen Anprobe hinzu. Die Kundin lädt ein Foto hoch oder nutzt ihre Webcam, und die künstliche Intelligenz erzeugt ein Bild von ihr im Kleidungsstück. Die Vorschau erscheint in einem Fenster, ohne dass die Produktseite verlassen wird.

Voraussetzungen

• WordPress 6.2 oder neuer, WooCommerce 7.0 oder neuer
• PHP 7.4 oder neuer, mit aktivierter OpenSSL-Erweiterung
• Ein Google-Cloud-Projekt mit aktiver Abrechnung
• Die in diesem Projekt aktivierte Vertex AI API
• Ein Dienstkonto mit der Rolle Vertex AI User

Schritt 1 — Google Cloud vorbereiten

Vertex AI API aktivieren

Wählen Sie in der Google-Cloud-Konsole Ihr Projekt aus, öffnen Sie die API-Bibliothek und aktivieren Sie Vertex AI API. Prüfen Sie, ob die Abrechnung im Projekt aktiv ist: Ohne sie schlagen alle Aufrufe fehl.

Dienstkonto anlegen

1. Öffnen Sie IAM und Verwaltung, dann Dienstkonten.
2. Legen Sie ein Dienstkonto an (der Name spielt keine Rolle, zum Beispiel woocommerce-tryon).
3. Weisen Sie ihm die Rolle Vertex AI User zu. Vergeben Sie keine weitergehende Rolle als nötig.
4. Erstellen Sie im Reiter Schlüssel einen Schlüssel vom Typ JSON und laden Sie die Datei herunter.

Region wählen

Das Modell muss in der angegebenen Region verfügbar sein. Der Standardwert us-central1 ist die sicherste Wahl. Wenn Sie eine europäische Region möchten, prüfen Sie vorher die regionale Verfügbarkeit des Virtual-Try-On-Modells in der Google-Dokumentation, denn die Abdeckung ändert sich.

Schritt 2 — Plugin installieren

1. Gehen Sie in WordPress zu Plugins, Installieren, Plugin hochladen.
2. Wählen Sie die mitgelieferte ZIP-Datei, installieren und aktivieren Sie sie.
3. Ein neues Menü erscheint: WooCommerce, Google Try-On.

Schritt 3 — Konfigurieren

Alle Einstellungen finden sich unter WooCommerce, Google Try-On.

Verbindung zu Google

• GCP-Projekt-ID: die Projekt-ID, nicht der Anzeigename.
• Region: zum Beispiel us-central1.
• Dienstkonto-JSON: fügen Sie den vollständigen Inhalt der heruntergeladenen Datei ein. Das Plugin prüft das JSON beim Speichern und weist einen fehlerhaften Schlüssel zurück.

Beim Speichern wird der Zwischenspeicher des Zugriffstokens automatisch geleert, eine Änderung der Zugangsdaten wirkt also sofort.

Anzeige

• Anprobe aktivieren: der Hauptschalter. Solange er nicht gesetzt ist, erscheint im Shop nichts.
• Beschriftung der Schaltfläche: der Text auf der Produktseite.
• Zulässige Kategorien: beschränkt das Widget auf bestimmte Kategorien. Leer lassen, um alle Produkte zuzulassen.

Sicherheit und Kosten

• Sicherheitsfilter: die Filterstufe, die Google auf Bilder anwendet. In einem öffentlichen Shop wird die strengste Einstellung empfohlen.
• Wasserzeichen: fügt erzeugten Bildern das SynthID-Wasserzeichen von Google hinzu. Empfohlen, um kenntlich zu machen, dass es sich um ein synthetisches Bild handelt.
• Monatslimit: die Höchstzahl erfolgreicher Anproben pro Kalendermonat. 0 bedeutet kein Limit, bedenken Sie aber, dass jede Generierung berechnet wird.
• Einwilligungstext: die Meldung neben dem Pflicht-Kontrollkästchen.

Der Zähler des laufenden Monats steht oben auf der Einstellungsseite.

Schritt 4 — Anzeige je Produkt steuern

In einem Produkt bietet im Reiter Allgemein der Produktdaten die Einstellung Virtuelle Anprobe drei Werte:

• Auto: folgt den global konfigurierten Kategorien.
• Immer anzeigen: erzwingt die Anzeige, auch außerhalb zulässiger Kategorien.
• Nie anzeigen: blendet das Widget unabhängig von der globalen Konfiguration aus.

Wie es technisch funktioniert

Eine Anprobe läuft so ab:

1. Die Kundin öffnet das Fenster und liefert ein Foto, per Upload oder Webcam-Aufnahme. Das Bild wird im Browser an seiner längsten Seite skaliert, bevor irgendetwas gesendet wird.
2. Sie setzt das Pflicht-Einwilligungshäkchen: ohne dieses weist der Server die Anfrage zurück.
3. Der Server prüft das Sicherheitstoken, das Produkt, die Drosselung je IP-Adresse und das Monatslimit.
4. Das Plugin signiert ein JWT mit RS256 anhand des privaten Schlüssels des Dienstkontos, tauscht es gegen ein OAuth2-Zugriffstoken und legt dieses bis kurz vor Ablauf im Zwischenspeicher ab.
5. Foto und Produktbild gehen an das Vertex-AI-Modell, das das erzeugte Bild zurückgibt.
6. Das Bild wird an den Browser zurückgegeben und im Fenster angezeigt.

Das Bild des Kleidungsstücks liefert nie der Browser: Es wird immer serverseitig aus dem Produkt gelesen. Das verhindert, dass ein Besucher den Dienst zweckentfremdet, um ein beliebiges Bild anzuprobieren.

Personenbezogene Daten und DSGVO

Das Foto der Kundin ist ein personenbezogenes Datum. Das Plugin ist entsprechend ausgelegt:

• Das Foto wird nie auf Ihrem Server gespeichert, weder in der Mediathek noch in der Datenbank. Es liegt nur während des Aufrufs im Arbeitsspeicher.
• Das erzeugte Bild geht direkt an den Browser zurück und wird ebenfalls nicht gespeichert.
• Vor jeder Verarbeitung muss ein ausdrückliches Einwilligungshäkchen gesetzt werden, dessen Text Sie selbst formulieren.
• Das Foto wird an Google übermittelt, das als Auftragsverarbeiter handelt. Erwähnen Sie diese Übermittlung in Ihrer Datenschutzerklärung, mit Zweck und Empfänger.

Kosten im Griff behalten

Jede erfolgreiche Anprobe entspricht einer von Google berechneten Bildgenerierung. Drei Schutzmechanismen sind eingebaut:

• Das Monatslimit, das nach Erreichen neue Generierungen blockiert.
• Eine Drosselung je IP-Adresse, die Aufrufe in schneller Folge verhindert.
• Die ausschließliche Nutzung des serverseitigen Produktbilds, die eine Zweckentfremdung des Dienstes ausschließt.

Der Zähler wird zu Beginn jedes Kalendermonats automatisch zurückgesetzt. Beobachten Sie parallel das Budget in der Google-Cloud-Konsole, wo Sie Abrechnungswarnungen einrichten können.

Fehlerbehebung

Die Schaltfläche erscheint nicht

Prüfen Sie der Reihe nach: Der Hauptschalter ist aktiviert, Projekt-ID und JSON sind ausgefüllt, das Produkt gehört zu einer zulässigen Kategorie oder steht auf Immer anzeigen, und das Produkt hat tatsächlich ein Hauptbild.

Fehlermeldung bei der Authentifizierung

Der JSON-Schlüssel ist ungültig oder unvollständig, oder dem Dienstkonto fehlt die Rolle Vertex AI User. Fügen Sie die vollständige Datei erneut ein und prüfen Sie die Rolle in der Google-Cloud-Konsole. Prüfen Sie außerdem, ob die OpenSSL-Erweiterung bei Ihrem Hoster verfügbar ist.

Kein Bild erzeugt

Das Modell kann ein Foto ablehnen, das zu dunkel oder unscharf ist, nur das Gesicht zeigt oder mehrere Personen enthält. Bitten Sie um ein scharfes, gut ausgeleuchtetes Foto, möglichst in Ganzkörperansicht und frontal. Auch ein sehr strenger Sicherheitsfilter kann Bilder blockieren.

Fehler zu Region oder nicht gefundenem Modell

Das Modell ist in der eingetragenen Region nicht verfügbar. Kehren Sie zu us-central1 zurück und prüfen Sie die regionale Verfügbarkeit des Modells in der Google-Dokumentation.

Der Dienst meldet, ausgelastet zu sein

Das Monatslimit ist erreicht. Erhöhen Sie es in den Einstellungen oder warten Sie auf den nächsten Monat. Der Zähler des laufenden Monats steht oben auf der Einstellungsseite.

Häufige Fragen

Wird Composer benötigt?

Nein. Das Plugin nutzt einen nativen Autoloader und signiert die Google-Authentifizierung in reinem PHP über OpenSSL.

Ist das Plugin HPOS-kompatibel?

Ja, die Kompatibilität mit der leistungsstarken Bestellspeicherung ist deklariert.

Funktioniert es auf dem Smartphone?

Ja. Die Aufnahme nutzt die Frontkamera, sofern der Browser dies zulässt, und der Foto-Upload steht immer zur Verfügung.

Lässt sich anderes als Kleidung anprobieren?

Das Modell ist auf getragene Kleidungsstücke trainiert. Ergebnisse bei Accessoires, Schuhen oder Gegenständen sind deutlich unzuverlässiger. Beschränken Sie das Widget auf Ihre Bekleidungskategorien.

Was passiert bei der Deinstallation?

Die Deinstallation entfernt die Einstellungen, das zwischengespeicherte Token und die Monatszähler. Die Einstellung je Produkt bleibt erhalten, damit bei einer Neuinstallation nichts verloren geht.