La première fois que j'ai ajouté un balisage de schéma à un site client, j'ai tapé un Product bloquez dans l'en-tête du thème, déployez-le et passez à l'intelligence. Deux semaines plus tard, le test des résultats riches m'a dit que l'objet de l'offre manquait le sien @type[TRADUCTION] ?Le prix était un nombre où Google voulait une chaîne, et une virgule traînante errante avait discrètement invalidé tout le bloc Google l'avait ignoré tout le temps C'est la chose dont personne ne vous met en garde avec des données structurées : JSON-LD non valide ne lance pas d'erreur et ne rend rien rouge Cela ne fait rien silencieusement, et vous le découvrez des mois plus tard lorsque le résultat riche sur lequel vous comptiez n'apparaît jamais.
Le vocabulaire lui-même est publié à l'adresse schéma.orget ce pour quoi Google affichera en fait un résultat riche, c'est une liste plus étroite documentation de données structurées.
Je construis des outils pour un vivant - Toolz.dev, le plugin WP Adminify, une pile d'applications Laravel et React - et les données structurées sont l'une de ces tâches que je fais assez souvent pour en vouloir à la main et rarement assez pour oublier les noms exacts de propriétés à chaque fois J'ai donc construit le Générateur de balisage de schéma pour supprimer les deux modes de défaillance qui me coûtent le plus cher : une imbrication erronée et une invalidité silencieuse Ce guide passe en revue ce que fait réellement le balisage de schéma, comment le générateur le construit et les erreurs spécifiques qui empêchent le balisage d'apparence valide d'obtenir des résultats riches.
tl;dr : Le balisage de schéma est une donnée structurée (utilisant le vocabulaire schéma.org) qui indique aux moteurs de recherche exactement de quoi parle une page, ce qui la rend éligible à des résultats riches comme les accordéons FAQ, les prix des produits et la chapelure Google recommande le format JSON-LD - un format autonome
<script type="application/ld+json">bloc. Le générateur construit un JSON-LD valide pour neuf types courants, niche des sous-objets commePostalAddressetOffercorrectement, les indicateurs manquent les champs obligatoires et recommandés et s'exécutent à 100 % dans votre navigateur afin que rien de ce que vous tapez ne soit téléchargé.
Qu'est-ce que le balisage de schéma, et pourquoi est-ce important ?
Le balisage de schéma est une façon standardisée de décrire le contenu d'une page afin que les machines puissent le comprendre, pas seulement le restituer Le vocabulaire provient de schema.org, un projet partagé soutenu par Google, Microsoft, Yahoo et Yandex Lorsque vous marquez une page comme un Article" ; c'est une actualité ou un article de blog, voici son titre, voici qui l'a écrit, voici quand il a été publié." ; Cette description structurée est ce qui rend une page éligible à des résultats riches - les listes améliorées avec des notes d'étoiles, des prix, des réductions de FAQ, des dates d'événements et des traces de chapelure qui prennent plus d'espace et gagnent plus de clics qu'un simple lien bleu.
La raison pour laquelle cela compte a changé au cours des dernières années, Il était avant uniquement question de résultats riches dans Google Maintenant les données structurées alimentent également les moteurs de réponse d'IA et Google' ; s A I Overviews. Quand ChatGPT, Perplexity, ou Gemini essayent de résumer ce que votre entreprise fait ou quel produit correspond à une requête, les données structurées propres sont l'un des signaux qui les aide à obtenir les faits corrects Une page qui se déclare clairement une Organization avec un nom, un logo et des profils sociaux, il est beaucoup plus facile pour n'importe quelle machine de raisonner qu'une machine qui laisse tout implicite dans le HTML.
Le piège est que les données structurées ne sont pas impitoyables C'est du code, et le code doit être exactement correct Une propriété orthographiée datePublish au lieu de datePublished est tout simplement ignoré Un Offer sans un @type n'est pas reconnu comme une offre Et parce qu'aucune de ces erreurs ne casse la page visible, ils se cachent indéfiniment en production C'est la lacune qu'un générateur comble - ne pas écrire les concepts pour vous, mais obtenir la syntaxe et la structure juste à chaque fois.
Pourquoi JSON-LD au lieu de Microdata ou RDFa ?
Il existe trois façons d'ajouter des données Schema.org à une page, et cela permet de comprendre pourquoi le générateur n'en produit qu'une seule.
Microdonnées et RDFa tissez les données structurées directement dans votre HTML visible à l'aide d'attributs supplémentaires - itemscope, itemprop, property, et ainsi de suite. Votre <div> pour une revue de produit gagne des attributs qui étiquettent chaque morceau de texte visible Cela fonctionne, mais il couple étroitement votre balisage à votre structure de page Changez la mise en page et vous risquez de casser le schéma Il est également verbeux et difficile à lire.
JSON-LD adopte l'approche inverse Il met toutes les données structurées dans un seul autonome <script type="application/ld+json"> bloc, généralement dans le <head>[TRADUCTION], complètement séparé du HTML visible Google recommande JSON-LD depuis des années précisément à cause de cette séparation : vous pouvez l'ajouter, le mettre à jour ou l'injecter par l'intermédiaire d'un gestionnaire de balises sans toucher à vos modèles C'est le format qu'enseigne chaque didacticiel de schéma moderne, et c'est ce que génère le générateur.
| format | Où il vit | Facilité d'entretien | Position de Google's |
|---|---|---|---|
| JSON-LD | Simple <script> bloc, séparé du HTML |
Le plus simple - modifier un bloc | recommandé |
| Microdonnées | Attributs dans HTML visible | Plus dur - couplé à la disposition | soutenu |
| RDFa | Attributs dans HTML visible | Plus dur - couplé à la disposition | soutenu |
Si vous travaillez dans WordPress, JSON-LD est aussi ce que la plupart des plugins SEO injectent, et ce qu'un outil comme WP Adminify se trouve à côté proprement Parce qu'il s'agit d'un bloc autonome, vous pouvez le générer ici et le coller dans un champ HTML personnalisé, un gestionnaire de balises ou une disposition Laravel Blade sans aucune gymnastique spécifique au framework.
Comment utiliser le générateur de balisage de schéma ?
Le flux de travail est construit autour de la sélection d'un type et du remplissage d'un formulaire court, avec un aperçu en direct afin que vous voyiez le JSON-LD s'assembler au fur et à mesure que vous tapez.
Étape 1 - Choisissez un type de schéma. Choisissez parmi Organisation, LocalBusiness, WebSite, Article, Produit, FAQPage, BreadcrumbList, Person, or Event Le formulaire passe immédiatement aux champs qui tapent les besoins Ces neuf couvrent l'écrasante majorité de ce pour quoi les sites de petite et moyenne taille ont réellement besoin d'être balisés.
Étape 2 - Remplissez les champs. Les champs obligatoires sont marqués d'un astérisque Au fur et à mesure que vous tapez, l'outil assemble le JSON-LD et supprime n'importe quel champ que vous laissez vide, de sorte que vous ne vous retrouvez jamais vide "" propriétés polluant la sortie. Pour les types basés sur l'adresse comme LocalBusiness et Event, les champs d'adresse individuels sont regroupés dans un fichier correctement tapé PostalAddress objet automatiquement.
Étape 3 - Regardez la validation. Le générateur signale deux sortes de problèmes Les erreurs (champs obligatoires manquants, URL mal formées) bloquent un résultat propre et sont affichées en rouge. Avertissements (champs recommandés par Google manquants comme image ou datePublished(ou un modèle d'URL de recherche manquant son espace réservé) sont affichés en ambre - le balisage est toujours valide, mais vous laissez un potentiel de résultat riche sur la table.
Étape 4 - Copiez et déployez. Basculer entre le plein <script> étiquette (prêt à coller dans votre <head>) et le JSON brut (pour les gestionnaires de balises et les champs CMS).La sortie du script échappe aux caractères qui autrement laisseraient un égaré </script> dans vos données, cassez la page. Puis validez la page en direct avec Google' ; s Rich Results Test.
Parce que tout fonctionne côté client, cela peut être utilisé en toute sécurité sur les pages de produits non publiées, les environnements de mise en scène et le travail client sous NDA. Vos prix, détails d'événement et URL internes ne quittent jamais le navigateur - la même position de confidentialité derrière chaque outil du site, dont j'ai parlé dans le Guide de confidentialité des données.
Quels types de schémas dois-je réellement utiliser ?
Toutes les pages n'ont pas besoin de balisage, et empiler les types que vous ne pouvez pas prendre en charge est pire que rien. Voici comment je pense aux neuf couverts par le générateur.
Organisation appartient sur votre page d'accueil ou sur une page d'information - c'est le schéma qui alimente les panneaux de connaissances et aide Google à connecter votre marque à ses profils sociaux via sameAs. Site Web s'associe à lui et peut déclarer une zone de recherche de liens de situation via a SearchAction(en), permettant aux utilisateurs de rechercher votre site directement à partir de la page de résultats. Affaires locales est essentiel si vous avez un emplacement physique : il transporte votre adresse, votre téléphone, votre fourchette de prix et vos heures d'ouverture, et il sous-tend les résultats des packs et des cartes locaux.
Article (avec lequel le générateur émet Article type, également valable pour les articles de blog) marque le contenu éditorial avec un titre, un auteur, un éditeur et des dates de publication. Produit décrit quelque chose à vendre, avec un imbriqué Offer prix de portage, devise et disponibilité - c'est ce qui alimente les extraits de prix et de disponibilité. Événement couvre tout ce qui a une date et un lieu, d'une conférence à un webinaire.
FAQPage et Liste de fil d'Ariane sont structurels plutôt que sur un " ; thing." ; FAQPage marque le contenu des questions et réponses ; notez que Google a limité les résultats riches de la FAQ aux sites gouvernementaux et de santé faisant autorité, mais le balisage aide toujours d'autres moteurs de recherche et moteurs de réponses IA à analyser votre Q& ; A. BreadcrumbList produit la piste de chapelure indiquée sous votre titre dans les résultats, ce qui améliore la lecture de votre structure d'URL. Personne marque une personne - un auteur, un fondateur ou une personnalité publique - et est utile pour les biographies des auteurs et les signaux EEAT.
La règle que je suis : marquer ce que la page est véritablement au sujet, et seulement revendiquer des propriétés qui reflètent le contenu réellement visible sur la page. Google' ; les directives sont explicites que les données structurées doivent décrire le contenu réel et visible - marquer un prix qui n'apparaît pas sur la page est une violation, pas un raccourci.
Comment le générateur maintient-il la validation du balisage ?
La valeur est dans les détails qui sont faciles à se tromper à la main Quelques-uns qui valent la peine d'appeler.
Emboîtement correct avec @type. Dans JSON-LD, les objets imbriqués ne sont pas des sous-objets simples - chacun a besoin du sien @type. Une adresse est une PostalAddress, une offre est un Offer, un article' ;s auteur est un Person: son éditeur est un Organization dont le logo est un ImageObject. Le générateur construit chacun d'entre eux avec le bon type afin que l'analyseur les reconnaisse au lieu de les traiter comme des blobs anonymes.
L'élagage se vide. Laisser un champ vide devrait supprimer la propriété, pas émettre "telephone": "". Les chaînes vides et les tableaux vides sont automatiquement supprimés de la sortie, donc ce que vous copiez est toujours propre.
S'échapper en toute sécurité. Le personnage le plus dangereux du JSON-LD en ligne est un < - spécifiquement la séquence </script> apparaissant à l'intérieur de vos données (disons, dans une description), ce qui mettrait fin au bloc de script plus tôt et briserait la page Le générateur s'échappe <, >, et & dans la sortie de la balise de script utilisant des échappements Unicode, ce qui est exactement ce que fait Google' ; ses propres exemples.
Sensibilisation requise et recommandée. Chaque type porte sa propre liste de ce que Google exige par rapport aux recommandations. L'article veut vraiment un image et datePublished; Le produit veut un price; L'événement a besoin d'un startDate. L'outil distingue les exigences strictes (qu'il traite comme des erreurs) des recommandations (avertissements), afin que vous connaissiez la différence entre " ; cela ne fonctionnera pas et ne suffira pas ; et " ; cela pourrait mieux fonctionner." ;
Si vous assemblez un flux de travail technique plus large, le générateur de schémas se situe naturellement aux côtés des autres utilitaires SEO - le Générateur de balises pour votre titre, description, et Open Graph tags, et le Générateur de sitemap XML pour la soumission de vos URLs Ensemble ils couvrent la plupart de la surface de référencement technique sur la page, et je les ai regroupés pour cette raison dans le présentation de la boîte à outils des développeurs Web.
Comment tester et déployer des données structurées ?
Générer un JSON-LD valide représente la moitié du travail ; l'autre moitié confirme que Google le lit comme vous le souhaitez.
Commencez par Google' ;s Test de résultats riches(en), qui récupère une URL ou accepte le code collé et signale pour quels types de résultats riches la page est admissible, ainsi que toutes les erreurs ou avertissements. Ensuite, exécutez le même balisage à travers le Validateur de balisage de schéma chez validator.schema.org, qui vérifie la conformité au vocabulaire schema.org lui-même plutôt qu'aux exigences de résultats riches de Google' ; Les deux attrapent des choses différentes : le test de résultats riches vous indique si vous êtes admissible à une fonctionnalité Google spécifique, tandis que le validateur vous indique si le balisage est structurellement solide.org.
Une fois la page en ligne, l'amélioration est signalée Console de recherche Google suivez les performances au fil du temps et signalez les erreurs que Google trouve lors de l'exploration. C'est ici que vous rencontrez des problèmes qui n'apparaissent qu'à grande échelle - un modèle qui émet des positions de fil d'Ariane en double, par exemple, ou un flux de produit qui omet parfois un champ requis.
Pour le déploiement, collez le <script> bloquer dans le <head> de la page spécifique qu'il décrit Ne mettez pas un seul bloc Produit dans un modèle global qui s'exécute sur chaque page - le balisage doit correspondre à la page sur laquelle il vit Dans un CMS, utilisez n'importe quel champ personnalisé-HTML ou SEO que la plateforme vous donne Dans un gestionnaire de balises, utilisez une balise HTML personnalisée et copiez le JSON Dans une application React ou Laravel, injectez le bloc côté serveur afin que les robots le voient dans le HTML initial plutôt qu'après hydratation.
Des erreurs courantes que je vois encore
Une poignée d'erreurs apparaissent encore et encore, et chacune d'entre elles produit un balisage qui semble bien mais ne fait rien.
Le classique est marquage de contenus invisibles - l'ajout d'une note d'évaluation ou d'un prix qui n'apparaît nulle part sur la page Google l'interdit explicitement et peut émettre une action manuelle pour cela La seconde est le mauvais type sur un objet imbriqué, généralement un disparu @type sur une adresse ou une offre La troisième est confondre des types similaires, comme utiliser Product balisage sur une page de liste de catégories plutôt que sur un seul produit Et le quatrième, mon ennemi personnel, est une erreur de syntaxe issue de l'édition manuelle - une virgule traînante ou une citation non échappée qui invalide le bloc entier.
Chacun de ces éléments est la raison pour laquelle un générateur gagne sa garde Il ne peut pas savoir si votre prix est visible sur la page - qui est sur vous - mais il n'émettra jamais une virgule traînante, un manquant @type(en), ou une propriété vide Cela seul supprime la plupart des façons dont les données structurées échouent silencieusement Pour un arrière-plan plus profond sur les workflows des développeurs autour de ce genre d'outillage, le Guide des outils de codage est un bon compagnon lu.
Questions fréquentes
Qu'est-ce que le balisage de schéma ?
Le balisage de schéma est une donnée structurée qui décrit une page' ; s contenu aux moteurs de recherche utilisant le vocabulaire partagé de schéma.org.L'ajout peut rendre une page éligible à des résultats riches tels que les accordéons FAQ, les prix des produits, les étoiles de révision et la chapelure JSON-LD, le format produit par cet outil, est la syntaxe recommandée par Google car elle vit dans une seule balise de script distincte de votre HTML visible.
Quelle est la différence entre JSON-LD, les microdonnées et la RDFA ?
Les trois sont des moyens d'ajouter des données structurées de schema.org à une page. Les microdonnées et RDFA sont des attributs tissés dans votre HTML visible, tandis que JSON-LD est un bloc de JSON autonome dans une balise de script. Google recommande JSON-LD car il est plus facile d'ajouter, de mettre à jour et de rester séparé du balisage de la page. Cet outil génère JSON-LD pour cette raison.
Où puis-je mettre le JSON-LD généré ?
Coller le plein <script type="application/ld+json"> tag dans le <head> de la page qu'il décrit, ou n'importe où dans le <body> - Google le lit dans l'un ou l'autre endroit Si vous utilisez Google Tag Manager, copiez le JSON et ajoutez-le via une balise HTML personnalisée Placez toujours le balisage sur la même page dont il décrit le contenu, pas un modèle qui l'applique partout.
L'ajout de balises de schéma garantit-il de riches résultats ?
non . Les données structurées valides rendent une page éligible aux résultats riches, mais Google décide de les afficher en fonction de la qualité, de la pertinence et de ses propres directives. Votre balisage doit également refléter le contenu qui est réellement visible sur la page. Considérez le schéma comme une exigence pour des résultats riches, pas comme un commutateur qui les allume.
Comment tester mes données structurées ?
Exécutez le balisage généré via Google' ; s Rich Results Test et le Schema Markup Validator (schema.org' ; s validator).Aux deux, analysez votre JSON-LD et signalez les champs obligatoires manquants ou les erreurs de syntaxe Une fois la page en ligne, les rapports d'amélioration de Google Search Console suivent les performances de vos données structurées au fil du temps.
Quels champs sont requis pour chaque type ?
Les exigences varient selon le type : l'article a besoin d'un titre, un nom de produit, un événement a besoin d'un nom et d'une date de démarrage, et la page de FAQ a besoin d'au moins une question et une réponse. Cet outil marque les champs et les blocs obligatoires jusqu'à leur remplissage, tout en avertissant les champs recommandés qui améliorent vos chances d'obtenir un résultat riche.
Puis-je générer un schéma de FAQ pour ma page ?
Oui. Choisissez le type de FAQPage, ajoutez chaque question avec sa réponse, et l'outil crée automatiquement le tableau principal des objets de questions et réponses. Notez que Google Now affiche des résultats riches en FAQ principalement pour les gouvernements et les sites de santé faisant autorité, mais le balisage reste valide et utile pour les autres moteurs de recherche et moteurs de réponses AI.
Mes données sont-elles privées ?
Oui. Le JSON-LD est entièrement assemblé dans votre navigateur avec du JavaScript simple. Rien de ce que vous tapez - y compris les prix non publiés, les détails de l'événement ou les URL privées - n'est transmis, enregistré ou stocké, et le générateur continue de fonctionner sans connexion réseau une fois chargé.
