# AI Size & Fit Advisor: guida completa > AI Size & Fit Advisor consiglia la taglia giusta a partire da altezza e peso del cliente, oppure dalle sue misure prese con il metro da sarta. Questa guida copre… - Pagina: - Lingua: it - Aggiornato il: 2026-09-29 - Altre lingue: [fr](https://www.datafirefly.com/documentation/ai-size-fit-advisor/index.md), [en](https://www.datafirefly.com/en/documentation/ai-size-fit-advisor/index.md), [es](https://www.datafirefly.com/es/documentation/ai-size-fit-advisor/index.md), [de](https://www.datafirefly.com/de/documentation/ai-size-fit-advisor/index.md), [pl](https://www.datafirefly.com/pl/documentation/ai-size-fit-advisor/index.md), [nl](https://www.datafirefly.com/nl/documentation/ai-size-fit-advisor/index.md), [pt](https://www.datafirefly.com/pt/documentation/ai-size-fit-advisor/index.md) - Indice: AI Size & Fit Advisor consiglia la taglia giusta a partire da altezza e peso del cliente, oppure dalle sue misure prese con il metro da sarta. Questa guida copre installazione, configurazione, tabelle taglie, percorso del cliente, monitoraggio dei resi e livello IA opzionale. Documenta la versione 1.2.0. ## Installazione e aggiornamento 1. Scarica l'archivio del modulo dal tuo account DataFirefly. 2. Back office di PrestaShop, **Moduli**, **Carica un modulo**: invia lo ZIP. 3. Il modulo crea le sue tabelle, registra i suoi hook e aggiunge la scheda **Catalogo > Guide alle taglie**. 4. Svuota la cache in **Parametri avanzati > Prestazioni**. Per aggiornare dalla 1.0, installa il nuovo archivio sopra il precedente. Gli script di aggiornamento creano le nuove tabelle, migrano la destinazione di ogni tabella esistente e registrano i nuovi hook. Compatibile con PrestaShop da 8.0 a 9.x, PHP 7.2.5+ (PS8) e 8.1+ (PS9). Nessun override, nessuna dipendenza esterna. Traduzioni incluse: francese, inglese, spagnolo, tedesco, italiano, olandese, polacco, portoghese. ## Configurazione Apri **Moduli > AI Size & Fit Advisor > Configura**. La pagina mostra il pannello delle prestazioni e due blocchi di impostazioni. ### Pannello delle prestazioni Riassume gli ultimi 30 giorni: raccomandazioni e clienti, ordini dopo una raccomandazione, quota di ordini nella taglia consigliata, tasso di reso nella taglia consigliata e in un'altra taglia, quota di raccomandazioni fatte solo da altezza e peso, quota di risposte dell'IA e prodotti più consigliati. ### Consulente taglie - **Hook di visualizzazione**: `displayProductActions` (accanto al pulsante di aggiunta al carrello), `displayProductAdditionalInfo`, oppure l'hook personalizzato `displayDfSizeFit`, da inserire dove vuoi nel template del prodotto con `{hook h='displayDfSizeFit' product=$product}`. - **Testo del pulsante**: uno per lingua. Lascia vuoto per usare «Trova la mia taglia». - **Stile del pulsante**: con bordo, pieno o link testuale. **Colore principale**: usato per il pulsante, la taglia consigliata e le scelte attive. - **Unità delle tue tabelle taglie**: centimetri o pollici. I clienti possono comunque passare da cm/kg a in/lb nel consulente. - **Chiedi la vestibilità preferita**: aggiunge la scelta aderente, regolare o comoda. - **Memorizza il profilo del cliente**: precompila il consulente e mostra «La tua taglia: M» nella scheda alle visite successive. Salvato nel browser e, se il cliente è connesso, nel suo account. - **Mostra la scheda tabella taglie** e **Pulsante per selezionare la taglia consigliata**. - **Salva le raccomandazioni (statistiche)**: necessario per il pannello delle prestazioni e il monitoraggio dei resi. ### Livello IA - **Attiva il livello IA**: se disattivato, nessuna chiamata esterna. - **Fornitore IA**: Mistral, OpenAI o Anthropic. **Modello**: ad esempio `mistral-small-latest`, `gpt-4o-mini` o `claude-haiku-4-5`. - **Chiave API**: campo nascosto, salvata sul server. Lascia vuoto per mantenere la chiave salvata. - **Chiamate IA per visitatore all'ora**: oltre questo limite risponde solo il motore deterministico. 0 elimina il limite. - **Salva e verifica la connessione**: controlla chiave e modello e mostra l'eventuale errore del fornitore. Se l'IA non risponde, supera il tempo limite o propone una taglia assente dalla tabella, la sua risposta viene ignorata e risponde il motore deterministico. Una raccomandazione è sempre disponibile. ## Creare una tabella taglie Apri **Catalogo > Guide alle taglie > Aggiungi**. ### Parti da un modello Sei modelli compilano griglia e genere: abbigliamento donna (busto, vita, fianchi), top uomo (torace, vita), jeans uomo (vita), scarpe EU (lunghezza del piede), bambini per altezza, cappelli (circonferenza testa). Adatta poi i valori al tuo marchio. Se il negozio lavora in pollici, i modelli vengono convertiti. ### Si applica a - **Tutti i prodotti**: tabella predefinita. - **Categorie**: spunta una o più categorie nell'albero. - **Marchi**: seleziona uno o più marchi. - **Prodotti**: cerca i prodotti per nome, riferimento o ID. Quando più tabelle corrispondono a un prodotto, il modulo sceglie in quest'ordine: la tabella del prodotto, quella del suo marchio, quella della sua categoria (prima quella predefinita, poi la più profonda) e infine la tabella «Tutti i prodotti». ### Genere e vestibilità del modello - **Donna** o **Uomo**: il modulo stima le misure per quella corporatura. - **Tutti** o **Unisex**: il cliente sceglie «Donna» o «Uomo» nel consulente. - **Bambini**: nessuna stima per corporatura. Usa una colonna altezza o peso. La **vestibilità del modello** indica se l'articolo veste regolare, piccolo o grande. Il motore sposta allora la raccomandazione di circa il 3,5 % e il cliente legge «Questo modello veste piccolo: il consiglio ne tiene conto». ### La griglia - Aggiungi una colonna per misura: torace, busto, vita, fianchi, larghezza spalle, lunghezza manica, cavallo, collo, coscia, lunghezza del piede, circonferenza testa, altezza o peso. - Aggiungi una riga per taglia (S, M, L, 38, 40...) e inserisci un intervallo minimo / massimo in ogni cella. - Inserisci misure del corpo, non del capo. Un intervallo il cui minimo supera il massimo viene evidenziato in rosso e invertito al salvataggio. Evita buchi tra due taglie consecutive. ### Provare la tabella Sotto la griglia, il blocco **Prova questa tabella** esegue il motore reale sulla griglia in modifica, anche prima di salvare. Inserisci genere, altezza e peso: ottieni la taglia consigliata, l'indice di corrispondenza, la taglia vicina e le misure stimate (segnate con un asterisco). Nell'elenco delle tabelle, l'azione **Duplica** crea una copia disattivata con le stesse destinazioni, per derivare una tabella per marchio o per vestibilità. ## Il percorso del cliente Nella scheda prodotto, il pulsante «Trova la mia taglia» apre una finestra con due schede, «La mia taglia» e «Tabella taglie». Su mobile si apre come pannello dal basso dello schermo. ### Altezza e peso Percorso predefinito. Il cliente indica altezza, peso, corporatura (esile, media o robusta) e, se la tabella è unisex, se acquista per donna o per uomo. Non serve il metro da sarta. ### Le mie misure Il cliente inserisce le misure prese con il metro da sarta. Una silhouette evidenzia la misura in corso e mostra l'istruzione corrispondente. Altezza e peso restano facoltativi: completano le misure lasciate vuote. ### Il risultato Il cliente vede la taglia consigliata, l'indice di corrispondenza, la taglia vicina da valutare, una spiegazione e il dettaglio per misura (vestibilità giusta, aderente o comoda, con la dicitura «stimata» quando il valore deriva da altezza e peso). Il pulsante «Scegli la taglia M» seleziona la combinazione corrispondente nella scheda. La scheda «Tabella taglie» mostra la griglia, con la taglia consigliata evidenziata, nell'unità scelta dal cliente. ### Profilo memorizzato Alle visite successive, il pulsante della scheda mostra subito «La tua taglia: M». Il link «Dimentica le mie misure» cancella il profilo dal browser e dall'account cliente. ## Come viene calcolata la taglia 1. **Stima**: senza misure prese col metro, le circonferenze (busto, torace, vita, fianchi, collo, coscia) sono stimate con una regressione sull'indice di massa corporea in base al genere, corretta dalla corporatura, e le lunghezze sono proporzionali all'altezza. 2. **Corrispondenza**: ogni taglia riceve un punteggio in base alla distanza delle misure dal centro di ogni intervallo, con una penalità fuori intervallo. La vestibilità preferita e quella del modello spostano le misure prima del confronto. 3. **Corrispondenza finale**: calcolata misura per misura e ridotta quando ci sono valori stimati. 4. **Taglia vicina**: la taglia appena sopra o appena sotto nella griglia, dal lato in cui si trova il corpo del cliente. 5. **IA (opzionale)**: il fornitore conferma o corregge la taglia e scrive la spiegazione nella lingua del cliente. ## Stock, ordini e resi Con la gestione dello stock attiva, il modulo controlla le combinazioni il cui nome corrisponde alle taglie della tabella. Se la taglia consigliata è esaurita in tutte le combinazioni, il cliente vede «La taglia M è attualmente esaurita», il pulsante propone la taglia vicina se disponibile e la scheda mostra «La tua taglia: M (esaurita)». Alla convalida di un ordine, l'ultima raccomandazione del cliente (30 giorni) per ogni prodotto viene collegata all'ordine, con la taglia effettivamente ordinata. I resi merce richiesti dal cliente e le note di credito create nel back office segnano poi la raccomandazione come resa. Questo alimenta il tasso di reso del pannello delle prestazioni. ## GDPR e dati - Profili e raccomandazioni sono salvati nel tuo negozio. - Con il modulo psgdpr, esportazione e cancellazione dei dati di un cliente includono profilo e raccomandazioni. - Con il livello IA, al fornitore vengono inviate solo le misure utili al calcolo, senza nome né e-mail. ## FAQ e risoluzione dei problemi **Il pulsante non appare nella scheda prodotto.** Verifica che una tabella attiva si applichi al prodotto e che l'hook scelto sia presente nel tuo tema. Con `displayDfSizeFit`, aggiungi la chiamata all'hook nel template del prodotto. **Il pulsante «Scegli la taglia» non appare.** Il nome del valore dell'attributo deve coincidere con quello della taglia nella tabella (ad esempio «M» da entrambe le parti). **Il consulente chiede altre misure.** In modalità «Le mie misure» serve almeno una misura corrispondente alle colonne della tabella. In modalità «Altezza e peso» sono richiesti altezza, peso e genere. **Il tasso di reso resta vuoto.** Attiva «Salva le raccomandazioni». Il tasso compare dopo i primi ordini collegati a una raccomandazione. **L'IA non risponde.** Usa «Salva e verifica la connessione» per leggere l'errore del fornitore. Nel frattempo risponde il motore deterministico.