Guide
Attributs produit : comment les extraire, les normaliser et les mapper
Des attributs produit propres sont ce qui fait fonctionner les filtres, les comparaisons, les flux et les brouillons de conformité. Ce guide couvre le schéma, l’extraction, les règles d’unités et de vocabulaire, et le mapping vers une taxonomie qui transforment des valeurs fournisseur désordonnées en données cohérentes.
Chaque fournisseur décrit la même chose différemment. Une fiche technique indique « Capacité : 1,5 l », une autre « 1500 ml », une troisième cache « contient 1.5 litres » dans un paragraphe. Pour un acheteur, c’est un seul fait ; pour un filtre ou un flux, ce sont trois chaînes sans rapport. La normalisation des attributs produit ramène ces variantes à une seule valeur, dans une seule unité, sous un seul nom d’attribut.
Ce guide suit l’ordre dans lequel le travail se déroule en pratique : schéma, extraction, normalisation des nombres et du texte, mapping vers une taxonomie, variantes et validation. Les exemples utilisent de vrais codes d’unités et de vraies structures de taxonomie, que vous pouvez donc adapter directement.
Ce que sont les attributs produit (et ce qu’ils ne sont pas)
Un attribut produit est une propriété nommée associée à une valeur : matériau = acier inoxydable, capacité = 1,5 L, couleur = noir. La recherche sur l’extraction d’attributs appelle cela des paires attribut-valeur. Les attributs décrivent le produit lui-même et restent vrais partout où il est vendu, c’est pourquoi ils relèvent de champs structurés et pas seulement du texte de la description.
Trois notions voisines se confondent facilement avec les attributs, et les mélanger est à l’origine de la plupart des problèmes de schéma par la suite :
| Notion | Rôle | Exemple | Emplacement habituel |
|---|---|---|---|
| Attribut | Décrit une propriété du produit | Matériau : acier inoxydable ; Capacité : 1,5 L | Tableau de caractéristiques, filtres, champs de catégorie |
| Identifiant | Désigne de manière unique le produit ou l’article commercial | GTIN, MPN, SKU, référence de modèle | Champs d’identifiants dédiés |
| Option de variante | Un attribut que l’acheteur choisit | Couleur : noir / blanc ; Taille : S / M / L | Axes de variante (Shopify autorise jusqu’à 3 options) |
| Description | Explique les bénéfices et l’usage en texte rédigé | « Fait bouillir une bouilloire pleine en quelques minutes » | Description et puces |
Schéma d’attributs à définir avant toute extraction
Un schéma d’attributs est le contrat auquel chaque valeur doit satisfaire. Sans lui, l’extraction produit ce que la source dit, quoi que ce soit, et la normalisation tourne à la devinette. Pour chaque attribut, décidez du nom, du type de données, de l’unité canonique, des valeurs autorisées ou de la règle de validation, de la possibilité d’avoir plusieurs valeurs et des cas où il est obligatoire.
Gardez un schéma par famille de produits plutôt qu’une seule liste géante : une bouilloire a besoin d’une capacité et d’une puissance nominale, un T-shirt d’une composition en fibres et d’une taille. Commencez par les attributs que vos canaux exigent et sur lesquels vos acheteurs filtrent, puis ajoutez les attributs techniques que vos fiches techniques fournissent de manière fiable.
| Attribut | Type de données | Unité / format | Valeurs autorisées ou règle | Obligatoire |
|---|---|---|---|---|
| model_number | Texte | — | Tel qu’imprimé par le fabricant ; aucun espace ajouté | Oui |
| gtin | Texte (chiffres) | 8, 12, 13 ou 14 chiffres | Clé de contrôle GS1 valide | S’il est attribué |
| capacity | Décimal | LTR (litre) | 0,1 à 5,0 ; une valeur par variante | Oui |
| rated_power_min / rated_power_max | Entier | WTT (watt) | min ≤ max ; les deux issues de la même ligne de caractéristiques | Oui |
| body_material | Énumération (multivaleur) | — | acier inoxydable, verre, plastique, céramique | Oui |
| color | Énumération | — | Liste de couleurs de base ; nom commercial stocké séparément | Oui, pour chaque variante |
| net_weight | Décimal | KGM (kilogramme) | > 0 ; ne doit pas dépasser le poids brut | Pour l’expédition |
D’où viennent les valeurs d’attributs, et quelle source l’emporte
Les valeurs proviennent généralement de plusieurs sources qui ne concordent pas toujours. Définissez une priorité de sources pour chaque attribut afin de résoudre les conflits de façon cohérente, et pas selon la dernière personne qui modifie la fiche.
Une règle par défaut pratique : les documents techniques l’emportent sur les textes marketing, et le document spécifique sur le document général. Lorsque des sources de même rang divergent — une fiche technique et un emballage indiquant des poids différents, par exemple — ne faites pas de moyenne et n’en choisissez pas une au hasard : demandez au fournisseur laquelle est à jour.
- Fiches techniques et fiches de caractéristiques : la source la plus fiable pour les dimensions, les valeurs nominales, les matériaux et les performances, généralement dans des tableaux.
- Emballage et visuels d’étiquette : font foi pour ce qui est imprimé sur l’emballage, comme la quantité nette, les avertissements et les marquages.
- Fiches de données de sécurité : classification des dangers, composition et propriétés physiques des produits chimiques ; ce ne sont pas des attributs marketing.
- Descriptions produit du fournisseur : utiles pour les attributs qui n’apparaissent jamais dans un tableau (style, usage prévu, modèles compatibles), mais la source la moins précise.
Comment extraire les attributs des descriptions produit
Les descriptions en texte libre sont la source la plus difficile, car les valeurs sont noyées dans des phrases, nuancées par le langage marketing et parfois niées. Que vous utilisiez des règles, un dictionnaire de valeurs connues ou un modèle de langage, la procédure qui garantit un résultat fiable est la même :
- Dressez la liste des attributs cibles de la famille de produits, avec leurs valeurs et unités autorisées, avant de lire le moindre texte.
- Découpez le texte en phrases et en puces, puis repérez les valeurs candidates : nombres avec unités, termes connus du vocabulaire et formulations du type « compatible avec … ».
- Vérifiez le contexte de chaque candidat pour y détecter des qualificatifs (« jusqu’à », « env. », « à partir de »), des négations (« sans BPA », « ne convient pas à ») et des conditions (« avec couvercle », « à 20 °C »).
- Attribuez chaque valeur à un seul attribut ; lorsqu’un nombre pourrait relever de deux attributs, laissez-le non attribué pour vérification plutôt que de deviner.
- Normalisez la valeur et l’unité selon les règles des sections suivantes, en conservant le texte d’origine à côté.
- Marquez chaque attribut issu uniquement du texte marketing, afin qu’un relecteur puisse le confirmer à l’aide d’une fiche technique avant son utilisation dans un tableau de caractéristiques ou un brouillon de déclaration.
| Texte de la description | Attribut | Valeur extraite | Remarque |
|---|---|---|---|
| « …une bouilloire en acier inoxydable de 1,7 litre… » | capacity ; body_material | 1.7 LTR ; acier inoxydable | Deux attributs dans une même expression |
| « …avec un couvercle en plastique sans BPA… » | lid_material ; bpa_free | plastique ; true | La négation devient un booléen, et non un matériau |
| « …ne convient pas aux plaques à induction… » | induction_compatible | false | Énoncé négatif inversé |
| « …disponible en noir mat et crème… » | color (option de variante) | noir ; beige | Noms commerciaux conservés séparément |
Associer les en-têtes des fiches techniques à des noms d’attributs canoniques
Chaque fabricant désigne le même attribut différemment, souvent dans sa propre langue. Construisez une table de synonymes qui associe le texte d’en-tête réellement rencontré à votre nom d’attribut canonique ; elle s’enrichit vite au début, puis se stabilise, et devient votre ressource de normalisation la plus réutilisable. Enregistrez aussi l’unité imprimée dans l’en-tête : sous « Poids (lb) », aucune cellule ne répète l’unité. Les mises en page de tableaux, les scans et l’OCR sont traités dans le guide sur l’extraction de données produit à partir de PDF.
| En-tête tel qu’imprimé | Attribut canonique | Unité sous-entendue par l’en-tête | Remarque |
|---|---|---|---|
| Puissance nominale / Consommation / Leistung | rated_power | WTT | Vérifier qu’il s’agit de la puissance d’entrée, et non de sortie |
| Poids net / Poids (unité) / Nettogewicht | net_weight | KGM ou LBR, tel qu’imprimé | Pas le poids d’expédition |
| Capacité / Volume / Fassungsvermögen | capacity | LTR ou MLT | Pour les contenants, pas le volume du colis |
| Dimensions (L × P × H) mm | width, depth, height | MMT | Ordre des axes repris de l’en-tête |
Normaliser les nombres et les unités
Enregistrez chaque attribut quantitatif dans deux champs : un nombre et un code d’unité. La Recommandation n° 20 de l’UN/CEFACT (« Codes des unités de mesure utilisées dans le commerce international ») fournit pour cela des codes communs de trois caractères, et schema.org utilise les mêmes codes dans sa propriété unitCode, par exemple une QuantitativeValue de 25 avec unitCode CMT. Utiliser ces codes plutôt que des unités en texte libre (« cm », « cms », « centimètres ») supprime toute une catégorie de divergences.
Choisissez une unité canonique par attribut, généralement l’unité SI ou l’un de ses multiples décimaux, et convertissez à l’import afin que les valeurs soient comparables d’un fournisseur à l’autre. Conservez la valeur et l’unité d’origine telles qu’imprimées pour la traçabilité, et reconvertissez vers les unités du canal à l’export : un CSV de produits Shopify attend le poids en grammes, tandis que WooCommerce utilise les unités de poids et de dimensions configurées dans la boutique.
Attention aux détails qui provoquent des erreurs silencieuses. Les séparateurs décimaux et de milliers dépendent de la langue du document : sur une fiche technique allemande, « 1.000 W » correspond à mille watts. Scindez les plages en champs minimum et maximum, enregistrez les tolérances séparément de la valeur nominale et conservez les qualificatifs comme « env. » ou « max. » dans leur propre champ. Les conversions impériales utilisent des définitions exactes (1 pouce = 25,4 mm ; 1 lb = 0,45359237 kg) ; n’arrondissez qu’une fois, au moment de l’affichage.
| Valeur brute telle qu’imprimée | Valeur normalisée | Code UNECE Rec 20 | Règle appliquée |
|---|---|---|---|
| 1,5 l | 1.5 | LTR | Virgule décimale lue selon la langue du document |
| 1500 ml | 1.5 | LTR | Converti dans l’unité canonique de l’attribut ; original conservé |
| 1.000 W (fiche technique allemande) | 1000 | WTT | Point lu comme séparateur de milliers |
| 220–240 V~ | min. 220, max. 240 | VLT | Plage scindée ; « ~ » enregistré comme type de courant CA |
| Ø 12 mm ± 0,2 | nominale 12, tolérance 0.2 | MMT | Tolérance enregistrée séparément |
| env. 2,3 kg | 2.3 (qualificatif : approximatif) | KGM | Qualificatif conservé, non supprimé |
| 5 lb | 2.26796 | KGM | Converti avec 0,45359237 ; original LBR conservé |
| 1/2 po | 12.7 | MMT | Fraction résolue ; original INH conservé |
| Lot de 6 | 6 | H87 | Nombre de pièces par lot |
Utiliser des vocabulaires contrôlés pour les attributs textuels
Un vocabulaire contrôlé est la liste des valeurs qu’un attribut textuel peut prendre, avec les synonymes associés à chacune. Il permet à un filtre « Couleur : noir » de retrouver les produits décrits comme « nr », « Noir » et « schwarz ».
Conservez deux champs lorsque marketing et filtrage tirent dans des directions opposées : une valeur de base normalisée pour les filtres et les flux, et le nom propre du fabricant pour l’affichage. « Midnight Graphite » est un bon détail pour une fiche produit et une valeur de filtre inutile ; « gris » est l’inverse. Pour les catalogues multilingues, enregistrez les valeurs du vocabulaire sous forme de codes neutres sur le plan linguistique et traduisez leurs libellés, afin que le même produit soit filtré correctement dans chaque langue de la boutique.
| Valeur textuelle brute | Valeur normalisée | Règle de vocabulaire |
|---|---|---|
| nr / NOIR / schwarz | noir | Synonymes et traductions associés à un seul code |
| Midnight Graphite | gris (nom d’affichage conservé) | Nom commercial stocké séparément |
| 18/8 SS | acier inoxydable | Abréviation développée ; nuance conservée comme attribut distinct |
| Coton 95 %, élasthanne 5 % | coton 95 ; élasthanne 5 | Composition sous forme de paires valeur-pourcentage |
| Oui / ✓ / inclus | true | Booléens ramenés à true ou false |
Associer les attributs aux taxonomies et aux schémas des canaux
Une taxonomie détermine quels attributs s’appliquent à un produit et comment ils s’appellent. Vous avez rarement le choix : un distributeur peut demander GS1 GPC, un grossiste ETIM, Shopify sa Standard Product Taxonomy, et les moteurs de recherche lisent le balisage schema.org. Gardez votre propre schéma d’attributs comme référence et maintenez une correspondance vers chaque taxonomie externe.
Dans GS1 GPC, la brique est l’élément de base, et les attributs de brique portent des détails comme le fait qu’un lait soit d’origine animale ou non. ETIM attribue à chaque classe un ensemble prédéfini de caractéristiques, avec des listes de valeurs et des unités fixes, et publie son modèle en 17 langues. Shopify demande une seule catégorie, choisie selon la fonction principale du produit ; la renseigner donne accès aux métachamps de catégorie. Le type Product de schema.org dispose de propriétés dédiées telles que gtin, mpn, brand, color, material, size et weight.
| Taxonomie | Principaux utilisateurs | Structure | Modèle d’attributs | Points de vigilance |
|---|---|---|---|---|
| GS1 GPC | Échange de données pour le commerce de détail et les biens de consommation | Segment > Famille > Classe > Brique | Attributs de brique avec valeurs définies | Une classification, pas un modèle de caractéristiques complet |
| ETIM | Grossistes techniques : électricité, CVC, plomberie | Classes avec synonymes | Caractéristiques typées alphanumériques, logiques, numériques ou en plage, avec unités | Les valeurs des caractéristiques doivent provenir des listes de la classe |
| Shopify Standard Product Taxonomy | Boutiques Shopify | Chemin de catégorie ou identifiant de catégorie | Métachamps de catégorie (attributs produit) pour chaque catégorie | Dans le CSV, indiquez le chemin complet ou l’identifiant, pas les deux |
| schema.org Product | Données structurées pour les moteurs de recherche | Un seul type Product avec des propriétés | Propriétés dédiées ; QuantitativeValue avec unitCode | Utilisez les propriétés spécifiques avant additionalProperty |
Gérer les variantes sans dupliquer les attributs
Les variantes sont des produits qui partagent la plupart de leurs attributs et diffèrent sur quelques-uns. Modélisez-les avec une fiche parent contenant les attributs communs et des fiches enfants contenant uniquement les axes de variante et les valeurs qui changent avec eux, comme la couleur, la taille, la capacité et leurs propres identifiants. Les règles GTIN de GS1 considèrent chaque variation de style, de couleur et de taille comme un produit unique doté de son propre GTIN : l’identifiant se trouve donc toujours sur la fiche enfant.
Les tableaux de caractéristiques multi-modèles causent la plupart des erreurs de variantes. Scindez un tableau comportant une colonne par modèle en une fiche par colonne, et copiez toute valeur imprimée une seule fois sur plusieurs colonnes — une cellule fusionnée, ou « tous les modèles : 230 V » sous le tableau — dans chaque fiche enfant concernée. Dans Shopify, la colonne CSV Option1 LinkedTo relie une option de variante à un métachamp de catégorie ; un produit peut avoir jusqu’à trois options et 2 048 variantes.
Valider les attributs par des règles et un échantillonnage qualité
Les règles de validation détectent les erreurs mécaniques : mauvais type, mauvaise unité, valeur impossible, attribut obligatoire manquant. Exécutez-les à chaque import et orientez les échecs vers un relecteur au lieu de supprimer silencieusement des valeurs.
Les règles ne peuvent pas détecter une valeur plausible mais fausse — une capacité copiée depuis la colonne du modèle voisin passe tous les contrôles. L’échantillonnage qualité le peut : comparez des fiches échantillonnées aux documents sources, champ par champ. Il n’existe pas de taille d’échantillon ni de seuil d’erreur universels ; fixez-les selon le risque.
- Prélevez un échantillon de fiches pour chaque fournisseur, en privilégiant les nouveaux fournisseurs et les nouvelles mises en page de documents.
- Comparez chaque attribut échantillonné à la source, en consignant séparément les concordances, les valeurs erronées et les valeurs manquantes.
- Calculez les taux d’erreur par attribut, et pas seulement par fiche, pour repérer les attributs ou les correspondances d’en-têtes qui posent problème.
- Contrôlez les attributs liés à la sécurité et exigés par la loi sur chaque fiche, et non sur un échantillon.
| Type de règle | Exemple | Action en cas d’échec |
|---|---|---|
| Type et format | capacity doit être un nombre décimal ; gtin : chiffres uniquement | Rejeter la valeur, conserver le texte brut pour vérification |
| Plage et vraisemblance | contenance d’une bouilloire comprise entre 0,1 et 5 L | Signaler comme probable erreur d’unité ou de séparateur |
| Appartenance à une énumération | color doit figurer dans la liste des couleurs de base | Associer le synonyme ou l’ajouter au vocabulaire |
| Champs croisés | min ≤ max ; poids net ≤ poids brut | Signaler les deux champs |
| Clé de contrôle | Le GTIN réussit le contrôle modulo 10 de GS1 | Rejeter ; relire depuis la source |
| Exhaustivité | tous les attributs obligatoires pour la famille et le canal sont renseignés | Bloquer la publication ; demander les données au fournisseur |
Normaliser les attributs à grande échelle
Le schéma, les tables de synonymes, les vocabulaires et les règles forment la partie durable de ce travail ; la méthode d’extraction peut changer en dessous. Versionnez-les, attribuez un responsable à chacun, consignez les corrections manuelles avec leur motif (des corrections répétées révèlent une règle manquante) et réexaminez la table de synonymes à chaque intégration d’un nouveau fournisseur.
Si vos attributs naissent dans des PDF fournisseurs, Doc2Shelf peut assurer l’étape d’extraction : il lit les fiches techniques, fiches de caractéristiques, FDS et catalogues téléversés, conserve les valeurs et les unités exactement telles qu’imprimées avec la page et une courte citation comme preuve, et signale les données obligatoires manquantes. Vos règles de normalisation s’appliquent ensuite lors de la vérification, avant que la fiche n’alimente des fiches produit ou des brouillons de déclaration.
Questions fréquentes
- Que sont les attributs produit ?
- Les attributs produit sont des propriétés nommées, associées à des valeurs, qui décrivent un produit, comme le matériau, la couleur, la capacité, les dimensions ou la puissance nominale. Contrairement au texte de la description, ils figurent dans des champs structurés afin d’alimenter les filtres, les tableaux de caractéristiques, les flux et les exigences de catégorie.
- Quelle est la différence entre un attribut produit et une variante ?
- Un attribut est n’importe quelle propriété d’un produit. Une variante est une version du produit qui diffère par un ou plusieurs attributs entre lesquels l’acheteur choisit, comme la taille ou la couleur. Ces attributs choisis sont les options de variante ; les autres restent communs sur le produit parent.
- Comment extraire les attributs des descriptions produit ?
- Définissez d’abord les attributs cibles et les valeurs autorisées, découpez le texte en phrases, repérez les valeurs candidates, puis vérifiez pour chacune les qualificatifs, négations et conditions avant de l’attribuer à un attribut. Confirmez à l’aide d’une fiche technique les attributs qui n’apparaissent que dans le texte marketing.
- Que sont les codes d’unités de la Recommandation 20 de l’UNECE ?
- Ce sont des codes de trois caractères désignant les unités de mesure utilisées dans le commerce international, publiés par l’UN/CEFACT — par exemple MTR pour le mètre, KGM pour le kilogramme, LTR pour le litre et WTT pour le watt. La propriété unitCode de schema.org utilise les mêmes codes.
- Dois-je enregistrer la valeur d’origine ou la valeur convertie ?
- Les deux. Enregistrez le nombre normalisé et le code d’unité pour le filtrage, la comparaison et la validation, et conservez la valeur telle qu’imprimée pour la traçabilité. Convertissez vers l’unité attendue par chaque canal à l’export, par exemple en grammes pour le poids dans un CSV de produits Shopify.
- Quelle taxonomie produit utiliser : GS1 GPC, ETIM ou celle de Shopify ?
- Utilisez celle que demandent vos partenaires commerciaux et vos canaux, et souvent plusieurs. Gardez votre propre schéma d’attributs comme référence et maintenez des correspondances vers GPC pour l’échange de données du commerce de détail, ETIM pour le négoce technique et la Standard Product Taxonomy de Shopify pour une boutique Shopify.
- Comment mesurer la qualité de l’extraction d’attributs ?
- Comparez un échantillon de fiches extraites aux documents sources, champ par champ, et comptez séparément les valeurs correctes, erronées et manquantes pour chaque attribut. Les valeurs erronées révèlent des problèmes de précision ; les valeurs manquantes, des problèmes de rappel. Suivez les deux pour chaque fournisseur.
- Comment gérer les attributs produit en plusieurs langues ?
- Enregistrez les valeurs énumérées, comme les couleurs et les matériaux, sous forme de codes neutres sur le plan linguistique avec des libellés traduits, et gardez les nombres et les codes d’unités indépendants de la langue. Les attributs en texte libre nécessitent une traduction et une relecture pour chaque langue.
Sources officielles
Textes juridiques de référence et orientations officielles citées dans ce guide.
- Norme GS1 de gestion des GTIN — règles d’attribution des GTIN (GS1)
- Comment calculer manuellement un chiffre de contrôle (GS1)
Ce guide fournit des informations générales et ne constitue pas un conseil juridique. Les exigences dépendent du produit et du marché ; consultez les textes officiels et sollicitez un avis qualifié pour votre situation.