Essayage Virtuel IA pour Shopware 6 — Guide
Installer et configurer le module d'essayage virtuel IA pour Shopware 6 : Google Cloud, Vertex AI, RGPD et dépannage.
Ce module ajoute un widget d’essayage virtuel sur les fiches produit Shopware 6. Le client ajoute une photo de lui et l’IA de Google Vertex AI génère un aperçu du vêtement porté. Compatible Shopware 6.5, 6.6 et 6.7.
Comment ça fonctionne
Le widget s’affiche sur la fiche produit, sous le bouton d’achat. Le client téléverse une photo (ou la prend avec la caméra sur mobile). La photo est réduite côté navigateur puis envoyée à votre serveur. Le serveur récupère l’image du produit, appelle l’API Google Vertex AI (modèle virtual-try-on-001) et renvoie l’aperçu généré.
Il s’agit d’un rendu génératif, pas d’un essayage en réalité augmentée en temps réel. Chaque aperçu est un appel API qui renvoie une image en quelques secondes.
Prérequis Google Cloud
Le module s’appuie sur Vertex AI. Une configuration unique côté Google Cloud est nécessaire.
1. Créer un projet et activer la facturation
- Créez ou sélectionnez un projet dans la console Google Cloud.
- Activez la facturation sur le projet, obligatoire pour Vertex AI.
2. Activer l’API Vertex AI
Activez l’API Vertex AI (aiplatform.googleapis.com) pour le projet.
3. Créer un compte de service
- Créez un compte de service.
- Attribuez-lui le rôle Vertex AI User (roles/aiplatform.user).
- Créez une clé JSON pour ce compte et téléchargez-la.
Installation
Installez le module comme toute extension Shopware (téléversement du ZIP dans Extensions puis Mes extensions, ou dépôt du dossier dans custom/plugins/DfVirtualTryOn), puis en ligne de commande :
bin/console plugin:refresh
bin/console plugin:install --activate DfVirtualTryOn
bin/console cache:clearAucune compilation du storefront n’est nécessaire : le widget est autonome, styles et JavaScript inclus.
Configuration
Dans l’administration Shopware, ouvrez la configuration du module et renseignez :
- ID du projet Google Cloud : l’identifiant de votre projet.
- Région : une région où le modèle est disponible (us-central1 par défaut).
- Modèle : virtual-try-on-001 (recommandé).
- Clé JSON du compte de service : collez l’intégralité du fichier JSON téléchargé.
- Nombre d’images : de 1 à 4 aperçus par essayage.
- Exiger le consentement : activé par défaut, recommandé.
- URL de politique de confidentialité : affichée dans la case de consentement.
- Libellé du bouton : optionnel, remplace le texte traduit par défaut.
La région est importante : le modèle n’est pas disponible partout. Si vous choisissez une région qui ne l’héberge pas, les appels échouent avec une erreur « modèle introuvable ». En cas de doute, utilisez us-central1.
Confidentialité et RGPD
Les photos des clients sont des données personnelles. Ce module envoie la photo uniquement à Google Vertex AI pour générer l’aperçu, ne conserve ni la photo ni le résultat sur votre serveur, peut exiger un consentement explicite avant chaque génération, et permet de lier votre politique de confidentialité dans la case de consentement.
Vous restez responsable de traitement. Pensez à mettre à jour votre politique de confidentialité pour indiquer que les images d’essayage sont traitées par Google Cloud.
Coûts
Vertex AI facture chaque image générée (tarification Imagen). Ces frais sont côté Google Cloud, indépendants du prix du module. Réglez le nombre d’images sur 1 pour maîtriser le coût.
Conseils pour de bons résultats
- Utilisez une photo nette, bien éclairée, en pied.
- Privilégiez des images produit claires (à plat ou sur mannequin).
- Les hauts, les bas et les pièces uniques comme les robes donnent les meilleurs résultats.
Dépannage
- Non autorisé : le compte de service n’a pas le rôle Vertex AI User, ou la clé est incorrecte.
- Modèle introuvable dans la région : la région ne propose pas le modèle. Utilisez us-central1.
- Non configuré : l’ID du projet ou la clé JSON est vide.
- Limite de débit atteinte : quota Vertex AI dépassé. Réessayez plus tard ou demandez une augmentation de quota.