# AI Size & Fit Advisor : guide complet

> AI Size & Fit Advisor recommande la bonne taille à partir de la taille et du poids du client, ou de ses mensurations au mètre ruban. Ce guide couvre l'installation,…

- Page: <https://www.datafirefly.com/documentation/ai-size-fit-advisor/>
- Langue: fr
- Mis à jour le: 2026-09-29
- Autres langues: [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), [it](https://www.datafirefly.com/it/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)
- Index: <https://www.datafirefly.com/documentation/llms.txt>

AI Size & Fit Advisor recommande la bonne taille à partir de la taille et du poids du client, ou de ses mensurations au mètre ruban. Ce guide couvre l'installation, la configuration, la création des guides de tailles, le parcours client, le suivi des retours et la couche IA optionnelle. Il documente la version 1.2.0.

## Installation et mise à jour

1. Téléchargez l'archive du module depuis votre compte DataFirefly.
2. Back-office PrestaShop, **Modules**, **Téléverser un module** : envoyez le ZIP.
3. Le module crée ses tables, enregistre ses hooks et ajoute l'onglet **Catalogue > Guides de tailles**.
4. Videz le cache dans **Paramètres avancés > Performances**.

Pour une mise à jour depuis la 1.0, installez simplement la nouvelle archive par-dessus l'ancienne. Les scripts de mise à jour créent les nouvelles tables, migrent la cible de chaque guide existant et enregistrent les nouveaux hooks.

Compatible PrestaShop 8.0 à 9.x, en PHP 7.2.5+ (PS8) et 8.1+ (PS9). Aucun override, aucune dépendance externe. Traductions incluses : français, anglais, espagnol, allemand, italien, néerlandais, polonais, portugais.

## Configuration

Ouvrez **Modules > AI Size & Fit Advisor > Configurer**. La page présente le panneau de performance, puis deux blocs de réglages.

### Panneau de performance

Il résume les 30 derniers jours : nombre de recommandations et de clients, commandes passées après une recommandation, part des commandes dans la taille conseillée, taux de retour dans la taille conseillée et dans une autre taille, part des recommandations faites à partir de la taille et du poids seuls, part des réponses de l'IA et produits les plus consultés.

### Conseiller de taille

- **Hook d'affichage** : `displayProductActions` (près du bouton d'ajout au panier), `displayProductAdditionalInfo`, ou le hook personnalisé `displayDfSizeFit` à placer où vous voulez dans le template produit avec `{hook h='displayDfSizeFit' product=$product}`.
- **Libellé du bouton** : un libellé par langue. Laissez vide pour utiliser « Trouver ma taille ».
- **Style du bouton** : contour, plein ou lien texte. **Couleur d'accent** : appliquée au bouton, à la taille conseillée et aux choix actifs.
- **Unité de vos guides de tailles** : centimètres ou pouces. Le client peut toujours basculer entre cm/kg et in/lb dans le conseiller.
- **Demander la préférence de coupe** : ajoute le choix ajustée, classique ou ample.
- **Mémoriser le profil du client** : préremplit le conseiller et affiche « Votre taille : M » sur la fiche aux visites suivantes. Le profil est stocké dans le navigateur, et dans le compte client une fois connecté.
- **Afficher l'onglet guide des tailles** et **Bouton pour sélectionner la taille recommandée**.
- **Enregistrer les recommandations (statistiques)** : indispensable au panneau de performance et au suivi des retours.

### Couche IA

- **Activer la couche IA** : désactivée, aucun appel externe n'est effectué.
- **Fournisseur** : Mistral, OpenAI ou Anthropic. **Modèle** : par exemple `mistral-small-latest`, `gpt-4o-mini` ou `claude-haiku-4-5`.
- **Clé API** : champ masqué, stockée côté serveur. Laissez le champ vide pour conserver la clé enregistrée.
- **Appels IA par visiteur et par heure** : au-delà, le moteur déterministe répond seul. 0 supprime la limite.
- **Enregistrer et tester la connexion** : vérifie la clé et le modèle, et affiche l'erreur renvoyée par le fournisseur le cas échéant.

Si l'IA ne répond pas, dépasse le délai ou propose une taille absente du guide, sa réponse est ignorée et le moteur déterministe répond. La recommandation reste toujours disponible.

## Créer un guide des tailles

Ouvrez **Catalogue > Guides de tailles > Ajouter**.

### Partir d'un modèle

Six modèles remplissent la grille et le genre : vêtements femme (buste, taille, hanches), hauts homme (poitrine, taille), jeans homme (tour de taille), chaussures EU (longueur de pied), enfant par stature, chapeaux (tour de tête). Ajustez ensuite les valeurs à votre marque. Si votre boutique travaille en pouces, les modèles sont convertis.

### S'applique à

- **Tous les produits** : guide par défaut.
- **Catégories** : cochez une ou plusieurs catégories dans l'arbre.
- **Marques** : sélectionnez une ou plusieurs marques.
- **Produits** : recherchez les produits par nom, référence ou ID.

Quand plusieurs guides correspondent à un produit, le module retient dans l'ordre : le guide du produit, celui de sa marque, celui de sa catégorie (la catégorie par défaut d'abord, puis la plus profonde), et enfin le guide « Tous les produits ».

### Genre et coupe du modèle

- **Femme** ou **Homme** : le module estime les mensurations pour cette morphologie.
- **Tous** ou **Unisexe** : le client choisit « Femme » ou « Homme » dans le conseiller.
- **Enfant** : pas d'estimation par morphologie. Utilisez une colonne stature ou poids.

La **coupe du modèle** indique si l'article taille normalement, taille petit ou taille grand. Le moteur décale alors la recommandation d'environ 3,5 % et le client lit « Ce modèle taille petit : le conseil en tient compte ».

### La grille

- Ajoutez une colonne par mensuration : poitrine, buste, taille, hanches, largeur d'épaules, longueur de manche, entrejambe, cou, cuisse, longueur de pied, tour de tête, stature ou poids.
- Ajoutez une ligne par taille (S, M, L, 38, 40...) et saisissez une plage minimum / maximum pour chaque cellule.
- Saisissez des mensurations du corps, pas des mesures du vêtement.

Une plage dont le minimum dépasse le maximum est signalée en rouge, puis inversée à l'enregistrement. Évitez les trous entre deux tailles consécutives.

### Tester le guide

Sous la grille, le bloc **Tester ce guide** lance le vrai moteur sur la grille en cours d'édition, même avant l'enregistrement. Saisissez un genre, une taille et un poids : vous obtenez la taille conseillée, l'indice de confiance, la taille voisine et les mensurations estimées (marquées d'un astérisque).

Dans la liste des guides, l'action **Dupliquer** crée une copie désactivée, avec les mêmes cibles, pour décliner un guide par marque ou par coupe.

## Le parcours client

Sur la fiche produit, le bouton « Trouver ma taille » ouvre une fenêtre avec deux onglets, « Ma taille » et « Guide des tailles ». Sur mobile, elle s'ouvre en panneau depuis le bas de l'écran.

### Taille et poids

Parcours par défaut. Le client indique sa taille, son poids, sa morphologie (fine, moyenne ou forte) et, si le guide est mixte, s'il achète pour une femme ou un homme. Aucune mesure au mètre ruban n'est demandée.

### Mes mensurations

Le client saisit ses mensurations au mètre ruban. Une silhouette surligne la mesure en cours et affiche la consigne correspondante. La taille et le poids restent facultatifs : ils complètent les mensurations laissées vides.

### Le résultat

Le client voit la taille conseillée, l'indice de confiance, la taille voisine à envisager, une explication et le détail par mensuration (bien ajusté, ajustée ou ample, avec la mention « estimé » quand la valeur vient de la taille et du poids). Le bouton « Choisir la taille M » sélectionne la déclinaison correspondante dans la fiche. L'onglet « Guide des tailles » affiche la grille, taille conseillée surlignée, dans l'unité choisie par le client.

### Profil mémorisé

Aux visites suivantes, le bouton de la fiche affiche directement « Votre taille : M ». Le lien « Oublier mes mensurations » efface le profil du navigateur et du compte client.

## Comment la taille est calculée

1. **Estimation** : sans mesure au ruban, les tours (buste, poitrine, taille, hanches, cou, cuisse) sont estimés par régression sur l'indice de masse corporelle selon le genre, ajustés par la morphologie, et les longueurs sont proportionnelles à la taille.
2. **Correspondance** : chaque taille reçoit une note selon la distance des mensurations au centre de chaque plage, avec une pénalité hors plage. La préférence de coupe et la coupe du modèle décalent les mesures avant la comparaison.
3. **Confiance** : calculée mensuration par mensuration, puis réduite quand des valeurs sont estimées.
4. **Taille voisine** : la taille juste au-dessus ou juste au-dessous dans la grille, du côté où se situe le corps du client.
5. **IA (optionnelle)** : le fournisseur confirme ou ajuste la taille et rédige l'explication dans la langue du client.

## Stock, commandes et retours

Quand la gestion de stock est active, le module vérifie les déclinaisons dont le nom correspond aux tailles du guide. Si la taille conseillée est épuisée dans toutes les déclinaisons, le client voit « La taille M est actuellement épuisée », le bouton propose la taille voisine si elle est disponible, et la fiche affiche « Votre taille : M (épuisée) ».

À la validation d'une commande, la dernière recommandation du client (30 jours) pour chaque produit est rattachée à la commande, avec la taille réellement commandée. Les retours produits demandés par le client et les avoirs créés en back-office marquent ensuite la recommandation comme retournée. C'est ce qui alimente le taux de retour du panneau de performance.

## RGPD et données

- Les profils et les recommandations sont stockés sur votre boutique.
- Avec le module psgdpr, l'export et la suppression des données d'un client incluent son profil et ses recommandations.
- Avec la couche IA, seules les mesures utiles au calcul sont transmises au fournisseur, sans nom ni e-mail.

## FAQ et dépannage

**Le bouton n'apparaît pas sur la fiche produit.** Vérifiez qu'un guide actif s'applique au produit et que le hook choisi est présent dans votre thème. Avec `displayDfSizeFit`, ajoutez l'appel du hook dans le template produit.

**Le bouton « Choisir la taille » n'apparaît pas.** Le nom de la valeur d'attribut doit être identique à celui de la taille dans le guide (par exemple « M » des deux côtés).

**Le conseiller demande plus de mesures.** En mode « Mes mensurations », au moins une mesure correspondant aux colonnes du guide est nécessaire. En mode « Taille et poids », la taille, le poids et le genre sont requis.

**Le taux de retour reste vide.** Activez l'enregistrement des recommandations. Le taux apparaît après les premières commandes liées à une recommandation.

**L'IA ne répond pas.** Utilisez « Enregistrer et tester la connexion » pour lire l'erreur du fournisseur. Le moteur déterministe répond en attendant.