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 :

Les attributs comparés aux autres données produit
NotionRôleExempleEmplacement habituel
AttributDécrit une propriété du produitMatériau : acier inoxydable ; Capacité : 1,5 LTableau de caractéristiques, filtres, champs de catégorie
IdentifiantDésigne de manière unique le produit ou l’article commercialGTIN, MPN, SKU, référence de modèleChamps d’identifiants dédiés
Option de varianteUn attribut que l’acheteur choisitCouleur : noir / blanc ; Taille : S / M / LAxes de variante (Shopify autorise jusqu’à 3 options)
DescriptionExplique 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.

Exemple de schéma d’attributs pour une famille de bouilloires électriques
AttributType de donnéesUnité / formatValeurs autorisées ou règleObligatoire
model_numberTexte—Tel qu’imprimé par le fabricant ; aucun espace ajoutéOui
gtinTexte (chiffres)8, 12, 13 ou 14 chiffresClé de contrôle GS1 valideS’il est attribué
capacityDécimalLTR (litre)0,1 à 5,0 ; une valeur par varianteOui
rated_power_min / rated_power_maxEntierWTT (watt)min ≤ max ; les deux issues de la même ligne de caractéristiquesOui
body_materialÉnumération (multivaleur)—acier inoxydable, verre, plastique, céramiqueOui
colorÉnumération—Liste de couleurs de base ; nom commercial stocké séparémentOui, pour chaque variante
net_weightDécimalKGM (kilogramme)> 0 ; ne doit pas dépasser le poids brutPour 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 :

  1. 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.
  2. 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 … ».
  3. 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 »).
  4. 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.
  5. Normalisez la valeur et l’unité selon les règles des sections suivantes, en conservant le texte d’origine à côté.
  6. 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.
Exemple concret : attributs trouvés dans une phrase de description
Texte de la descriptionAttributValeur extraiteRemarque
« …une bouilloire en acier inoxydable de 1,7 litre… »capacity ; body_material1.7 LTR ; acier inoxydableDeux attributs dans une même expression
« …avec un couvercle en plastique sans BPA… »lid_material ; bpa_freeplastique ; trueLa négation devient un booléen, et non un matériau
« …ne convient pas aux plaques à induction… »induction_compatiblefalseÉnoncé négatif inversé
« …disponible en noir mat et crème… »color (option de variante)noir ; beigeNoms 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.

Synonymes d’en-têtes associés à un attribut canonique
En-tête tel qu’impriméAttribut canoniqueUnité sous-entendue par l’en-têteRemarque
Puissance nominale / Consommation / Leistungrated_powerWTTVérifier qu’il s’agit de la puissance d’entrée, et non de sortie
Poids net / Poids (unité) / Nettogewichtnet_weightKGM ou LBR, tel qu’impriméPas le poids d’expédition
Capacité / Volume / FassungsvermögencapacityLTR ou MLTPour les contenants, pas le volume du colis
Dimensions (L × P × H) mmwidth, depth, heightMMTOrdre 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.

Valeurs brutes des fournisseurs et leur forme normalisée
Valeur brute telle qu’impriméeValeur normaliséeCode UNECE Rec 20Règle appliquée
1,5 l1.5LTRVirgule décimale lue selon la langue du document
1500 ml1.5LTRConverti dans l’unité canonique de l’attribut ; original conservé
1.000 W (fiche technique allemande)1000WTTPoint lu comme séparateur de milliers
220–240 V~min. 220, max. 240VLTPlage scindée ; « ~ » enregistré comme type de courant CA
Ø 12 mm ± 0,2nominale 12, tolérance 0.2MMTTolérance enregistrée séparément
env. 2,3 kg2.3 (qualificatif : approximatif)KGMQualificatif conservé, non supprimé
5 lb2.26796KGMConverti avec 0,45359237 ; original LBR conservé
1/2 po12.7MMTFraction résolue ; original INH conservé
Lot de 66H87Nombre 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.

Valeurs textuelles avant et après normalisation par vocabulaire
Valeur textuelle bruteValeur normaliséeRègle de vocabulaire
nr / NOIR / schwarznoirSynonymes et traductions associés à un seul code
Midnight Graphitegris (nom d’affichage conservé)Nom commercial stocké séparément
18/8 SSacier inoxydableAbréviation développée ; nuance conservée comme attribut distinct
Coton 95 %, élasthanne 5 %coton 95 ; élasthanne 5Composition sous forme de paires valeur-pourcentage
Oui / ✓ / inclustrueBoolé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.

Comparatif des taxonomies produit
TaxonomiePrincipaux utilisateursStructureModèle d’attributsPoints de vigilance
GS1 GPCÉchange de données pour le commerce de détail et les biens de consommationSegment > Famille > Classe > BriqueAttributs de brique avec valeurs définiesUne classification, pas un modèle de caractéristiques complet
ETIMGrossistes techniques : électricité, CVC, plomberieClasses avec synonymesCaractéristiques typées alphanumériques, logiques, numériques ou en plage, avec unitésLes valeurs des caractéristiques doivent provenir des listes de la classe
Shopify Standard Product TaxonomyBoutiques ShopifyChemin de catégorie ou identifiant de catégorieMétachamps de catégorie (attributs produit) pour chaque catégorieDans le CSV, indiquez le chemin complet ou l’identifiant, pas les deux
schema.org ProductDonnées structurées pour les moteurs de rechercheUn seul type Product avec des propriétésPropriétés dédiées ; QuantitativeValue avec unitCodeUtilisez 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.

  1. Prélevez un échantillon de fiches pour chaque fournisseur, en privilégiant les nouveaux fournisseurs et les nouvelles mises en page de documents.
  2. Comparez chaque attribut échantillonné à la source, en consignant séparément les concordances, les valeurs erronées et les valeurs manquantes.
  3. 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.
  4. Contrôlez les attributs liés à la sécurité et exigés par la loi sur chaque fiche, et non sur un échantillon.
Types de règles de validation avec exemples
Type de règleExempleAction en cas d’échec
Type et formatcapacity doit être un nombre décimal ; gtin : chiffres uniquementRejeter la valeur, conserver le texte brut pour vérification
Plage et vraisemblancecontenance d’une bouilloire comprise entre 0,1 et 5 LSignaler comme probable erreur d’unité ou de séparateur
Appartenance à une énumérationcolor doit figurer dans la liste des couleurs de baseAssocier le synonyme ou l’ajouter au vocabulaire
Champs croisésmin ≤ max ; poids net ≤ poids brutSignaler les deux champs
Clé de contrôleLe GTIN réussit le contrôle modulo 10 de GS1Rejeter ; relire depuis la source
Exhaustivitétous les attributs obligatoires pour la famille et le canal sont renseignésBloquer 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.

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.

Autres guides

Transformez les PDF fournisseurs en données produit vérifiées

Doc2Shelf extrait les données produit des documents fournisseurs et rédige des fiches produit et des documents de conformité que vous pouvez vérifier.

Créer votre compte gratuit