Camerino virtuale IA per WooCommerce — Documentazione

Che cosa fa il plugin

DF Google Try-On aggiunge un pulsante di prova virtuale alle schede prodotto di WooCommerce. La cliente carica una foto o usa la webcam, e l’intelligenza artificiale genera un’immagine di lei con il capo addosso. L’anteprima appare in una finestra modale, senza mai lasciare la scheda prodotto.

Requisiti

• WordPress 6.2 o successivo, WooCommerce 7.0 o successivo
• PHP 7.4 o successivo, con l’estensione OpenSSL attiva
• Un progetto Google Cloud con la fatturazione attiva
• L’API Vertex AI attivata su quel progetto
• Un account di servizio con il ruolo Vertex AI User

Passo 1 — Preparare Google Cloud

Attivare l’API Vertex AI

Nella console Google Cloud seleziona il progetto, apri la libreria delle API e attiva Vertex AI API. Verifica che la fatturazione sia attiva sul progetto: senza di essa tutte le chiamate falliranno.

Creare l’account di servizio

1. Apri IAM e amministrazione, poi Account di servizio.
2. Crea un account di servizio (il nome non conta, ad esempio woocommerce-tryon).
3. Assegnagli il ruolo Vertex AI User. Non concedere un ruolo più ampio del necessario.
4. Nella scheda Chiavi, crea una chiave di tipo JSON e scarica il file.

Scegliere una regione

Il modello deve essere disponibile nella regione che indichi. Il valore predefinito us-central1 è il più sicuro. Se preferisci una regione europea, verifica prima la disponibilità regionale del modello Virtual Try-On nella documentazione di Google, perché la copertura cambia nel tempo.

Passo 2 — Installare il plugin

1. In WordPress vai su Plugin, Aggiungi nuovo, Carica plugin.
2. Seleziona il file ZIP fornito, quindi installa e attiva.
3. Compare un nuovo menu: WooCommerce, Google Try-On.

Passo 3 — Configurare

Tutte le impostazioni si trovano in WooCommerce, Google Try-On.

Connessione a Google

• ID progetto GCP: l’identificativo del progetto, non il nome visualizzato.
• Regione: ad esempio us-central1.
• JSON dell’account di servizio: incolla l’intero contenuto del file scaricato. Il plugin convalida il JSON al salvataggio e rifiuta una chiave malformata.

Al salvataggio la cache del token di accesso viene svuotata automaticamente, quindi una modifica delle credenziali ha effetto immediato.

Visualizzazione

• Attivare la prova: interruttore generale. Finché non è selezionato, nel negozio non compare nulla.
• Etichetta del pulsante: il testo mostrato nella scheda prodotto.
• Categorie ammesse: limita il widget ad alcune categorie. Lascia vuoto per consentire tutti i prodotti.

Sicurezza e costi

• Filtro di sicurezza: il livello di filtraggio applicato da Google alle immagini. Su un negozio pubblico è consigliata l’impostazione più severa.
• Filigrana: aggiunge la filigrana SynthID di Google alle immagini generate. Consigliata, per segnalare che si tratta di un’immagine sintetica.
• Tetto mensile: numero massimo di prove riuscite per mese solare. Imposta 0 per non porre limiti, ma ricorda che ogni generazione è fatturata.
• Testo di consenso: il messaggio mostrato accanto alla casella obbligatoria.

Il contatore del mese in corso è visibile in cima alla pagina delle impostazioni.

Passo 4 — Controllare la visualizzazione prodotto per prodotto

In una scheda prodotto, nella scheda Generale dei dati prodotto, l’impostazione Prova virtuale offre tre valori:

• Auto: segue le categorie configurate a livello globale.
• Mostra sempre: forza la visualizzazione, anche fuori dalle categorie ammesse.
• Non mostrare mai: nasconde il widget, qualunque sia la configurazione globale.

Come funziona sotto il cofano

Il percorso di una prova è il seguente:

1. La cliente apre la finestra e fornisce una foto, tramite caricamento o scatto dalla webcam. L’immagine viene ridimensionata nel browser, sul lato più lungo, prima di qualsiasi invio.
2. Spunta la casella di consenso, obbligatoria: senza di essa il server rifiuta la richiesta.
3. Il server verifica il token di sicurezza, il prodotto, la limitazione per indirizzo IP e il tetto mensile.
4. Il plugin firma un JWT in RS256 con la chiave privata dell’account di servizio, lo scambia con un token di accesso OAuth2 e lo mette in cache fino a poco prima della scadenza.
5. La foto e l’immagine del prodotto vengono inviate al modello Vertex AI, che restituisce l’immagine generata.
6. L’immagine torna al browser e viene mostrata nella finestra.

L’immagine del capo non è mai fornita dal browser: viene sempre letta lato server dalla scheda prodotto. Questo impedisce a un visitatore di dirottare il servizio per provare un’immagine arbitraria.

Dati personali e GDPR

La foto della cliente è un dato personale. Il plugin è progettato di conseguenza:

• La foto non viene mai salvata sul tuo server, né nella libreria media né nel database. Transita in memoria per la durata della chiamata.
• L’immagine generata torna direttamente al browser e non viene neppure essa memorizzata.
• Prima di qualsiasi trattamento va spuntata una casella di consenso esplicito, di cui scrivi tu il testo.
• La foto è trasmessa a Google, che agisce come responsabile del trattamento. Indica questo trasferimento nella tua informativa privacy, precisando finalità e destinatario.

Tenere sotto controllo i costi

Ogni prova riuscita corrisponde a una generazione di immagine fatturata da Google. Sono integrate tre protezioni:

• Il tetto mensile, che blocca nuove generazioni una volta raggiunto.
• Una limitazione per indirizzo IP, che impedisce chiamate a raffica.
• L’uso esclusivo dell’immagine prodotto lato server, che esclude ogni uso improprio del servizio.

Il contatore si azzera automaticamente all’inizio di ogni mese solare. In parallelo, tieni d’occhio il budget nella console Google Cloud, dove puoi impostare avvisi di fatturazione.

Risoluzione dei problemi

Il pulsante non compare

Verifica nell’ordine: l’interruttore generale è attivo, l’ID progetto e il JSON sono compilati, il prodotto appartiene a una categoria ammessa o è forzato su Mostra sempre, e il prodotto ha davvero un’immagine principale.

Messaggio di errore di autenticazione

La chiave JSON è non valida o incompleta, oppure all’account di servizio manca il ruolo Vertex AI User. Incolla di nuovo il file completo e verifica il ruolo nella console Google Cloud. Controlla anche che l’estensione OpenSSL sia disponibile sul tuo hosting.

Nessuna immagine generata

Il modello può rifiutare una foto troppo scura, sfocata, inquadrata sul volto o con più persone. Chiedi una foto nitida, ben illuminata, preferibilmente a figura intera e frontale. Anche un filtro di sicurezza molto severo può bloccare alcune immagini.

Errore di regione o modello non trovato

Il modello non è disponibile nella regione indicata. Torna a us-central1 e verifica la disponibilità regionale del modello nella documentazione di Google.

Il servizio segnala di essere al limite

Il tetto mensile è stato raggiunto. Aumentalo nelle impostazioni oppure attendi il mese successivo. Il contatore del mese in corso è in cima alla pagina delle impostazioni.

Domande frequenti

Serve Composer?

No. Il plugin usa un autoloader nativo e firma l’autenticazione Google in PHP puro, tramite OpenSSL.

Il plugin è compatibile con HPOS?

Sì, la compatibilità con l’archiviazione ordini ad alte prestazioni è dichiarata.

Funziona su mobile?

Sì. Lo scatto usa la fotocamera frontale quando il browser lo consente, e il caricamento della foto resta sempre disponibile.

Si può provare qualcosa che non sia abbigliamento?

Il modello è addestrato sui capi indossati. I risultati su accessori, calzature od oggetti sono molto meno affidabili. Limita il widget alle tue categorie di abbigliamento.

Che cosa succede se disinstallo il plugin?

La disinstallazione rimuove le impostazioni, il token in cache e i contatori mensili. L’impostazione per prodotto viene conservata, così non si perde nulla in caso di reinstallazione.