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 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.

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.

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.

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.