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. Pour consulter un guide détaillé sur l'ajout de données structurées à une page Web, accédez à cet atelier de programmation.

  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": "2018-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": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-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 :

  • Chaque page doit contenir au moins une image (que vous incluiez ou non un balisage). Google choisit la meilleure image à afficher dans les résultats de recherche en fonction du format et de la résolution.
  • 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

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, 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.

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 :

  1. Après avoir déployé des données structurées pour la première fois
  2. Après avoir publié de nouveaux modèles ou après avoir mis à jour votre code
  3. 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 :

  1. Corrigez les éléments non valides.
  2. Inspectez une URL active pour vérifier si le problème persiste.
  3. 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.

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.