Données structurées des recettes (Recipe
, HowTo
, ItemList
)
Ajoutez des données structurées à vos recettes pour aider les utilisateurs à trouver plus facilement vos créations culinaires sur Google. Lorsque vous spécifiez des détails tels que les avis des contributeurs, les temps de préparation et de cuisson, et les informations nutritionnelles, Google est plus à même de présenter votre recette aux internautes de façon intéressante. Les recettes peuvent apparaître dans les résultats de recherche Google et dans Google Images.
Selon le balisage de votre contenu, vos recettes peuvent également bénéficier des améliorations suivantes :
Améliorations spécifiques aux recettes | |
---|---|
Carrousel hôte de recettes : aidez les utilisateurs à explorer les pages de votre galerie de recettes en ajoutant des données structurées ItemList . |
Comment ajouter des données structurées
Ces données structurées représentent un format normalisé permettant de fournir des informations sur une page et de classer son contenu. En savoir plus sur le fonctionnement des données structurées
Voici, dans les grandes lignes, comment créer, tester et publier des données structurées. Pour consulter un guide détaillé sur l'ajout de données structurées à une page Web, accédez à cet atelier de programmation.
- Ajoutez les propriétés obligatoires. En fonction du format que vous utilisez, découvrez où insérer des données structurées sur la page.
- Suivez les consignes.
- Validez votre code à l'aide de l'outil de test des résultats enrichis et corrigez les erreurs critiques, le cas échéant. Envisagez également de résoudre les problèmes non critiques que l'outil a pu signaler, car cela peut contribuer à améliorer la qualité de vos données structurées. Toutefois, ce n'est pas nécessaire pour pouvoir bénéficier des résultats enrichis.
- Déployez quelques pages où figurent vos données structurées et utilisez l'outil d'inspection d'URL pour découvrir comment Google voit la page. Assurez-vous que Google peut accéder à votre page et qu'elle n'est pas bloquée par un fichier robots.txt, la balise
noindex
ni par des identifiants de connexion. Si tout semble être en ordre, vous pouvez demander à Google d'explorer de nouveau vos URL. - Pour informer Google des modifications futures de vos pages, nous vous recommandons de nous envoyer un sitemap. Vous pouvez automatiser cette opération à l'aide de l'API Sitemap de la Search Console.
Exemples
Voici quelques exemples de recettes au format JSON-LD.
Recette dans la recherche Google
Voici un exemple de page pouvant apparaître dans la recherche Google.
<html> <head> <title>Non-Alcoholic Piña Colada</title> <script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "Recipe", "name": "Non-Alcoholic Piña Colada", "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "author": { "@type": "Person", "name": "Mary Stone" }, "datePublished": "2024-03-10", "description": "This non-alcoholic pina colada is everyone's favorite!", "recipeCuisine": "American", "prepTime": "PT1M", "cookTime": "PT2M", "totalTime": "PT3M", "keywords": "non-alcoholic", "recipeYield": "4 servings", "recipeCategory": "Drink", "nutrition": { "@type": "NutritionInformation", "calories": "120 calories" }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": 5, "ratingCount": 18 }, "recipeIngredient": [ "400ml of pineapple juice", "100ml cream of coconut", "ice" ], "recipeInstructions": [ { "@type": "HowToStep", "name": "Blend", "text": "Blend 400ml of pineapple juice and 100ml cream of coconut until smooth.", "url": "https://example.com/non-alcoholic-pina-colada#step1", "image": "https://example.com/photos/non-alcoholic-pina-colada/step1.jpg" }, { "@type": "HowToStep", "name": "Fill", "text": "Fill a glass with ice.", "url": "https://example.com/non-alcoholic-pina-colada#step2", "image": "https://example.com/photos/non-alcoholic-pina-colada/step2.jpg" }, { "@type": "HowToStep", "name": "Pour", "text": "Pour the pineapple juice and coconut mixture over ice.", "url": "https://example.com/non-alcoholic-pina-colada#step3", "image": "https://example.com/photos/non-alcoholic-pina-colada/step3.jpg" } ], "video": { "@type": "VideoObject", "name": "How to Make a Non-Alcoholic Piña Colada", "description": "This is how you make a non-alcoholic piña colada.", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "contentUrl": "https://www.example.com/video123.mp4", "embedUrl": "https://www.example.com/videoplayer?video=123", "uploadDate": "2024-02-05T08:00:00+08:00", "duration": "PT1M33S", "interactionStatistic": { "@type": "InteractionCounter", "interactionType": { "@type": "WatchAction" }, "userInteractionCount": 2347 }, "expires": "2024-02-05T08:00:00+08:00" } } </script> </head> <body> </body> </html>
Carrousel
Voici un exemple de page récapitulant des recettes (page contenant une liste de recettes) avec des données structurées itemList
. Ce contenu peut s'afficher sous forme de grille dans les résultats de recherche.
<html> <head> <title>Grandma's Best Pie Recipes</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "ItemList", "itemListElement": [ { "@type": "ListItem", "position": 1, "url": "https://example.com/apple-pie.html" }, { "@type": "ListItem", "position": 2, "url": "https://example.com/blueberry-pie.html" }, { "@type": "ListItem", "position": 3, "url": "https://example.com/cherry-pie.html" }] } </script> </head> <body> </body> </html>
Consignes
Pour que votre balisage puisse s'afficher dans les résultats de recherche, vous devez respecter les consignes générales relatives aux données structurées.
Les consignes suivantes s'appliquent aux données structurées Recipe
.
- Utilisez des données structurées
Recipe
pour le contenu ayant trait à la préparation d'un plat particulier. Par exemple, "gommage du visage" ou "idées de fête" ne sont pas des noms valables pour un plat. - Pour que vos recettes apparaissent dans un carrousel ou dans une grille, vous devez respecter les consignes suivantes :
- Fournissez des données structurées
ItemList
pour récapituler les recettes que vous voulez ajouter à la liste. Vous pouvez fournir des données structuréesItemList
séparément ou avec des données structurées de recette. - Votre site doit contenir une page récapitulative qui répertorie toutes les recettes de la collection. Par exemple, lorsqu'un internaute clique sur le lien de la page récapitulative dans les résultats de recherche, il doit être redirigé vers une page de votre site répertoriant les recettes associées à sa recherche.
- Fournissez des données structurées
Définitions des types de données structurées
Vous devez inclure les propriétés obligatoires pour que votre contenu puisse s'afficher sous forme de résultat enrichi dans la recherche Google. Vous pouvez également inclure les propriétés recommandées pour ajouter d'autres informations à votre contenu et ainsi offrir une meilleure expérience utilisateur.
Recipe
Balisez le contenu de votre recette avec les propriétés suivantes du type schema.org Recipe
. La définition complète de Recipe
est disponible sur schema.org/Recipe.
Les propriétés prises en charge par Google sont les suivantes :
Propriétés obligatoires | |
---|---|
image
|
Image du plat terminé. Consignes supplémentaires relatives aux images :
Exemple : "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ] |
name |
Nom du plat. |
Propriétés recommandées | |
---|---|
aggregateRating |
Annotation désignant la note moyenne attribuée à l'élément. Respectez les Consignes relatives aux extraits d'avis ainsi que la liste des propriétés Si les données structurées |
author |
Nom de la personne ou de l'organisation qui a rédigé la recette. Pour aider Google à interpréter les auteurs dans différentes fonctionnalités, envisagez de suivre les bonnes pratiques en matière de balisage des auteurs. |
cookTime |
Temps de cuisson du plat, au format ISO 8601, le cas échéant. Utilisez toujours cette propriété conjointement avec |
datePublished |
Date à laquelle la recette a été publiée au format ISO 8601, le cas échéant. |
description |
Brève description du plat. |
keywords
|
Autres termes liés à la recette tels que la saison ("été"), l'occasion spéciale ("Halloween") ou d'autres descripteurs ("rapide", "facile", "authentique"). Consignes supplémentaires
|
nutrition.calories |
Nombre de calories de chaque portion pour cette recette. Si |
prepTime |
Temps de préparation des ingrédients et de l'espace de travail pour le plat, au format ISO 8601, le cas échéant. Utilisez toujours cette propriété conjointement avec |
recipeCategory |
Type de repas ou de plat dont la recette fait l'objet. Exemple : "dîner", "plat principal" ou "dessert, collation". |
recipeCuisine |
Région associée à la recette. Par exemple, "France", "Méditerranée" ou 'États-Unis". |
recipeIngredient |
Un des ingrédients utilisés dans la recette. Exemple : "recipeIngredient": [ "1 (15 ounce) package double crust ready-to-use pie crust", "6 cups thinly sliced, peeled apples (6 medium)", "3/4 cup sugar", "2 tablespoons all-purpose flour", "3/4 teaspoon ground cinnamon", "1/4 teaspoon salt", "1/8 teaspoon ground nutmeg", "1 tablespoon lemon juice" ] Consignes supplémentaires :
|
recipeInstructions
|
Étapes de préparation du plat. Plusieurs options permettent de définir la valeur de
Consignes supplémentaires
|
recipeYield |
La quantité produite par la recette, le cas échéant. Indiquez le nombre de portions que cette recette permet de préparer. Si vous souhaitez utiliser une autre unité (par exemple, le nombre d'éléments), vous pouvez inclure des champs supplémentaires. Cela est obligatoire si vous spécifiez des informations nutritionnelles par portion (par exemple, Exemple "recipeYield": [ "6", "24 cookies" ] |
totalTime |
Temps total de préparation du plat, au format ISO 8601, le cas échéant. Utilisez |
video
|
VideoObject
Vidéo illustrant les étapes de préparation du plat. Respectez la liste des propriétés vidéo obligatoires et recommandées. |
HowToSection
Utilisez HowToSection
pour regrouper une séquence d'étapes (ou de sous-sections) qui font partie des instructions d'une recette. Spécifiez HowToSection
directement dans la définition de la propriété recipeInstructions
ou comme itemListElement
d'une autre propriété HowToSection
.
Le type HowToSection
définit une section d'une recette unique et contient une ou plusieurs étapes. N'utilisez pas HowToSection
pour définir différentes recettes pour un même plat. HowToSection
est destiné à une seule et même recette. Si vous souhaitez répertorier plusieurs recettes pour un même plat, utilisez plusieurs objets Recipe
. Par exemple, pour spécifier plusieurs façons de préparer une tarte aux pommes, répertoriez-les comme plusieurs objets Recipe
, et non comme des objets HowToSection
.
La définition complète de la propriété HowToSection
est disponible sur schema.org/HowToSection.
Propriétés obligatoires | |
---|---|
itemListElement
|
HowToStep
Liste des étapes détaillées de la section et/ou des sous-sections. Par exemple, une recette de pizza peut comporter un ensemble d'étapes pour la préparation de la pâte, un autre pour la préparation de la garniture, puis un autre pour expliquer comment cuire la pâte et la garniture ensemble. Exemple { "@type": "HowToSection", "name": "Assemble the pie", "itemListElement": [ { "@type": "HowToStep", "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate." }, { "@type": "HowToStep", "text": "Top with second crust. Cut slits or shapes in several places in top crust." } ] } |
name
|
Text
Nom de la section. |
HowToStep
Utilisez HowToStep
pour regrouper une ou plusieurs phrases expliquant comment réaliser une partie de la recette, si cela est pertinent pour votre contenu. Spécifiez la propriété text
avec les phrases ou, alternativement, définissez itemListElement
avec un élément HowToDirection
ou HowToTip
pour chaque phrase.
Vous pouvez baliser les étapes de la recette avec les propriétés suivantes de type HowToStep. Spécifiez un élément HowToStep
directement dans la définition de la propriété recipeInstructions
ou comme élément itemListElement
d'une propriété HowToSection
.
La définition complète de la propriété HowToStep
est disponible sur schema.org/HowToStep.
Propriétés obligatoires | |
---|---|
itemListElement
|
HowToDirection ou HowToTip
Liste d'étapes secondaires détaillées comprenant des instructions ou des conseils. Propriété facultative si l'élément |
text
|
Text
Instructions écrites complètes de cette étape. Propriété facultative si l'élément
|
Propriétés recommandées | |
---|---|
image
|
ImageObject ou URL
Image représentant l'étape. Consignes supplémentaires relatives aux images :
|
name
|
Text
Mot ou courte expression résumant l'étape (par exemple, "Disposer la pâte à tarte"). N'utilisez pas de texte non descriptif (par exemple, "Étape 1 : [texte]") ni d'autre forme de numérotation d'étape (par exemple, "1. [texte]"). |
url
|
URL
|
video
|
VideoObject ou Clip
Vidéo représentant cette étape ou clip de la vidéo. Pour |
HowToDirection
et HowToTip
Utilisez HowToDirection
et HowToTip
pour décrire des instructions ou des conseils, le cas échéant.
Leurs propriétés obligatoires et facultatives sont identiques.
Les définitions complètes des éléments HowToDirection
et HowToTip
sont disponibles sur schema.org/HowToDirection et schema.org/HowToTip.
Propriétés obligatoires | |
---|---|
text
|
Text
Texte de l'instruction ou du conseil. |
ItemList
Outre les propriétés de recette, ajoutez les propriétés suivantes pour les listes spécifiques à l'hôte. Bien que ItemList
ne soit pas obligatoire, vous devez ajouter les propriétés suivantes si vous souhaitez que votre recette puisse s'afficher dans un carrousel hôte. Pour plus d'informations sur le carrousel hôte, consultez la section Carrousel.
La définition complète de l'élément ItemList
est disponible sur schema.org/ItemList.
Propriétés obligatoires | |
---|---|
itemListElement
|
Annotation pour une page d'élément. |
ListItem.position
|
Position ordinale de la page d'élément dans la liste. Exemple : "itemListElement": [ { "@type": "ListItem", "position": 1, }, { "@type": "ListItem", "position": 2, } ] |
ListItem.url
|
URL canonique de la page d'élément. Chaque élément doit avoir une URL unique. |
Suivre les résultats enrichis avec la Search Console
La Search Console est un outil qui vous permet de suivre les performances de vos pages dans la recherche Google. Il n'est pas nécessaire de vous inscrire à la Search Console pour figurer dans les résultats de recherche Google. Cependant, en vous inscrivant, vous comprendrez mieux la façon dont Google interprète votre site et serez plus à même de l'améliorer. Nous vous recommandons de consulter la Search Console dans les cas suivants :
- Après avoir déployé des données structurées pour la première fois
- Après avoir publié de nouveaux modèles ou après avoir mis à jour votre code
- Lors des analyses régulières du trafic
Après avoir déployé des données structurées pour la première fois
Une fois que Google a indexé vos pages, recherchez les problèmes à l'aide du rapport sur l'état des résultats enrichis. Idéalement, il y aura une augmentation du nombre d'articles valides et pas d'augmentation du nombre d'articles non valides. Si vous détectez des problèmes au niveau des données structurées :
- Corrigez les éléments non valides.
- Inspectez une URL active pour vérifier si le problème persiste.
- Demandez la validation à l'aide du rapport d'état.
Après avoir publié de nouveaux modèles ou après avoir mis à jour votre code
Lorsque vous apportez des modifications importantes à votre site Web, surveillez l'augmentation des éléments non valides dans les données structurées.- Si vous constatez une augmentation du nombre d'éléments non valides, vous avez peut-être déployé un nouveau modèle qui ne fonctionne pas, ou votre site interagit différemment et de façon incorrecte avec le modèle déjà disponible.
- Si vous constatez une diminution du nombre d'éléments valides (sans augmentation du nombre d'éléments non valides), vous n'intégrez peut-être plus de données structurées dans vos pages. Utilisez l'outil d'inspection d'URL pour identifier la cause du problème.
Lors des analyses régulières du trafic
Analysez votre trafic de recherche Google à l'aide du rapport sur les performances. Les données indiquent la fréquence à laquelle votre page s'affiche en tant que résultat enrichi dans la recherche Google, ainsi que la fréquence à laquelle les internautes cliquent dessus et la position moyenne à laquelle vous apparaissez dans les résultats de recherche. Vous pouvez également extraire automatiquement ces résultats avec l'API Search Console.Troubleshooting
If you're having trouble implementing or debugging structured data, here are some resources that may help you.
- If you're using a content management system (CMS) or someone else is taking care of your site, ask them to help you. Make sure to forward any Search Console message that details the issue to them.
- Google does not guarantee that features that consume structured data will show up in search results. For a list of common reasons why Google may not show your content in a rich result, see the General Structured Data Guidelines.
- You might have an error in your structured data. Check the list of structured data errors and the Unparsable structured data report.
- If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix structured data issues, use the Manual Actions report.
- Review the guidelines again to identify if your content isn't compliant with the guidelines. The problem can be caused by either spammy content or spammy markup usage. However, the issue may not be a syntax issue, and so the Rich Results Test won't be able to identify these issues.
- Troubleshoot missing rich results / drop in total rich results.
- Allow time for re-crawling and re-indexing. Remember that it may take several days after publishing a page for Google to find and crawl it. For general questions about crawling and indexing, check the Google Search crawling and indexing FAQ.
- Post a question in the Google Search Central forum.