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.

L'illustration représente comment les résultats enrichis sur les recettes peuvent apparaître dans la recherche Google. Elle inclut quatre résultats enrichis issus de différents sites Web, qui intègrent des informations sur le temps de préparation de la recette, une image et des avis. L'illustration représente comment une recette peut apparaître dans Google Images. Six résultats d'images affichent différents aliments, et trois de ces résultats contiennent un badge de recette indiquant à l'utilisateur qu'il s'agit d'une recette.

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. L'illustration représente comment un carrousel hôte de recettes peut apparaître dans la recherche Google. Elle montre trois recettes différentes du même site Web sous forme de carrousel que les utilisateurs peuvent explorer pour sélectionner une recette spécifique.

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.

  1. 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.
  2. Suivez les consignes.
  3. 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.
  4. 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.
  5. 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>

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ées ItemList 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.

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

URL ou ImageObject

Image du plat terminé.

Consignes supplémentaires relatives aux images :

  • Les URL des images doivent être explorables et indexables. Pour vérifier si Google peut accéder à vos URL, utilisez l'outil d'inspection d'URL.
  • Les images doivent représenter le contenu balisé.
  • Le format des fichiers images doit être compatible avec Google Images.
  • Pour de meilleurs résultats, nous vous recommandons de fournir plusieurs images haute résolution (minimum 50 000 pixels lorsque vous multipliez la largeur et la hauteur) dans l'un des formats suivants : 16x9, 4x3 et 1x1.

Exemple :

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
name

Text

Nom du plat.
Propriétés recommandées
aggregateRating

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ésAggregateRating obligatoires et recommandées.

Si les données structurées Recipe contiennent un seul avis, le nom de son auteur doit correspondre à une personne, ou à une organisation ou entreprise valide. Par exemple "50 % de remise sur les ingrédients" n'est pas un nom valide.
author

Person ou Organization

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

Duration

Temps de cuisson du plat, au format ISO 8601, le cas échéant.

Utilisez toujours cette propriété conjointement avec prepTime.

datePublished

Date

Date à laquelle la recette a été publiée, au format ISO 8601, le cas échéant.
description

Text

Brève description du plat.
keywords

Text

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

  • Séparez plusieurs entrées d'une liste de mots clés par des virgules.
  • N'utilisez pas de balise correspondant à recipeCategory ou recipeCuisine.

    Approche déconseillée :

    "keywords": "dessert, American"

    Approche conseillée :

    "keywords": "winter apple pie, nutmeg crust"
nutrition.calories

Energy

Nombre de calories de chaque portion pour cette recette. Si nutrition.calories est spécifié, recipeYield doit être défini avec le nombre de portions.
prepTime

Duration

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 cookTime.
recipeCategory

Text

Type de repas ou de plat dont la recette fait l'objet. Exemple : "dîner", "plat principal" ou "dessert, collation".
recipeCuisine

Text

Région associée à la recette. Par exemple, "France", "Méditerranée" ou 'États-Unis".
recipeIngredient

Text

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 :

  • Incluez uniquement le texte de l'ingrédient nécessaire à la préparation de la recette.
  • N'incluez pas d'informations inutiles, telles que la définition de l'ingrédient.
recipeInstructions

HowToStep, HowToSection ou Text

Étapes de préparation du plat.

Plusieurs options permettent de définir la valeur de recipeInstructions. Pour des raisons de clarté, nous recommandons l'utilisation de HowToStep. HowToSection peut également être utilisé pour regrouper des propriétés HowToStep lorsque la recette comporte plusieurs sections.

  • HowToStep : spécifiez les étapes de cette recette avec HowToStep. 
    "recipeInstructions": [
  {
    "@type": "HowToStep",
    "name": "Preheat",
    "text": "Heat oven to 425°F.",
    "url": "https://example.com/recipe#step1",
    "image": "https://example.com/photos/recipe/step1.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Prepare crust",
    "text": "Place 1 pie crust in ungreased 9-inch glass pie plate, pressing firmly against side and bottom.",
    "url": "https://example.com/recipe#step2",
    "image": "https://example.com/photos/recipe/step2.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Make filling",
    "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate.",
    "url": "https://example.com/recipe#step3",
    "image": "https://example.com/photos/recipe/step3.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Cover",
    "text": "Top with second crust. Cut slits or shapes in several places in top crust.",
    "url": "https://example.com/recipe#step4",
    "image": "https://example.com/photos/recipe/step4.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Bake",
    "text": "Bake 40 to 45 minutes. The pie is ready when the apples are tender and the crust is golden brown.",
    "url": "https://example.com/recipe#step5",
    "image": "https://example.com/photos/recipe/step5.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Cool",
    "text": "Cool on cooling rack at least 2 hours before serving.",
    "url": "https://example.com/recipe#step6",
    "image": "https://example.com/photos/recipe/step6.jpg"
  }
]
  • HowToSection (uniquement si une recette se fait en plusieurs parties) : permet de regrouper les étapes en plusieurs sections. Pour consulter un exemple, voir HowToSection.
  • Propriété de texte unique ou répétée : bloc de texte comprenant une ou plusieurs étapes. Google traite toutes les étapes dans une seule section. Les valeurs de propriétés répétées sont concaténées dans un seul bloc de texte. Google tente ensuite de scinder automatiquement le bloc de texte en étapes individuelles. Google tente de rechercher et de supprimer les noms de section, les numéros d'étape, les mots clés et tout élément susceptible d'apparaître de manière incorrecte dans le texte des étapes de la recette. Pour de meilleurs résultats, nous vous recommandons de spécifier les étapes avec HowToStep. 
    "recipeInstructions": [
  "In large bowl, gently mix filling ingredients; spoon into crust-lined pie
plate. Top with second crust. Cut slits or shapes in several places in top
crust. Bake 40 to 45 minutes. The pie is ready when the or until apples are
tender and the crust is golden brown. Cool on cooling rack at least 2 hours
before serving."
]

Consignes supplémentaires

  • N'incluez pas de métadonnées qui ne sont pas pertinentes. En particulier, utilisez la propriété author pour spécifier l'auteur, recipeCuisine pour la cuisine, recipeCategory pour la catégorie et keywords pour les autres mots clés.
  • N'incluez que le texte décrivant comment préparer le plat, pas de texte tel que "Instructions", "Regarder la vidéo", "Étape 1". Indiquez ces expressions en dehors des données structurées.

    Approche déconseillée :

    "recipeInstructions": [{
  "@type": "HowToStep",
  "text": "Step 1. Heat oven to 425°F."
}]

    Approche conseillée :

    "recipeInstructions": [{
  "@type": "HowToStep",
  "text": "Heat oven to 425°F."
}]
recipeYield

Text ou Integer

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, nutrition.calories).

Exemple

"recipeYield": [
  "6",
  "24 cookies"
]
totalTime

Duration

Temps total de préparation du plat, au format ISO 8601, le cas échéant.

Utilisez totalTime ou une combinaison de cookTime et prepTime.

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 est utilisé.
text Text

Instructions écrites complètes de cette étape.

Propriété facultative si l'élément itemListElement est utilisé. Consignes supplémentaires :

  • N'incluez que le texte décrivant comment préparer la recette, pas le texte tel que "Instructions", "Regarder la vidéo", "Étape 1". Spécifiez ces expressions en dehors de la propriété balisée.

    Approche déconseillée :

    {
  "@type": "HowToStep",
  "text": "Step 1. Heat oven to 425°F."
}

    Approche conseillée :

    {
  "@type": "HowToStep",
  "text": "Heat oven to 425°F."
}
Propriétés recommandées
image ImageObject ou URL

Image représentant l'étape. Consignes supplémentaires relatives aux images :

  • Les URL des images doivent être explorables et indexables.
  • Les images doivent représenter le contenu balisé.
  • Les images doivent être au format .jpg, .png ou .gif.
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

URL qui renvoie directement à l'étape (le cas échéant). Il peut, par exemple, s'agir du fragment d'un lien d'ancrage.

video VideoObject ou Clip

Vidéo représentant cette étape ou clip de la vidéo.

Pour VideoObject, suivez la liste des propriétés de vidéo ou d'extrait vidéo obligatoires et recommandées.

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

ListItem

Annotation pour une page d'élément.
ListItem.position

Integer

Position ordinale de la page d'élément dans la liste. Exemple :

"itemListElement": [
  {
    "@type": "ListItem",
    "position": 1,
  }, {
    "@type": "ListItem",
    "position": 2,
  }
]
ListItem.url

URL

URL canonique de la page d'élément. Chaque élément doit avoir une URL unique.

使用 Search Console 监控富媒体搜索结果

Search Console 是一款工具，可帮助您监控网页在 Google 搜索结果中的显示效果。即使没有注册 Search Console，您的网页也可能会显示在 Google 搜索结果中，但注册 Search Console 能够帮助您了解 Google 如何查看您的网站并做出相应的改进。建议您在以下情况下查看 Search Console：

  1. 首次部署结构化数据后
  2. 发布新模板或更新代码后
  3. 定期分析流量时

首次部署结构化数据后

等 Google 将网页编入索引后，请在相关的富媒体搜索结果状态报告中查看是否存在问题。 理想情况下，有效项目数量会增加，而无效项目数量不会增加。如果您发现结构化数据存在问题，请执行以下操作：

  1. 修正无效项目。
  2. 检查实际网址，核实问题是否仍然存在。
  3. 使用状态报告请求验证。

发布新模板或更新代码后

如果对网站进行重大更改，请监控结构化数据无效项目的增幅。
  • 如果您发现无效项目增多了，可能是因为您推出的某个新模板无法正常工作，或者您的网站以一种新的错误方式与现有模板交互。
  • 如果您发现有效项目减少了（但无效项目的增加情况并不对应），可能是因为您的网页中未再嵌入结构化数据。请通过网址检查工具了解导致此问题的原因。

定期分析流量时

请使用效果报告分析您的 Google 搜索流量。数据将显示您的网页在 Google 搜索结果中显示为富媒体搜索结果的频率、用户点击该网页的频率以及网页在搜索结果中的平均排名。您还可以使用 Search Console API 自动提取这些结果。

Dépannage

Si vous ne parvenez pas à mettre en œuvre ou à déboguer des données structurées, voici quelques ressources susceptibles de vous aider.