Camerino Virtuale IA per Shopware 6 — Guida
Installa e configura il modulo di prova virtuale con IA per Shopware 6: Google Cloud, Vertex AI, GDPR e risoluzione dei problemi.
Questo modulo aggiunge un widget di prova virtuale alle pagine prodotto di Shopware 6. Il cliente aggiunge una propria foto e Google Vertex AI genera un’anteprima del capo indosso. Compatibile con Shopware 6.5, 6.6 e 6.7.
Come funziona
Il widget compare nella pagina prodotto, sotto il pulsante di acquisto. Il cliente carica una foto (o la scatta con la fotocamera su mobile). La foto viene ridotta nel browser e inviata al tuo server. Il server recupera l’immagine del prodotto, chiama l’API di Google Vertex AI (modello virtual-try-on-001) e restituisce l’anteprima generata.
È un rendering generativo, non una prova in realtà aumentata in tempo reale. Ogni anteprima è una chiamata API che restituisce un’immagine in pochi secondi.
Prerequisiti Google Cloud
Il modulo si basa su Vertex AI. È necessaria una configurazione una tantum in Google Cloud.
1. Creare un progetto e attivare la fatturazione
- Crea o seleziona un progetto nella console di Google Cloud.
- Attiva la fatturazione sul progetto (obbligatoria per Vertex AI).
2. Attivare l’API Vertex AI
Attiva l’API Vertex AI (aiplatform.googleapis.com) per il progetto.
3. Creare un account di servizio
- Crea un account di servizio.
- Assegnagli il ruolo Vertex AI User (roles/aiplatform.user).
- Crea una chiave JSON e scaricala.
Installazione
Installa il modulo come qualsiasi estensione Shopware (carica lo ZIP in Estensioni e poi Le mie estensioni, oppure colloca la cartella in custom/plugins/DfVirtualTryOn), quindi da riga di comando:
bin/console plugin:refresh
bin/console plugin:install --activate DfVirtualTryOn
bin/console cache:clearNon serve compilare lo storefront: il widget è autonomo, con stili e JavaScript inclusi.
Configurazione
Nell’amministrazione di Shopware, apri la configurazione del modulo e compila:
- ID progetto Google Cloud: l’identificatore del tuo progetto.
- Regione: una regione in cui il modello è disponibile (us-central1 come predefinita).
- Modello: virtual-try-on-001 (consigliato).
- Chiave JSON dell’account di servizio: incolla l’intero file JSON scaricato.
- Numero di immagini: da 1 a 4 anteprime per prova.
- Richiedere il consenso: attivo per impostazione predefinita, consigliato.
- URL dell’informativa sulla privacy: mostrato nell’avviso di consenso.
- Etichetta del pulsante: opzionale, sostituisce il testo tradotto predefinito.
La regione è importante: il modello non è disponibile ovunque. Se scegli una regione che non lo ospita, le chiamate falliscono con un errore “modello non trovato”. In caso di dubbio, usa us-central1.
Privacy e GDPR
Le foto dei clienti sono dati personali. Questo modulo invia la foto solo a Google Vertex AI per generare l’anteprima, non conserva né la foto né il risultato sul tuo server, può richiedere un consenso esplicito prima di ogni generazione e permette di collegare la tua informativa sulla privacy nell’avviso di consenso.
Resti titolare del trattamento. Aggiorna la tua informativa sulla privacy per indicare che le immagini di prova sono elaborate da Google Cloud.
Costi
Vertex AI fattura ogni immagine generata (tariffe Imagen). Questi addebiti sono su Google Cloud, indipendenti dal prezzo del modulo. Imposta il numero di immagini su 1 per controllare i costi.
Consigli per buoni risultati
- Usa una foto nitida, ben illuminata, a figura intera.
- Preferisci immagini prodotto pulite (in piano o su modella).
- Capi sopra, sotto e monopezzo come gli abiti danno i risultati migliori.
Risoluzione dei problemi
- Non autorizzato: all’account di servizio manca il ruolo Vertex AI User, oppure la chiave è errata.
- Modello non trovato nella regione: la regione non offre il modello. Usa us-central1.
- Non configurato: l’ID progetto o la chiave JSON è vuoto.
- Limite di frequenza: quota Vertex AI superata. Riprova più tardi o richiedi un aumento della quota.