dfgoogletryon — Modulo camerino virtuale IA (Google Vertex AI)

Panoramica

dfgoogletryon aggiunge un widget di camerino virtuale alle tue schede prodotto PrestaShop 8 e 9. Il cliente carica una foto (o usa la fotocamera) e si vede con il capo della scheda indosso, grazie al modello generativo Google Vertex AI Virtual Try-On. Ogni chiamata a Google è gestita lato server: la chiave dell’account di servizio non raggiunge mai il browser. Il modulo include il consenso GDPR, il non salvataggio delle foto, il watermark SynthID e limiti di costo.

In cosa è diverso dal try-on di Google Shopping?

Google offre due cose distinte da non confondere:

• Il camerino per l’abbigliamento del Merchant Center — un badge che appare solo sulla ricerca di Google e su Google Shopping. Non è integrabile sul tuo negozio e non offre API per la tua scheda prodotto.
• Vertex AI Virtual Try-On — l’API generativa che questo modulo usa. È l’unico mattone che consente un widget di camerino direttamente sulle tue schede prodotto.

Requisiti

• PrestaShop 8.0 a 9.x
• PHP 8.1, 8.2, 8.3 o 8.4
• Estensioni PHP: curl, openssl, gd
• Un progetto Google Cloud con fatturazione attiva
• L’API Vertex AI attivata su quel progetto
• Un account di servizio con il ruolo Utente Vertex AI e la sua chiave JSON

Passo 1 — Preparare Google Cloud

1. Apri console.cloud.google.com e crea (o seleziona) un progetto. Annota il suo ID progetto.
2. Attiva la fatturazione sul progetto (menu Fatturazione).
3. Attiva l’API Vertex AI: cerca “Vertex AI API” (aiplatform.googleapis.com) nella libreria API e clicca su Attiva.

Passo 2 — Creare l’account di servizio

1. Vai su IAM e amministrazione > Account di servizio.
2. Clicca su Crea account di servizio e assegnagli un nome (ad esempio tryon-prestashop).
3. Assegnagli il ruolo Utente Vertex AI (roles/aiplatform.user).
4. Una volta creato, aprilo, poi Chiavi > Aggiungi chiave > Crea nuova chiave > JSON. Il file JSON viene scaricato.

Passo 3 — Installare il modulo

1. Scarica dfgoogletryon.zip dal tuo account cliente.
2. Nel back-office di PrestaShop: Moduli > Gestione moduli > Carica un modulo.
3. Carica lo ZIP e clicca su Installa.
4. All’installazione, il modulo salva le impostazioni predefinite e un testo di consenso, poi si aggancia agli hook displayProductAdditionalInfo (pulsante sulla scheda) e actionFrontControllerSetMedia (caricamento risorse, solo pagina prodotto).

Passo 4 — Configurare il modulo

Apri la configurazione del modulo. Compila la sezione Google Cloud / Vertex AI:

• GCP Project ID — l’ID progetto annotato al Passo 1.
• Region — la località Vertex AI, ad esempio us-central1.
• Model ID — predefinito virtual-try-on-preview-08-04 (puoi anche usare virtual-try-on-001).
• Service-account JSON key — incolla il contenuto integrale del file JSON scaricato al Passo 2.

Poi clicca su Save & test authentication. Il modulo firma un JWT, ottiene un token OAuth e conferma “Authentication OK” se tutto è corretto.

Impostazioni di generazione e sicurezza

Sezione Generation & safety:

• Images per try-on — da 1 a 4 immagini generate per prova. Ogni immagine è fatturata da Google.
• SynthID watermark — aggiunge un watermark IA invisibile alle immagini generate (consigliato).
• Safety setting — livello di filtraggio (block_low_and_above, block_medium_and_above, block_only_high, block_none). block_medium_and_above di default.
• Person generation — allow_adult consigliato per un negozio di abbigliamento.
• Max generations per session — limite anti-abuso per sessione cliente.
• Cooldown between generations (seconds) — ritardo minimo tra due prove della stessa sessione.

Sezione Display:

• Enable widget — attiva o disattiva il widget globalmente.
• Restrict to category IDs — ID di categoria separati da virgole. Lascia vuoto per mostrarlo su tutti i prodotti, oppure indica le tue categorie di abbigliamento per mostrare il widget solo dove ha senso.
• Consent text (GDPR) — il testo mostrato accanto alla casella di consenso obbligatoria.

Funzionamento per il cliente

1. Su una scheda prodotto idonea, appare un pulsante Try it on.
2. Il cliente apre la finestra, carica una foto (JPEG, PNG o WebP) o cattura dalla webcam.
3. La foto viene ridimensionata nel browser (max 1024 px, JPEG) prima dell’invio, per ridurre latenza e costo.
4. Il cliente spunta la casella di consenso e clicca su Generate try-on.
5. Il modulo invia la foto e l’immagine di copertina del prodotto a Vertex AI, poi mostra la o le immagini generate.

Privacy e GDPR

Controllo dei costi

Ogni immagine generata è fatturata da Google secondo la tariffa Vertex AI per immagine. Per mantenere costi prevedibili:

• Imposta Images per try-on a 1 all’inizio.
• Stabilisci un Max generations per session ragionevole (5 di default).
• Usa un Cooldown per evitare lo spam di generazione.
• Limita la visualizzazione alle categorie di abbigliamento con Restrict to category IDs.

Buone pratiche per l’immagine prodotto

Il modulo invia l’immagine di copertina del prodotto come riferimento del capo. La qualità del camerino è molto migliore con un packshot pulito del capo (sfondo neutro, capo ben visibile) rispetto a una foto lifestyle già indossata da una modella. Capi superiori, inferiori e monopezzo (abiti) danno i risultati migliori.

Risoluzione dei problemi

• “Authentication failed” al test — verifica l’ID progetto, la validità della chiave JSON, che l’API Vertex AI sia attivata e il ruolo Utente Vertex AI dell’account di servizio.
• Nessuna immagine generata — la richiesta potrebbe essere stata filtrata dalle impostazioni di sicurezza. Prova un’altra foto o allenta Safety setting. Controlla anche il saldo di fatturazione di Google Cloud.
• Il pulsante non appare — verifica che Enable widget sia attivo e che il prodotto appartenga a una categoria consentita (campo Restrict to category IDs).
• Errore di rete / timeout — assicurati che il server consenta connessioni HTTPS in uscita verso oauth2.googleapis.com e REGION-aiplatform.googleapis.com.
• “You have reached the maximum number of try-ons” — è stato raggiunto il limite per sessione; è il comportamento previsto. Regola Max generations per session se necessario.

Disinstallazione

La disinstallazione rimuove le impostazioni del modulo, inclusa la chiave dell’account di servizio e il token in cache. Il modulo non memorizza alcuna foto del cliente, quindi non c’è altro da pulire.