Dados estruturados de receita (Recipe, HowTo, ItemList)

Use dados estruturados para informar o Google sobre suas receitas e ajudar os usu�rios a encontrar esse conte�do. Quando voc� fornece informa��es como avalia��es, tempo de preparo e informa��es nutricionais, o Google entende melhor a receita e a apresenta aos usu�rios de uma maneira mais interessante. As receitas aparecem nos resultados da pesquisa do Google e no Imagens do Google.

Uma ilustra��o de como a pesquisa aprimorada de receitas pode aparecer na Pesquisa Google. Ela tem quatro pesquisas aprimoradas de diferentes sites, com detalhes sobre quanto tempo leva para cozinhar, uma imagem e informa��es de avalia��es. Uma ilustra��o de como uma receita pode aparecer no Imagens do Google. H� seis resultados de imagens mostrando diferentes pratos, sendo que tr�s deles s�o identificados com um selo de receita.

Com base na marca��o do conte�do, suas receitas podem se qualificar para as seguintes melhorias:

Melhorias de receitas
Carrossel de host de receitas: adicione dados estruturados ItemList para que os usu�rios explorem sua galeria de receitas. Uma ilustra��o de como um carrossel de host de receitas pode aparecer na Pesquisa Google. Ela mostra tr�s receitas diferentes do mesmo site em um formato de carrossel que os usu�rios podem explorar e selecionar uma receita espec�fica.

Como adicionar dados estruturados

Os dados estruturados s�o um formato padronizado para fornecer informa��es sobre uma p�gina e classificar o conte�do dela. Caso voc� n�o saiba muito sobre o assunto, veja como os dados estruturados funcionam.

Esta � uma vis�o geral de como criar, testar e lan�ar dados estruturados.

  1. Adicione as propriedades obrigat�rias. Com base no formato que voc� est� usando, saiba onde inserir dados estruturados na p�gina.
  2. Siga as diretrizes.
  3. Valide o c�digo com o Teste de pesquisa aprimorada e corrija os erros cr�ticos. Corrija tamb�m os problemas n�o cr�ticos que possam ser sinalizados na ferramenta, porque eles podem melhorar a qualidade dos dados estruturados, mas isso n�o � necess�rio para se qualificar para pesquisas aprimoradas.
  4. Implante algumas p�ginas que incluam os dados estruturados e use a Ferramenta de inspe��o de URL para testar como o Google v� a p�gina. Verifique se a p�gina est� acess�vel ao Google e se n�o est� bloqueada por um arquivo robots.txt, pela tag noindex ou por requisitos de login. Se estiver tudo certo, pe�a ao Google para rastrear novamente seus URLs.
  5. Para informar o Google sobre mudan�as futuras, recomendamos que voc� envie um sitemap. � poss�vel automatizar isso com a API Search Console Sitemap.

Exemplos

Veja alguns exemplos de receitas que usam c�digo JSON-LD.

Receita na Pesquisa

Veja um exemplo de p�gina qualificada para ser exibida na Pesquisa.

<html>
  <head>
    <title>Non-Alcoholic Pi�a Colada</title>
    <script type="application/ld+json">
    {
      "@context": "/proxy/https://schema.org/",
      "@type": "Recipe",
      "name": "Non-Alcoholic Pi�a Colada",
      "image": [
      "/proxy/https://example.com/photos/1x1/photo.jpg",
      "/proxy/https://example.com/photos/4x3/photo.jpg",
      "/proxy/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": "/proxy/https://example.com/non-alcoholic-pina-colada#step1",
          "image": "/proxy/https://example.com/photos/non-alcoholic-pina-colada/step1.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Fill",
          "text": "Fill a glass with ice.",
          "url": "/proxy/https://example.com/non-alcoholic-pina-colada#step2",
          "image": "/proxy/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": "/proxy/https://example.com/non-alcoholic-pina-colada#step3",
          "image": "/proxy/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": [
          "/proxy/https://example.com/photos/1x1/photo.jpg",
          "/proxy/https://example.com/photos/4x3/photo.jpg",
          "/proxy/https://example.com/photos/16x9/photo.jpg"
         ],
        "contentUrl": "/proxy/https://www.example.com/video123.mp4",
        "embedUrl": "/proxy/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>

Veja um exemplo de p�gina de resumo de receitas (uma p�gina com uma lista de receitas) com dados estruturados de itemList. Esse conte�do pode ser exibido em uma grade nos resultados da Pesquisa.

<html>
  <head>
    <title>Grandma's Best Pie Recipes</title>
    <script type="application/ld+json">
    {
      "@context": "/proxy/https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "url": "/proxy/https://example.com/apple-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "url": "/proxy/https://example.com/blueberry-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "url": "/proxy/https://example.com/cherry-pie.html"
        }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Diretrizes

� preciso seguir as diretrizes gerais de dados estruturados para que sua marca��o possa ser exibida nos resultados da Pesquisa.

As diretrizes a seguir se aplicam aos dados estruturados Recipe.

  • Use dados estruturados Recipe em conte�dos sobre como preparar determinado prato. Por exemplo, "esfoliante facial" ou "ideias para festas" n�o s�o nomes v�lidos para um prato.
  • Para que as receitas apare�am em um carrossel ou em uma grade, siga estas diretrizes:
    • Forne�a dados estruturados de ItemList para resumir as receitas na sua lista. � poss�vel fornecer dados estruturados de ItemList separadamente ou em conjunto com os dados estruturados de receita.
    • Seu site precisa ter uma p�gina de resumo que liste todas as receitas da cole��o. Por exemplo, quando um usu�rio clicar no link de resumo dos resultados da Pesquisa, ser� direcionado corretamente para uma p�gina no seu site que lista as receitas relacionadas � pesquisa.

Defini��es de tipos de dados estruturados

� necess�rio incluir as propriedades obrigat�rias para que seu conte�do seja qualificado para exibi��o como uma pesquisa aprimorada. Tamb�m � poss�vel incluir as propriedades recomendadas para dar mais informa��es sobre o conte�do, o que pode proporcionar uma melhor experi�ncia do usu�rio.

Recipe

Marque o conte�do da receita com as seguintes propriedades do tipo Recipe do schema.org. A defini��o completa de Recipe est� dispon�vel em schema.org/Recipe. Veja as propriedades aceitas pelo Google:

Propriedades obrigat�rias
image

URL ou ImageObject

� a imagem do prato pronto.

Outras diretrizes para imagens:

  • Cada p�gina precisa conter pelo menos uma imagem, tendo marca��o ou n�o. O Google escolher� a melhor imagem para exibir nos resultados da Pesquisa com base na propor��o e na resolu��o.
  • Os URLs das imagens precisam ser rastre�veis e index�veis. Para verificar se o Google consegue acessar os URLs, use a Ferramenta de inspe��o de URL.
  • As imagens precisam representar o conte�do marcado.
  • O formato do arquivo precisa ser compat�vel com o Imagens do Google.
  • Para conseguir os melhores resultados, recomendamos fornecer v�rias imagens de alta resolu��o, com no m�nimo 50 mil pixels ao multiplicar a largura e a altura, nas seguintes propor��es: 16 x 9, 4 x 3 e 1 x 1.

Exemplo:

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

Text

� o nome do prato.
Propriedades recomendadas
aggregateRating

AggregateRating

� a nota da avalia��o m�dia atribu�da ao item. Siga as diretrizes de snippet de avalia��o e a lista de propriedades AggregateRating obrigat�rias e recomendadas.

Se os dados estruturados Recipe tiverem uma �nica avalia��o, o nome do avaliador ter� que ser de uma pessoa ou organiza��o v�lida. Por exemplo, "50% de desconto e ingredientes" n�o � um nome v�lido para um avaliador.
author

Person ou Organization

� o nome da pessoa ou organiza��o que escreveu a receita. Para ajudar o Google a entender melhor a autoria dos v�rios recursos, siga as pr�ticas recomendadas de marca��o de autores.
cookTime

Duration

O tempo que leva para cozinhar o prato, no formato ISO 8601, se aplic�vel.

Use sempre em combina��o com prepTime.

datePublished

Date

A data em que a receita foi publicada, no formato ISO 8601, se aplic�vel.
description

Text

� um pequeno resumo descrevendo o prato.
keywords

Text

S�o outros termos para a receita, como uma esta��o do ano ("ver�o"), uma data comemorativa ("Natal") ou outros descritores ("r�pido", "f�cil", "aut�ntico").

Diretrizes adicionais

  • Separe v�rias entradas em uma lista de palavras-chave com v�rgulas.
  • N�o use uma tag que seja, na verdade, recipeCategory ou recipeCuisine.

    N�o recomendado:

    "keywords": "dessert, American"

    Recomendado:

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

Energy

� a quantidade de calorias em cada por��o desta receita. Se nutrition.calories estiver definido, recipeYield precisa ser definido com o n�mero de por��es.
prepTime

Duration

� o tempo que leva para preparar os ingredientes e o espa�o de trabalho do prato, no formato ISO 8601, se aplic�vel.

Use sempre em combina��o com cookTime.
recipeCategory

Text

� o tipo de refei��o ou prato da receita. Por exemplo: "jantar", "prato principal" ou "sobremesa, lanche".
recipeCuisine

Text

� a regi�o associada � receita. Por exemplo, "francesa", "mediterr�nea" ou "americana".
recipeIngredient

Text

� um ingrediente usado na receita.

Exemplo:

"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"
]

Diretrizes adicionais:

  • Inclua somente os ingredientes necess�rios para fazer a receita.
  • N�o inclua informa��es desnecess�rias, como uma defini��o do ingrediente.
recipeInstructions

HowToStep, HowToSection ou Text

S�o as etapas para preparar o prato.

Existem v�rias op��es para definir o valor de recipeInstructions. Recomendamos o uso de HowToStep HowToSection tamb�m pode ser usado para agrupar HowToSteps se a receita tiver se��es.

  • HowToStep: especifique as etapas da receita com HowToStep. 
    "recipeInstructions": [
  {
    "@type": "HowToStep",
    "name": "Preheat",
    "text": "Heat oven to 425�F.",
    "url": "/proxy/https://example.com/recipe#step1",
    "image": "/proxy/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": "/proxy/https://example.com/recipe#step2",
    "image": "/proxy/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": "/proxy/https://example.com/recipe#step3",
    "image": "/proxy/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": "/proxy/https://example.com/recipe#step4",
    "image": "/proxy/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": "/proxy/https://example.com/recipe#step5",
    "image": "/proxy/https://example.com/photos/recipe/step5.jpg"
  }, {
    "@type": "HowToStep",
    "name": "Cool",
    "text": "Cool on cooling rack at least 2 hours before serving.",
    "url": "/proxy/https://example.com/recipe#step6",
    "image": "/proxy/https://example.com/photos/recipe/step6.jpg"
  }
]
  • HowToSection (somente se uma receita tiver v�rias se��es): use para agrupar as etapas em v�rias se��es. Visite HowToSection para ver um exemplo.
  • Propriedade de texto �nica ou repetida: � um bloco de texto que inclui uma ou mais etapas. O Google trata todas as etapas como uma �nica se��o. Os valores de propriedade repetida s�o concatenados em um �nico bloco de texto. Depois disso, o Google tenta dividir automaticamente esse bloco em etapas individuais. O Google tenta encontrar e remover nomes de se��o, n�meros de etapas, palavras-chave e outros itens que possam aparecer incorretamente no texto da etapa da receita. Para melhores resultados, recomendamos que voc� use HowToStep para especificar etapas sem ambiguidade. 
    "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."
]

Diretrizes adicionais

  • N�o inclua metadados que perten�am a outro lugar. Use a propriedade author para especificar o autor, recipeCuisine para o tipo de culin�ria, recipeCategory para a categoria e keywords para outras palavras-chave.
  • Inclua somente texto sobre como fazer o prato, e n�o outros trechos, como "Instru��es", "Assista ao v�deo", "Etapa 1". Especifique essas frases fora dos dados estruturados.

    N�o recomendado:

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

    Recomendado:

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

Text ou Integer

A quantidade produzida pela receita, se aplic�vel. Especifique o n�mero de por��es produzidas a partir dessa receita com apenas um n�mero. Se voc� quiser usar uma unidade diferente (por exemplo, o n�mero de itens), inclua rendimentos adicionais. Isso � necess�rio se voc� especificar qualquer informa��o alimentar por por��o (como nutrition.calories).

Exemplo

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

Duration

� o tempo total necess�rio para preparar e cozinhar o prato, no formato ISO 8601, se aplic�vel.

Use totalTime ou uma combina��o de cookTime e prepTime.
video VideoObject

� um v�deo que demonstra as etapas de prepara��o do prato. Siga a lista de propriedades de v�deo obrigat�rias e recomendadas.

HowToSection

Use HowToSection para agrupar uma sequ�ncia de etapas (ou subse��es) que comp�em parte das instru��es de uma receita. Especifique HowToSection diretamente na defini��o da propriedade recipeInstructions ou como itemListElement de outro HowToSection.

O tipo HowToSection define uma se��o de uma �nica receita e cont�m uma ou v�rias etapas. N�o use HowToSection para definir receitas diferentes para o mesmo prato. Em vez disso, use HowToSection como parte de uma �nica receita. Para listar diversas receitas de um mesmo prato, use v�rios objetos Recipe. Por exemplo, para v�rias maneiras de fazer uma torta de ma��, liste-as como v�rios objetos Recipe, e n�o HowToSection.

A defini��o completa de HowToSection est� dispon�vel em schema.org/HowToSection (em ingl�s).

Propriedades obrigat�rias
itemListElement HowToStep

� uma lista de etapas detalhadas para a se��o e/ou as subse��es. Por exemplo, uma receita de pizza pode ter uma se��o de etapas para fazer a massa, uma para preparar o recheio e outra para montar e assar.

Exemplo:

{
  "@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

� o nome da se��o.

HowToStep

Use HowToStep para agrupar uma ou mais frases que expliquem como fazer parte da receita, se isso fizer sentido para seu conte�do. Defina a propriedade text com as frases ou, alternativamente, defina itemListElement com HowToDirection ou HowToTip para cada uma delas.

Marque as etapas da receita com as seguintes propriedades do tipo HowToStep. Especifique HowToStep diretamente na defini��o da propriedade recipeInstructions ou como itemListElement de HowToSection.

A defini��o completa de HowToStep est� dispon�vel em schema.org/HowToStep (em ingl�s).

Propriedades obrigat�rias
itemListElement HowToDirection ou HowToTip

� uma lista de subetapas detalhadas, incluindo orienta��es ou dicas.

Essa propriedade � opcional quando text � usado.
text Text

� o texto de instru��es completo desta etapa.

Essa propriedade � opcional quando itemListElement � usado. Diretrizes adicionais:

  • Inclua somente texto de instru��es e n�o inclua outros textos, como "Instru��es", "Assista o v�deo", "Etapa 1". Especifique essas frases fora da propriedade marcada.

    N�o recomendado:

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

    Recomendado:

    {
  "@type": "HowToStep",
  "text": "Heat oven to 425�F."
}
Propriedades recomendadas
image ImageObject ou URL

� a imagem da etapa. Outras diretrizes para imagens:

  • Os URLs das imagens precisam ser rastre�veis e index�veis.
  • As imagens precisam representar o conte�do marcado.
  • Elas t�m que estar em formato .jpg, .png ou .gif.
name Text

� uma palavra ou frase curta que resume a etapa (por exemplo, "sovar a massa"). Evite usar texto n�o descritivo (por exemplo, "Etapa 1: [texto]") ou outra forma de numera��o (por exemplo, "1. [texto]").

url URL

� o URL que direciona � etapa (se houver). Por exemplo: um fragmento de link �ncora.

video VideoObject ou Clip

� um v�deo da etapa ou um clipe do v�deo.

Para VideoObject, siga a lista de propriedades de v�deo ou clipe obrigat�rias e recomendadas.

HowToDirection e HowToTip

Use HowToDirection e HowToTip para descrever orienta��es ou dicas, se aplic�vel. Eles t�m as mesmas propriedades obrigat�rias e recomendadas.

As defini��es completas de HowToDirection e HowToTip est�o dispon�veis em schema.org/HowToDirection e schema.org/HowToTip (p�ginas em ingl�s).

Propriedades obrigat�rias
text Text

� o texto da orienta��o ou dica.

ItemList

Al�m das propriedades de receita, adicione as propriedades a seguir para listas espec�ficas de host. Ainda que ItemList n�o seja obrigat�ria, � necess�rio adicionar as seguintes propriedades se quiser que sua receita seja qualificada para um carrossel de host. Para mais informa��es sobre o carrossel do host, consulte Carrossel.

A defini��o completa de ItemList est� dispon�vel em schema.org/ItemList (em ingl�s).

Propriedades obrigat�rias
itemListElement

ListItem

� a anota��o para uma �nica p�gina de itens.
ListItem.position

Integer

� a posi��o ordinal da p�gina de itens na lista. Exemplo:

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

URL

� o URL can�nico da p�gina de itens. Cada item precisa ter um URL exclusivo.

Monitorar pesquisas aprimoradas com o Search Console

O Search Console � uma ferramenta que ajuda voc� a monitorar o desempenho das suas p�ginas na Pesquisa Google. N�o � preciso se inscrever na plataforma para ser inclu�do nos resultados da Pesquisa Google, mas isso pode ajudar voc� a entender e melhorar como vemos seu site. Recomendamos verificar o Search Console nos seguintes casos:

  1. Depois de implantar os dados estruturados pela primeira vez
  2. Depois de lan�ar novos modelos ou atualizar o c�digo
  3. An�lise peri�dica do tr�fego

Depois de implantar os dados estruturados pela primeira vez

Depois que o Google indexar as p�ginas, procure problemas com o relat�rio de status da pesquisa aprimorada relevante. Em condi��es ideais, vai haver um aumento de itens v�lidos e nenhum aumento de itens inv�lidos. Se voc� encontrar problemas nos dados estruturados, fa�a o seguinte:

  1. Corrija os itens inv�lidos.
  2. Inspecione um URL ativo para verificar se o problema persiste.
  3. Solicite a valida��o com o relat�rio de status.

Depois de lan�ar novos modelos ou atualizar o c�digo

Ao fazer mudan�as significativas no site, monitore aumentos nos itens inv�lidos de dados estruturados.
  • Caso voc� perceba um aumento nos itens inv�lidos, talvez tenha lan�ado um novo modelo que n�o funcione ou o site esteja interagindo com o modelo existente de uma maneira nova e incorreta.
  • Caso voc� veja uma diminui��o nos itens v�lidos (n�o correspondidos por um aumento nos itens inv�lidos), talvez n�o esteja mais incorporando os dados estruturados �s p�ginas. Use a Ferramenta de inspe��o de URL para saber o que est� causando o problema.

An�lise peri�dica do tr�fego

Analise o tr�fego da Pesquisa Google com o Relat�rio de desempenho. Os dados v�o mostrar com que frequ�ncia sua p�gina aparece como aprimorada na Pesquisa, com que frequ�ncia os usu�rios clicam nela e qual � a posi��o m�dia dela nos resultados. Tamb�m � poss�vel extrair automaticamente esses resultados com a API Search Console.

Solu��o de problemas

Se voc� tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que podem ajudar.