Comment valider le microformat hCard avec le validateur Yandex

La validation du microformat hCard nécessite l’utilisation du validateur de données structurées Yandex pour vérifier l’absence d’erreurs dans votre balisage de contact. Vous collez votre URL ou votre code dans l’outil pour confirmer que la racine vcard et les éléments obligatoires tels que fn, org et adr sont présents. Cela garantit que Yandex Business peut extraire correctement l’adresse physique et le numéro de téléphone de votre organisation pour les résultats de recherche dans les régions prises en charge comme la Russie ou le Kazakhstan.

Qu’est-ce que le validateur de données structurées Yandex ?

Le validateur de données structurées Yandex est un outil spécialisé du panneau Yandex Webmaster conçu pour vérifier comment le moteur de recherche analyse les microformats, Schema.org et d’autres balisages sémantiques. Pour hCard, il recherche spécifiquement la classe vcard et ses propriétés associées. L’utilisation de cet outil est une étape clé avant de soumettre votre site à l’indexation, car elle évite les échecs d’extraction de données qui pourraient empêcher votre entreprise d’apparaître sur les cartes ou dans les extraits de recherche locale.

Lorsque vous utilisez le validateur, vous pouvez soit fournir un lien direct vers une page en direct, soit coller un bloc de code HTML. L’outil analyse la hiérarchie de vos balises et met en évidence les champs obligatoires manquants ou les imbrications incorrectes. Ce retour immédiat permet aux développeurs de corriger les problèmes dans le code avant que le robot de Yandex ne visite le site.

Quelles sont les propriétés hCard obligatoires pour Yandex ?

Yandex a un ensemble strict d’exigences pour accepter les données d’organisation dans son annuaire d’entreprises. Si ces propriétés spécifiques sont manquantes ou mal formatées, le validateur les signalera comme des erreurs. Le moteur exige une identification claire de l’entité commerciale et un emplacement physique que les utilisateurs peuvent visiter.

• vcard : l’élément racine qui doit envelopper toutes les autres informations de contact.
• fn et org : le nom complet et le nom de l’organisation. Yandex exige qu’ils aient la même valeur.
• adr : le conteneur de l’adresse physique qui doit inclure des données de localisation détaillées.
• locality : la ville ou la localité où se trouve l’entreprise.
• tel : un numéro de téléphone valide incluant l’indicatif régional et le code pays.

L’erreur la plus courante que nous voyons est la séparation des classes fn et org. Yandex préfère qu’elles soient sur le même élément, comme une seule balise span. Ce simple ajustement résout souvent immédiatement les avertissements de validation.

Équipe SEO d’Alien Road

Pourquoi le validateur affiche-t-il des erreurs pour les propriétés imbriquées ?

Les règles de traitement du balisage pour hCard sont assez spécifiques quant à la manière dont les éléments doivent être structurés. Un problème fréquent survient lorsque les développeurs imbriquent des propriétés que le standard n’autorise pas explicitement. Par exemple, placer un numéro de téléphone (tel) à l’intérieur d’un bloc d’adresse (adr) peut entraîner un traitement incorrect. Le validateur ne parviendra souvent pas à reconnaître le numéro de téléphone s’il est enfoui dans la hiérarchie de l’adresse.

Les règles stipulent que certaines propriétés sont autorisées à être imbriquées dans la classe adr pour fournir un emplacement détaillé. Celles-ci incluent country-name, region, locality, street-address, extended-address et postal-code. Toutes les autres données, telles qu’un logo ou une adresse e-mail, doivent rester en dehors du bloc adr mais toujours à l’intérieur de la racine vcard. Suivre ces limites structurelles est un moyen sûr de garantir que vos données sont lues correctement.

Comment Alien Road applique la validation hCard

Lorsqu’Alien Road gère un projet pour un client ciblant le marché de la CEI, nous suivons un processus de vérification détaillé. Nous commençons par auditer la page de contact existante pour nous assurer que l’adresse physique correspond à celle prévue pour Yandex Business. Étant donné que Yandex ne traite ces cartes que pour la Russie, l’Ukraine, la Biélorussie et le Kazakhstan, nous confirmons d’abord la pertinence régionale de l’entreprise.

Dans le cadre d’une mission typique, par exemple pour une chaîne de vente au détail à Almaty, nous mettons en œuvre des blocs vcard séparés pour chaque succursale qui possède un numéro de téléphone unique ou une adresse spécifique. Nous utilisons la balise abbr avec l’attribut title pour les numéros de téléphone afin de garantir que le format lisible par machine est parfait tout en maintenant le texte visible convivial pour les utilisateurs. Une fois que le code est en ligne, nous le faisons passer par le validateur de données structurées Yandex et documentons le statut « valide » avant de passer à la phase suivante de la stratégie SEO.

Pouvez-vous valider plusieurs succursales sur une seule page ?

Oui, il est possible de valider plusieurs emplacements sur une seule page, mais vous devez suivre des règles spécifiques sur la façon dont ils sont regroupés. Si les succursales partagent le même nom et les mêmes coordonnées, comme un numéro de centre d’appel unique, vous pouvez lister plusieurs adresses dans une seule carte. Cependant, si les succursales ont des noms différents, des numéros de téléphone uniques ou des adresses e-mail différentes, vous devez créer un conteneur vcard séparé pour chaque emplacement.

Yandex recherche spécifiquement des adresses réelles que les personnes peuvent visiter. Valider l’adresse d’un bureau légal ou enregistré qui ne dessert pas les clients est souvent une perte de temps, car le but de ce balisage est d’aider les utilisateurs à trouver des emplacements commerciaux physiques. Lors de l’utilisation du validateur, assurez-vous que chaque vcard est distincte et contient toutes les propriétés obligatoires de manière indépendante.

Comprendre la ventilation de l’élément adr

Le composant d’adresse est l’endroit où la plupart des erreurs techniques se produisent. Pour passer la validation, l’élément adr doit être décomposé en ses parties constitutives. Fournir une seule chaîne de texte comme adresse ne suffit généralement pas pour que le moteur catégorise l’emplacement avec précision.

• country-name : le nom du pays (par exemple, le Kazakhstan).
• region : l’état ou la province, qui est requis si le nom de la localité n’est pas unique.
• locality : le nom de la ville ou de l’agglomération.
• street-address : le numéro de bâtiment spécifique et le nom de la rue.
• extended-address : des détails supplémentaires tels que le numéro de bureau, l’étage ou le nom du centre d’affaires.
• postal-code : le code postal standard pour la zone.

N’oubliez pas que Yandex Business est la destination finale pour ces données. Si votre localité n’est pas clairement définie dans la balise adr, le système peut ne pas placer votre entreprise correctement sur la carte, même si le reste du balisage est techniquement valide.

Équipe SEO d’Alien Road

Comment tester vos données de contact pour détecter les erreurs ?

Les tests impliquent un flux de travail simple dans l’interface de Yandex Webmaster. Tout d’abord, accédez à la section « Tools » et sélectionnez « Données structurées validator ». Vous verrez une zone de texte et un champ de saisie d’URL. Si vous êtes toujours en phase de développement, copiez votre extrait HTML et collez-le dans la zone de texte. Si votre site est déjà en ligne, entrez l’URL de votre page de contact.

Après avoir cliqué sur le bouton de vérification, l’outil générera un rapport. Une validation réussie affichera une coche verte ou un message indiquant que la hCard a été trouvée sans erreurs. S’il y a des problèmes, l’outil fournit une liste d’erreurs spécifiques, telles que « Missing mandatory field: org » ou « Incorrect nesting of tel ». Vous devez résoudre ces erreurs une par une jusqu’à ce que le rapport soit propre.

Par où commencer cette semaine

Commencez par auditer votre page de contact principale pour voir si un balisage hCard existe actuellement. Utilisez le validateur de données structurées Yandex pour vérifier l’état actuel de votre page. Si le validateur ne trouve aucun balisage ou identifie des erreurs, suivez ces étapes pour les résoudre :

• Enveloppez vos informations de contact dans un div avec la classe « vcard ».
• Assurez-vous que le nom de l’organisation est marqué avec les classes « fn » et « org ».
• Divisez votre adresse en sous-propriétés spécifiques telles que « locality » et « street-address ».
• Vérifiez que votre numéro de téléphone est au format international dans l’attribut title d’une balise « abbr ».
• Relancez le validateur pour confirmer que toutes les erreurs ont disparu.

Une fois la validation réussie, vous pouvez être sûr que Yandex indexera correctement l’emplacement de votre entreprise. Si vous préférez ne pas utiliser de balisage, vous pouvez également soumettre vos données via la section « Site geography » de la console Yandex Webmaster, ce qui constitue une alternative fiable pour intégrer vos coordonnées dans Yandex Business.