AI Size & Fit Advisor — Guida completa

AI Size & Fit Advisor sostituisce la tua guida alle taglie statica con un vero consulente: il cliente inserisce le proprie misure nella scheda prodotto e ottiene la taglia che calza meglio, con un indice di confidenza, un’alternativa e il dettaglio misura per misura. Questa guida copre l’installazione, la configurazione, la creazione delle guide alle taglie e il funzionamento del motore di raccomandazione.

Installazione

1. Scarica l’archivio dfsizefit.zip 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 → Size & Fit Charts.

Configurazione generale

Vai su Moduli → AI Size & Fit Advisor → Configura.

Livello IA

Il modulo funziona senza IA grazie al suo motore deterministico. Puoi attivare un livello IA opzionale per affinare la decisione in base alla morfologia e generare una spiegazione nella lingua del cliente.

• Attiva il livello IA: se disattivato, non viene effettuata alcuna chiamata esterna.
• Provider: Mistral, OpenAI o Anthropic.
• Chiave API: memorizzata lato server, mai esposta al front-office.
• Modello: ad esempio mistral-small-latest, gpt-4o-mini o claude-haiku-4-5.

Preferenza di vestibilità

Attiva questa opzione per offrire al cliente le scelte Aderente / Normale / Comoda. Il modulo applica un bias di ±3 % alle misure per orientare la taglia verso l’alto o verso il basso in base alla vestibilità desiderata.

Fit-learning

Quando è attivo, il modulo registra in modo anonimizzato i profili e le raccomandazioni in una tabella dedicata, per analizzare la pertinenza e individuare i riferimenti che vestono piccoli o grandi.

Unità e hook di visualizzazione

• Unità predefinita: centimetri o pollici.
• Hook di visualizzazione: displayProductActions (vicino al pulsante aggiungi al carrello) o displayProductAdditionalInfo (sotto le informazioni del prodotto).
• Etichetta del pulsante: lasciala vuota per usare la traduzione predefinita «Trova la mia taglia».

Creare una guida alle taglie

Apri Catalogo → Size & Fit Charts → Aggiungi.

Ambito

Ogni guida ha un ambito che determina i prodotti a cui si applica:

• Globale: si applica a tutti i prodotti (riferimento lasciato a 0).
• Categoria: inserisci l’ID della categoria.
• Prodotto: inserisci l’ID del prodotto.

La risoluzione è a cascata: il modulo cerca prima una guida a livello di prodotto, poi delle sue categorie, poi la guida globale. Viene usata la prima corrispondenza.

L’editor di griglia

L’editor visivo funziona come una tabella: una riga per taglia, una colonna per misura.

• Aggiungi una colonna di misura (torace, vita, fianchi, cavallo, lunghezza del piede, ecc.) dal selettore, poi il pulsante «Aggiungi colonna».
• Aggiungi una riga di taglia con «Aggiungi una taglia» e assegnale un nome (S, M, L, 38, 40…).
• Per ogni cella, inserisci un intervallo minimo / massimo nell’unità configurata.
• Scegli il genere (donna, uomo, unisex, bambino) e attiva la guida.

Come funziona la raccomandazione

La raccomandazione si svolge in più fasi:

1. Matching deterministico: il motore valuta ogni taglia confrontando le misure del cliente con gli intervalli della griglia (distanza dal centro di ogni intervallo, penalità se fuori intervallo), poi applica il bias di vestibilità.
2. Affinamento IA (opzionale): se il livello IA è attivo, il provider conferma o regola la taglia tenendo conto della morfologia (altezza, peso) e redige una breve spiegazione.
3. Ripiego: se l’IA fallisce, viene mantenuto il risultato deterministico.

Il cliente riceve la taglia consigliata, un indice di confidenza, una taglia alternativa e il dettaglio per misura (nell’intervallo, aderente o comoda).

Visualizzazione nel front-office

Nella scheda prodotto, un pulsante «Trova la mia taglia» apre una finestra modale. Il cliente inserisce le proprie misure, eventualmente altezza, peso e preferenza di vestibilità, poi conferma. Il risultato viene mostrato nella stessa finestra, con una barra di confidenza e la scomposizione per misura.

Fit-learning e analisi dei resi

Ogni raccomandazione può essere registrata con il suo profilo anonimizzato, il motore utilizzato e l’indice di confidenza. Lo stato di reso (tenuto, reso troppo piccolo, reso troppo grande) consente, nel tempo, di individuare i tagli problematici e di regolare le tue griglie.

Compatibilità e note tecniche

• PrestaShop 8.x e 9.x, multistore e multilingua.
• Controller di amministrazione legacy (nessun controller Symfony) per la compatibilità PS8/PS9.
• Endpoint AJAX front tramite il link del modulo; JSON renderizzato da un metodo dedicato.
• Dati del cliente memorizzati sul tuo negozio; solo la parte necessaria al calcolo viene inviata al provider IA scelto.

FAQ e risoluzione dei problemi

Il pulsante non appare nella scheda prodotto. Verifica che una guida attiva si applichi al prodotto (ambito prodotto, categoria o globale) e che l’hook di visualizzazione scelto sia innestato nel tuo tema.

La raccomandazione segnala dati mancanti. Il cliente non ha inserito alcuna misura corrispondente alle colonne della griglia. Aggiungi colonne comuni (torace, vita, fianchi) o invita il cliente a compilare più campi.

L’IA non restituisce nulla. Verifica la chiave API e il nome del modello. Il modulo ripiega comunque sul motore deterministico; nessuna raccomandazione viene persa.