Rédiger des valeurs product_detail et product_highlight acceptées par Google, avec des lignes de flux détaillées

L'attribut product_detail de Google accepte jusqu'à 100 entrées par produit, chacune de 1 à 150 caractères, et product_highlight exige au moins 2 et recommande 4 à 6 courts arguments bénéfices par article, selon les spécifications officielles de Google sur product detail et product highlight. Les deux sont facultatifs : la plupart des flux les ignorent ou y collent un tableau de caractéristiques que Merchant Center signale comme mal formaté.

Google indique que product_detail aide les produits à s'afficher sur les surfaces d'IA comme AI Mode, et en mai 2026 il a ajouté d'autres attributs conversationnels reposant sur la même idée.

Cette référence s'adresse aux gestionnaires de flux et aux agences qui envoient des données produits à Google Merchant Center. À la fin, vous saurez rédiger les deux attributs en TSV et en XML, échapper les caractères qui les cassent, écarter les contenus interdits et noter une ligne avant de la soumettre.

À quoi servent product_detail et product_highlight

Les deux attributs se ressemblent et sont souvent alimentés à partir de la même source, mais Google leur attribue des rôles différents. product_detail porte des caractéristiques techniques vérifiables qui ne sont couvertes par aucun autre attribut : contenu du colis, connectivité, ingrédients, alimentation électrique, finition, parfum et autres faits similaires. product_highlight porte de courts arguments de vente rédigés sous forme de phrases simples.

Notre test rapide : si la ligne tient dans un tableau de caractéristiques avec un libellé et une valeur, c'est un product_detail. Si elle se lit comme une phrase qu'un vendeur prononcerait en magasin, c'est un product_highlight. La spécification de Google sur les highlights fait la même distinction et demande de ne pas répéter l'un dans l'autre.

La spécification en un coup d'œil

Voici les limites telles que Google les publie aujourd'hui. Google ne mentionne aucune propriété schema.org pour product_detail : l'attribut n'est donc pas repris de vos données structurées et doit figurer dans le flux.

Sources : Centre d'aide Google Merchant Center, Product detail [product_detail] et Product highlight [product_highlight].

Comment rédiger product_detail en TSV, en XML et avec la Merchant API

C'est le format qui fait échouer la plupart des lignes. Chaque détail se compose de trois valeurs reliées par deux deux-points, dans l'ordre nom de section, nom d'attribut, valeur d'attribut. Google est explicite : dans les flux texte, chaque détail doit contenir deux deux-points, et fournir un nombre de sous-attributs différent de celui déclaré dans l'en-tête génère un problème de format de sous-attribut non valide sous « Needs attention ».

En-tête TSV et cellule unique

Déclarez les sous-attributs dans l'en-tête de colonne, entre parenthèses et séparés par des deux-points. Une fois nommés dans l'en-tête, les sous-attributs peuvent suivre l'ordre que vous avez déclaré. Sans déclaration, Google suppose l'ordre section, nom, valeur.

product_detail(section_name:attribute_name:attribute_value)

Une cellule contenant trois détails ressemble alors à ceci :

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W

Si un détail n'a pas de section, conservez le deux-points initial et laissez le premier champ vide :

:What's in the box?:"Machine,Measuring spoon,User manual"

Échapper les deux-points, les virgules et les guillemets

Les règles de Google sur les attributs entre guillemets s'appliquent aux attributs de groupe comme celui-ci :

• Placez entre guillemets doubles droits toute valeur de sous-attribut contenant une virgule ou un deux-points. Mettez entre guillemets la valeur individuelle, pas le groupe entier.
• Écrivez un guillemet double littéral sous la forme de deux guillemets doubles. L'exemple de Google est "APS-C max. 12""" pour une valeur se terminant par un symbole de pouce.
• N'utilisez pas l'échappement par barre oblique inverse. Google lit la barre oblique inverse comme un caractère littéral.
• Les champs entre guillemets ne sont pas pris en charge pour les sources de données Google Sheets. Pour les sources de fichiers existantes, les champs entre guillemets doivent être activés dans la configuration de la source de données.

XML

En XML, chaque détail est un élément distinct comportant trois enfants : aucun échappement des deux-points ou des virgules n'est donc nécessaire :

<g:product_detail><g:section_name>Materials</g:section_name><g:attribute_name>Body</g:attribute_name><g:attribute_value>Stainless steel, BPA-free plastic</g:attribute_value></g:product_detail>

Pour les catégories riches en caractéristiques, XML est le format le plus sûr, car les virgules et les deux-points naturels ne présentent plus de risque d'analyse.

Merchant API

Avec la Merchant API, chaque détail est un objet ProductDetail doté des champs sectionName, attributeName et attributeValue, d'après la référence du client API.

Comment rédiger product_highlight

Les highlights sont plus simples : une chaîne par highlight. Dans un flux texte, séparez les highlights par des virgules et placez entre guillemets doubles tout highlight contenant une virgule ou un deux-points. En XML, donnez à chaque highlight son propre élément <g:product_highlight>.

"Brews up to 4 cups in one cycle","Foam sensor stops brewing before the pot overflows","Switches off automatically after brewing","Stainless steel body wipes clean"

Limitez chacun à un seul bénéfice. Google demande un langage professionnel et grammaticalement correct, sans emphase en majuscules, sans symboles et sans formulation promotionnelle.

Contenus que Google n'autorise dans aucun des deux attributs

Les erreurs de format produisent des erreurs visibles. Les erreurs de contenu sont plus discrètes : une ligne peut être acceptée et enfreindre tout de même la politique. Ce tableau regroupe les interdictions issues des deux spécifications.

Google ajoute une règle de plus, facile à manquer : si vous soumettez des fichiers document_link contenant déjà les mêmes informations, ne les reprenez pas dans ces attributs et laissez Google les extraire des documents.

Exemple détaillé : un tableau de caractéristiques transformé en lignes acceptées

Voici une ligne typique d'une boutique qui exporte les caractéristiques de ses produits dans un seul champ de texte libre. Le produit est une machine à café turc électrique ; la boutique vend en Turquie, et en anglais sur les marchés du Golfe.

Avant

product_detail: Brand: Acme, Power: 1000W, Material: Stainless Steel, Plastic, FREE SHIPPING, best turkish coffee maker cheap

Cinq problèmes dans une seule cellule. Les séparateurs sont mélangés, donc le nombre de deux-points ne correspond pas à l'en-tête. « Stainless Steel, Plastic » n'est pas entre guillemets, donc sa virgule scinde le détail. Brand duplique l'attribut brand. « FREE SHIPPING » est un texte de livraison en majuscules. Le dernier fragment est une chaîne de mots-clés.

Après, flux en anglais

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W,Materials:Body:"Stainless steel, BPA-free plastic",Safety:Automatic shut-off:Yes,:What's in the box?:"Machine,Measuring spoon,User manual"

La marque est déplacée vers son propre attribut, la livraison vers shipping, les mots-clés sont supprimés, les valeurs sont en casse de phrase comme Google le recommande, et chaque valeur contenant une virgule est entre guillemets. « Automatic shut-off: Yes » est conservé parce que le fabricant le confirme ; un champ que votre plateforme renseigne par défaut sur « No » ne le serait pas.

Après, flux en turc

Google demande que les noms de section, les noms d'attribut et les valeurs soient localisés dans chaque flux linguistique ; le flux turc reçoit donc sa propre ligne plutôt que celle de la version anglaise :

Genel:Demleme türü:Türk kahvesi,Genel:Kapasite:4 fincan,Güç:Nominal güç:1000 W,Malzeme:Gövde:"Paslanmaz çelik, BPA içermeyen plastik",:Kutu içeriği:"Makine,Ölçü kaşığı,Kullanım kılavuzu"

Deux points régionaux pour les équipes situées hors de Turquie. Premièrement, conservez les lettres turques. La recommandation de Google en faveur de l'ASCII est une préférence, pas une obligation, et sa spécification sur les highlights autorise explicitement les lettres accentuées ; translittérer « Paslanmaz çelik » en « Paslanmaz celik » produit une faute d'orthographe, ce qui contredit les consignes de grammaire et d'orthographe de Google. Deuxièmement, si une règle met ces valeurs en minuscules ou en casse de phrase, elle doit tenir compte de la locale afin que « İ » et « I » ne deviennent pas les mauvaises lettres, un problème que nous avons traité dans notre guide sur la casse des titres en turc.

Comment construire les valeurs à partir de votre catalogue

Nous alimentons ces attributs en quatre passes, dans cet ordre.

1. Commencez par mapper les sources structurées. Listez toutes les caractéristiques que votre plateforme stocke déjà sous forme de paire libellé et valeur, comme un onglet de caractéristiques, un metafield ou un attribut ERP. Chaque paire devient un product_detail, avec le groupe source comme section_name. Utilisez une couche de flux telle que les règles de flux ou un flux supplémentaire afin que le catalogue source reste intact et que la sortie Google puisse différer de celle des autres canaux.
2. Retirez tout ce qui relève d'un autre attribut. Supprimez les lignes de marque, couleur, taille, matière, prix et livraison si elles figurent déjà dans leurs attributs dédiés. Supprimez ensuite tout détail dont le texte apparaît déjà dans le titre ou la description.
3. Rédigez les highlights à la main ou avec des brouillons d'IA relus. Les highlights sont l'endroit où l'enrichissement par IA aide le plus et échoue le plus. Un modèle écrira volontiers « Cadeau idéal pour les amateurs de café », ce qui est promotionnel, ou inventera une fonctionnalité que le produit n'a pas. Générez des brouillons uniquement à partir de caractéristiques confirmées et relisez-les au regard du tableau des interdictions ci-dessus.
4. Validez la longueur et la syntaxe avant l'export. Vérifiez que chaque détail et chaque highlight comptent 150 caractères ou moins, que chaque détail comporte exactement deux deux-points hors guillemets, et que le nombre de highlights par produit est d'au moins 2.

Une grille de notation à appliquer avant de soumettre

Notez un échantillon de 20 lignes par catégorie. Chaque contrôle est réussi (1) ou échoué (0), pour un maximum de 10 par ligne. Nous considérons 9 ou 10 comme prêt, 7 ou 8 comme à corriger avant envoi, et tout score inférieur comme le signe que les données sources doivent être retravaillées avant que l'envoi de ces attributs ait un intérêt.

Les limites de ce guide

Nous ne savons pas dans quelle mesure ces attributs influencent le classement ou le taux de clics. Google affirme que product_detail aide les produits à apparaître pour des requêtes pertinentes, y compris dans AI Mode, mais ne publie aucun chiffre, et nous n'avons vu aucune étude publique contrôlée. Méfiez-vous des pourcentages avancés par les éditeurs tant qu'ils ne s'accompagnent pas d'une méthode.

Ce guide est une référence Google. La spécification de flux produits d'OpenAI ne prévoit ni champ générique de type clé-valeur pour les caractéristiques ni champ de highlights ; elle utilise des champs à plat tels que material, dimensions et weight, ainsi qu'une description de 5 000 caractères. Si vous envoyez aussi ce flux, vos caractéristiques doivent être mappées dans ces champs ou dans la description. Nous n'avons pas vérifié les équivalents Meta ou TikTok pour ce guide.

Il laisse également de côté les attributs conversationnels plus récents, comme question_and_answer et document_link, au-delà de la règle de chevauchement exposée plus haut. Plusieurs éditeurs de solutions de flux, dont Channable et Productsup, ont publié avant nous des guides de mapping pour ces attributs, et ils méritent d'être lus si vous avez besoin de cet ensemble dès maintenant.

Enfin, si votre catalogue ne contient aucune caractéristique structurée, cette méthode ne peut pas en créer, et les brouillons d'IA sans source confirmée sont précisément ce que la règle de Google « n'envoyer que des valeurs confirmées » cherche à empêcher.

Questions fréquentes

product_detail est-il obligatoire dans Google Merchant Center ?

Non. Google le présente comme facultatif pour chaque produit. Il vaut la peine de l'ajouter lorsque vous disposez de caractéristiques vérifiées qu'aucun autre attribut ne couvre, car Google indique qu'il aide les produits à apparaître pour des requêtes pertinentes, y compris dans AI Mode.

Combien de product highlights dois-je soumettre ?

Google en exige au moins 2, en autorise jusqu'à 100 et recommande 4 à 6 par produit. Chaque highlight peut compter jusqu'à 150 caractères.

Pourquoi Merchant Center indique-t-il que mon product_detail a un format de sous-attribut non valide ?

Le nombre de sous-attributs d'une valeur ne correspond pas à l'en-tête, généralement parce qu'il manque un deux-points dans un détail ou parce qu'une virgule ou un deux-points non entre guillemets à l'intérieur d'une valeur l'a scindé. Placez entre guillemets toute valeur contenant ces caractères et conservez deux deux-points par détail.

Dois-je utiliser les caractères turcs dans un flux en turc ?

Oui. Google accepte l'Unicode et ne recommande l'ASCII qu'à titre de préférence, tandis que ses consignes sur les highlights autorisent les lettres accentuées et demandent une orthographe correcte. Supprimer les lettres turques crée des mots mal orthographiés.

L'IA peut-elle rédiger mes product highlights ?

Elle peut en rédiger des brouillons, mais uniquement à partir de caractéristiques que vous avez confirmées, et chaque brouillon doit être vérifié pour détecter les formulations promotionnelles, les comparaisons et les fonctionnalités inventées. Google interdit les deux premières dans les highlights, et une fonctionnalité inventée n'est tout simplement qu'une donnée produit fausse.

Google Sheets prend-il en charge les valeurs product_detail entre guillemets ?

Non. Les consignes de Google sur les attributs entre guillemets indiquent que les champs entre guillemets ne sont pas pris en charge pour les sources de données Google Sheets ; il est donc préférable d'envoyer les valeurs de caractéristiques contenant des virgules ou des deux-points via un fichier TSV, du XML ou la Merchant API.

Vérifiez votre flux avant d'ajouter ces attributs

Ces attributs ne sont utiles que si les champs sur lesquels ils s'appuient sont propres. Passez votre flux dans l'outil gratuit d'audit de flux produits pour voir, produit par produit, les problèmes de complétude, de qualité et d'ordre technique avant de commencer à rédiger vos détails et vos highlights.