# 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… - Pagina: - Lingua: it - Aggiornato il: 2026-07-09 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfgoogletryon/index.md), [en](https://www.datafirefly.com/en/documentation/dfgoogletryon/index.md), [es](https://www.datafirefly.com/es/documentation/dfgoogletryon/index.md), [de](https://www.datafirefly.com/de/documentation/dfgoogletryon/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfgoogletryon/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfgoogletryon/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfgoogletryon/index.md) - Indice: ## 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. dfgoogletryon si basa esclusivamente su Vertex AI. È un servizio generativo **a pagamento per immagine**: ogni prova genera una o più immagini fatturate da Google. ## 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](https://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. Questa chiave JSON dà accesso a Vertex AI a tuo nome. Non pubblicarla mai e non caricarla in un repository pubblico. Il modulo la conserva lato server e non la espone mai al front-office. ## 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. Il token OAuth viene mantenuto in cache circa 55 minuti per non rigenerarlo a ogni prova. Ogni modifica delle credenziali svuota automaticamente la cache. ## 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 La foto del cliente viene elaborata in memoria e inviata a Google per la generazione, ma **non** viene mai salvata nel filesystem né nel database del negozio. La casella di consenso, obbligatoria e personalizzabile, appare prima di ogni invio. Adatta il testo di consenso alla tua informativa sulla privacy e menziona il trasferimento a Google. ## 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**. Un token per prodotto e la verifica same-origin scoraggiano l'uso del proxy al di fuori delle tue pagine. Non è un'autenticazione forte, ma un limite di costo combinato con i tetti sopra. ## 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.