Virtueel passen met AI voor Shopware 6: gids

Deze module voegt een widget voor virtueel passen toe aan de productpagina’s van Shopware 6. De klant voegt een foto van zichzelf toe en de AI van Google Vertex AI genereert een voorbeeld met het kledingstuk aan. Compatibel met Shopware 6.5, 6.6 en 6.7.

Hoe het werkt

De widget verschijnt op de productpagina, onder de koopknop. De klant uploadt een foto (of maakt er een met de camera op mobiel). De foto wordt in de browser verkleind en daarna naar uw server gestuurd. De server haalt de productafbeelding op, roept de API van Google Vertex AI aan (model virtual-try-on-001) en stuurt het gegenereerde voorbeeld terug.

Vereisten aan de kant van Google Cloud

De module steunt op Vertex AI. Een eenmalige configuratie aan de kant van Google Cloud is nodig.

1. Een project aanmaken en facturatie activeren

• Maak een project aan of selecteer er een in de Google Cloud-console.
• Activeer de facturatie op het project, wat verplicht is voor Vertex AI.

2. De Vertex AI API activeren

Activeer de Vertex AI API (aiplatform.googleapis.com) voor het project.

3. Een serviceaccount aanmaken

• Maak een serviceaccount aan.
• Ken het de rol Vertex AI User toe (roles/aiplatform.user).
• Maak een JSON-sleutel voor dat account aan en download die.

Installatie

Installeer de module zoals elke Shopware-extensie (upload van de ZIP via Extensies en daarna Mijn extensies, of de map plaatsen in custom/plugins/DfVirtualTryOn) en voer daarna op de commandoregel uit:

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

Configuratie

Open in de Shopware-administration de configuratie van de module en vul in:

• Google Cloud project-ID: de identificatie van uw project.
• Regio: een regio waar het model beschikbaar is (standaard us-central1).
• Model: virtual-try-on-001 (aanbevolen).
• JSON-sleutel van het serviceaccount: plak het volledige gedownloade JSON-bestand.
• Aantal afbeeldingen: 1 tot 4 voorbeelden per pasbeurt.
• Toestemming vereisen: standaard ingeschakeld, aanbevolen.
• URL van de privacyverklaring: getoond in het toestemmingsvakje.
• Label van de knop: optioneel, vervangt de standaard vertaalde tekst.

Privacy en AVG

Foto’s van klanten zijn persoonsgegevens. Deze module stuurt de foto uitsluitend naar Google Vertex AI om het voorbeeld te genereren, bewaart noch de foto noch het resultaat op uw server, kan vóór elke generatie een expliciete toestemming eisen, en maakt het mogelijk uw privacyverklaring in het toestemmingsvakje te koppelen.

U blijft verwerkingsverantwoordelijke. Denk eraan uw privacyverklaring bij te werken om aan te geven dat de pasafbeeldingen door Google Cloud worden verwerkt.

Kosten

Vertex AI factureert elke gegenereerde afbeelding (tarifering van Imagen). Die kosten vallen aan de kant van Google Cloud en staan los van de prijs van de module. Zet het aantal afbeeldingen op 1 om de kosten te beheersen.

Tips voor goede resultaten

• Gebruik een scherpe, goed belichte foto ten voeten uit.
• Kies duidelijke productafbeeldingen (plat gelegd of op een paspop).
• Bovenstukken, onderstukken en losse items zoals jurken geven de beste resultaten.

Probleemoplossing

• Niet toegestaan: het serviceaccount heeft de rol Vertex AI User niet, of de sleutel klopt niet.
• Model niet gevonden in de regio: de regio biedt het model niet aan. Gebruik us-central1.
• Niet geconfigureerd: het project-ID of de JSON-sleutel is leeg.
• Snelheidslimiet bereikt: het quotum van Vertex AI is overschreden. Probeer het later opnieuw of vraag een verhoging van het quotum aan.