dfgoogletryon — KI-Modul für virtuelle Anprobe (Google Vertex AI)

Überblick

dfgoogletryon fügt Ihren PrestaShop 8- und 9-Produktseiten ein Widget für die virtuelle Anprobe hinzu. Der Kunde lädt ein Foto hoch (oder nutzt seine Kamera) und sieht sich das Kleidungsstück der Seite angezogen, dank des generativen Modells Google Vertex AI Virtual Try-On. Jeder Aufruf an Google läuft serverseitig: der Service-Account-Schlüssel erreicht nie den Browser. Das Modul enthält DSGVO-Einwilligung, keine Fotospeicherung, das SynthID-Wasserzeichen und Kosten-Schutzmechanismen.

Worin unterscheidet es sich von der Google-Shopping-Anprobe?

Google bietet zwei verschiedene Dinge, die nicht verwechselt werden sollten:

• Die Bekleidungs-Anprobe des Merchant Center — ein Badge, das nur in der Google-Suche und bei Google Shopping erscheint. Es ist nicht in Ihrem Shop einbettbar und bietet keine API für Ihre Produktseite.
• Vertex AI Virtual Try-On — die generative API, die dieses Modul nutzt. Sie ist der einzige Baustein, der ein Anprobe-Widget direkt auf Ihren Produktseiten ermöglicht.

Voraussetzungen

• PrestaShop 8.0 bis 9.x
• PHP 8.1, 8.2, 8.3 oder 8.4
• PHP-Extensions: curl, openssl, gd
• Ein Google-Cloud-Projekt mit aktivierter Abrechnung
• Die Vertex-AI-API auf diesem Projekt aktiviert
• Ein Service-Account mit der Rolle Vertex AI User und dessen JSON-Schlüssel

Schritt 1 — Google Cloud vorbereiten

1. Öffnen Sie console.cloud.google.com und erstellen (oder wählen) Sie ein Projekt. Notieren Sie dessen Projekt-ID.
2. Aktivieren Sie die Abrechnung für das Projekt (Menü Abrechnung).
3. Aktivieren Sie die Vertex-AI-API: suchen Sie „Vertex AI API“ (aiplatform.googleapis.com) in der API-Bibliothek und klicken Sie auf Aktivieren.

Schritt 2 — Service-Account erstellen

1. Gehen Sie zu IAM & Verwaltung > Dienstkonten.
2. Klicken Sie auf Dienstkonto erstellen und geben Sie ihm einen Namen (zum Beispiel tryon-prestashop).
3. Weisen Sie ihm die Rolle Vertex AI User (roles/aiplatform.user) zu.
4. Öffnen Sie es nach der Erstellung, dann Schlüssel > Schlüssel hinzufügen > Neuen Schlüssel erstellen > JSON. Die JSON-Datei wird heruntergeladen.

Schritt 3 — Modul installieren

1. Laden Sie dfgoogletryon.zip aus Ihrem Kundenkonto herunter.
2. Im PrestaShop-Back-Office: Module > Modul-Manager > Modul hochladen.
3. Laden Sie das ZIP hoch und klicken Sie auf Installieren.
4. Bei der Installation speichert das Modul seine Standardeinstellungen und einen Einwilligungstext, dann bindet es sich in die Hooks displayProductAdditionalInfo (Button auf der Seite) und actionFrontControllerSetMedia (Asset-Laden, nur Produktseite) ein.

Schritt 4 — Modul konfigurieren

Öffnen Sie die Modulkonfiguration. Füllen Sie den Abschnitt Google Cloud / Vertex AI aus:

• GCP Project ID — die in Schritt 1 notierte Projekt-ID.
• Region — der Vertex-AI-Standort, zum Beispiel us-central1.
• Model ID — standardmäßig virtual-try-on-preview-08-04 (Sie können auch virtual-try-on-001 verwenden).
• Service-account JSON key — fügen Sie den vollständigen Inhalt der in Schritt 2 heruntergeladenen JSON-Datei ein.

Klicken Sie dann auf Save & test authentication. Das Modul signiert ein JWT, erhält ein OAuth-Token und bestätigt „Authentication OK“, wenn alles korrekt ist.

Generierungs- und Sicherheitseinstellungen

Abschnitt Generation & safety:

• Images per try-on — 1 bis 4 pro Anprobe generierte Bilder. Jedes Bild wird von Google abgerechnet.
• SynthID watermark — fügt generierten Bildern ein unsichtbares KI-Wasserzeichen hinzu (empfohlen).
• Safety setting — Filterstufe (block_low_and_above, block_medium_and_above, block_only_high, block_none). block_medium_and_above standardmäßig.
• Person generation — allow_adult für einen Bekleidungsshop empfohlen.
• Max generations per session — Missbrauchsschutz-Limit pro Kundensitzung.
• Cooldown between generations (seconds) — Mindestverzögerung zwischen zwei Anproben derselben Sitzung.

Abschnitt Display:

• Enable widget — schaltet das Widget global ein oder aus.
• Restrict to category IDs — kommagetrennte Kategorie-IDs. Leer lassen, um es bei allen Produkten anzuzeigen, oder Ihre Bekleidungskategorien angeben, um das Widget nur dort anzuzeigen, wo es sinnvoll ist.
• Consent text (GDPR) — der Text neben der obligatorischen Einwilligungs-Checkbox.

Funktionsweise für den Kunden

1. Auf einer berechtigten Produktseite erscheint ein Try it on-Button.
2. Der Kunde öffnet das Fenster, lädt ein Foto hoch (JPEG, PNG oder WebP) oder nimmt über seine Webcam auf.
3. Das Foto wird im Browser herunterskaliert (max. 1024 px, JPEG), bevor es hochgeladen wird, um Latenz und Kosten zu senken.
4. Der Kunde aktiviert die Einwilligungs-Checkbox und klickt auf Generate try-on.
5. Das Modul sendet das Foto und das Produkt-Titelbild an Vertex AI und zeigt dann die generierten Bilder an.

Datenschutz & DSGVO

Kostenkontrolle

Jedes generierte Bild wird von Google gemäß der Vertex-AI-Preisgestaltung pro Bild abgerechnet. Um Kosten vorhersehbar zu halten:

• Setzen Sie Images per try-on anfangs auf 1.
• Legen Sie ein vernünftiges Max generations per session fest (5 standardmäßig).
• Nutzen Sie einen Cooldown, um Generierungs-Spam zu verhindern.
• Beschränken Sie die Anzeige über Restrict to category IDs auf Bekleidungskategorien.

Best Practices für das Produktbild

Das Modul sendet das Titelbild des Produkts als Kleidungsstück-Referenz. Die Anprobe-Qualität ist mit einem sauberen Kleidungsstück-Packshot (neutraler Hintergrund, Kleidungsstück gut sichtbar) deutlich besser als mit einem Lifestyle-Foto, das bereits an einem Model getragen wird. Oberteile, Unterteile und Einteiler (Kleider) liefern die besten Ergebnisse.

Fehlerbehebung

• „Authentication failed“ beim Test — prüfen Sie die Projekt-ID, die Gültigkeit des JSON-Schlüssels, dass die Vertex-AI-API aktiviert ist, und die Rolle Vertex AI User des Service-Accounts.
• Kein Bild generiert — die Anfrage wurde möglicherweise von den Sicherheitseinstellungen gefiltert. Probieren Sie ein anderes Foto oder lockern Sie Safety setting. Prüfen Sie auch Ihr Google-Cloud-Abrechnungsguthaben.
• Der Button erscheint nicht — prüfen Sie, dass Enable widget aktiv ist und das Produkt zu einer erlaubten Kategorie gehört (Feld Restrict to category IDs).
• Netzwerkfehler / Timeout — stellen Sie sicher, dass der Server ausgehende HTTPS-Verbindungen zu oauth2.googleapis.com und REGION-aiplatform.googleapis.com erlaubt.
• „You have reached the maximum number of try-ons“ — das Sitzungslimit wurde erreicht; das ist das erwartete Verhalten. Passen Sie bei Bedarf Max generations per session an.

Deinstallation

Die Deinstallation entfernt die Moduleinstellungen, einschließlich des Service-Account-Schlüssels und des zwischengespeicherten Tokens. Das Modul speichert kein Kundenfoto, es gibt also nichts weiter zu bereinigen.