Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Marcar páginas de instruções com dados estruturados

Use dados estruturados HowTo para informar explicitamente ao Google que seu conteúdo apresenta instruções. As instruções orientam os usuários em várias etapas para concluir uma tarefa. Elas podem exibir vídeos, imagens e texto. Por exemplo: “Como fazer um nó de gravata” ou “Como instalar azulejos de cozinha”. Se as etapas das instruções precisarem ser lidas em sequência, talvez os dados estruturados HowTo sejam ideais para o conteúdo. Os dados estruturados HowTo são apropriados quando as instruções são o foco principal da página.

As páginas de instruções marcadas de maneira adequada podem ser qualificadas para a pesquisa aprimorada do Google e uma Ação no Google Assistente. Isso ajuda os usuários certos a encontrar seu site.

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. Para ver um guia passo a passo sobre como adicioná-los a uma página da Web, confira nosso codelab.

  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 usando o teste de pesquisa aprimorada.
  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.

Disponibilidade do recurso

No momento, a pesquisa aprimorada de instruções está disponível em todos os países e idiomas em que é possível acessar a Pesquisa Google. O recurso está disponível em dispositivos móveis e computadores.

Exemplos

Veja alguns exemplos de como seu conteúdo poderá aparecer na pesquisa aprimorada de instruções. Talvez uma variante mais visual seja exibida, caso suas instruções tenham imagens do processo completo e de cada etapa. Inclua o máximo possível de propriedades obrigatórias e recomendadas. Desse modo, suas instruções poderão ser representadas de maneira mais eficaz na Pesquisa Google.

Pesquisa aprimorada de instruções padrão

Pesquisa aprimorada de instruções padrão na Pesquisa Google
JSON-LD

Veja um exemplo de uma página de instruções com texto que usa JSON-LD. Esse exemplo tem somente uma imagem que representa o estado final das instruções. Nesse resultado, será exibida uma visualização do conteúdo de algumas etapas.



  
Microdados

Veja um exemplo de uma página de instruções baseada em texto usando microdados. Esse exemplo tem somente uma imagem que representa o estado final das instruções. Nesse resultado, será exibida uma visualização do conteúdo de algumas etapas.



  

Pesquisa aprimorada de instruções com imagens de cada etapa

Imagem de uma pesquisa aprimorada de instruções visuais
JSON-LD

Veja um exemplo de página de instruções com imagens de cada etapa usando JSON-LD. Quando há uma imagem para cada etapa, é exibida uma visualização com carrossel de imagens.



  
Microdados

Veja um exemplo de uma página de instruções com imagens de cada etapa usando microdados. Quando há uma imagem para cada etapa, é exibida uma visualização com carrossel de imagens.



  

Pesquisa aprimorada de instruções com vídeo

JSON-LD

Veja um exemplo de página de instruções com uma mistura de texto, imagens e vídeos usando JSON-LD.



  
Microdados

Veja um exemplo de uma página de instruções com uma mistura de texto, imagens e vídeos usando microdados.



  

Diretrizes

Se você quiser qualificar sua página para a pesquisa aprimorada de instruções e para a ação de instruções do Google Assistente, siga estas diretrizes:

Diretrizes de conteúdo

  • Publicidade: não use os dados estruturados HowTo para publicidade.
  • Conteúdo não qualificado: a pesquisa aprimorada de instruções não será exibida se o conteúdo for obsceno, profano, sexualmente explícito, graficamente violento, promover atividades perigosas ou ilegais ou apresentar discurso de ódio ou assédio.
  • Origem: todo o conteúdo de HowTo precisa estar visível para o usuário na página de origem. Confira se as instruções são o foco principal da página de origem. Não inclua mais de um HowTo em uma página.
  • Materiais e ferramentas: adicione dados estruturados a todos os materiais e ferramentas necessários para concluir a tarefa.
  • Etapas: cada HowToStep precisa incluir todo o conteúdo da etapa de origem. Não marque dados que não sejam relacionados a uma etapa, como resumos ou seções de introdução.
  • Imagens da etapa: se as etapas forem representadas melhor visualmente, será preciso marcar as imagens para cada HowToStep. Marque somente as imagens específicas para cada etapa, e não use a mesma imagem em várias etapas das instruções. Use imagens que correspondam ao conteúdo da sua página. Evite usar imagens que não reflitam o conteúdo das instruções ou use imagens diferentes para otimizar a pesquisa aprimorada.
  • Imagem final: se o resultado final puder ser descrito com precisão por uma imagem, ela precisará estar na página, e a marcação HowTo deverá incluí-la usando a propriedade image. Essa imagem pode ser igual à marcada para a última etapa.
  • Conteúdo: não use a marcação HowTo para receitas. Em vez disso, use Recipe structured data. Artigos e conteúdos de aconselhamento em geral que não tenham instruções específicas não são apropriados para a marcação HowTo.

Definições de tipos de dados estruturados

É necessário incluir as propriedades obrigatórias para que seu conteúdo seja qualificado para exibição na pesquisa aprimorada. Também é possível incluir as propriedades recomendadas para adicionar mais informações aos seus dados estruturados, o que pode proporcionar uma melhor experiência do usuário.

HowTo

A definição completa de HowTo está disponível em schema.org/HowTo (em inglês).

O tipo HowTo indica que a página tem instruções. Cada página precisa incluir uma definição do tipo HowTo.

Propriedades obrigatórias
name

Text

É o título das instruções. Por exemplo: "Como fazer um nó de gravata".

step HowToStep ou HowToSection

É uma matriz de elementos HowToStep que compõem as instruções completas. Cada elemento step precisa corresponder a uma etapa individual das instruções. Não marque dados que não sejam relacionados a uma etapa, como resumos ou seções de introdução. Exemplo:

  • Para especificar o texto completo de cada etapa, defina o text de cada HowToStep. As propriedades image e url e o título da etapa em name são opcionais, mas recomendados, porque contribuem para uma melhor apresentação nos resultados da pesquisa.
    
    "step":[
      {
        "@type": "HowToStep",
        "text": "Button your shirt how you'd like to wear it, then drape the tie around your neck. Make the thick end about 1/3rd longer than the short end. For formal button down shirts, it usually works best with the small end of the tie between 4th and 5th button.",
        "image": "https://example.com/1x1/photo.jpg"
      }, {
        "@type": "HowToStep",
        "text": "Cross the long end over the short end. This will form the basis for your knot.",
        "image": "https://example.com/1x1/photo.jpg"
      }, {
        "@type": "HowToStep",
        "text": "Bring the long end back under the short end, then throw it back over the top of the short end in the other direction. ",
        "image": "https://example.com/1x1/photo.jpg"
      }, {
        "@type": "HowToStep",
        "text": "Now pull the long and through the loop near your neck, forming another loop near your neck.",
        "image": "https://example.com/1x1/photo.jpg"
      }, {
        "@type": "HowToStep",
        "text": "Pull the long end through that new loop and tighten to fit! ",
        "image": "https://example.com/1x1/photo.jpg"
      }
    ]
  • Para etapas complexas, é possível incluir o name da etapa e usar HowToDirection ou HowToTip para listar subetapas individuais.
    
    "step": [
      {
        "@type": "HowToStep",
        "name": "Prepare the surfaces",
        "itemListElement": [{
          "@type": "HowToDirection",
          "text": "First please turn off the power to the kitchen and then remove everything that is on the wall, such as outlet covers, switchplates, and any other item in the area that is to be tiled."
        }, {
          "@type": "HowToDirection",
          "text": "Then clean the surface thoroughly to remove any grease or other debris and tape off the area."
        }],
        "image": {
          "@type": "ImageObject",
          "url": "https://example.com/photos/1x1/photo.jpg",
          "height": "406",
          "width": "305"
        }
      }, {
        "@type": "HowToStep",
        "name": "Plan your layout",
        "itemListElement": [{
          "@type": "HowToTip",
          "text": "The creases created up until this point will be guiding lines for creating the four walls of your planter box."
        }, {
          "@type": "HowToDirection",
          "text": "Lift one side at a 90-degree angle, and fold it in place so that the point on the paper matches the other two points already in the center."
        }, {
          "@type": "HowToDirection",
          "text": "Repeat on the other side."
        }],
        "image": {
          "@type": "ImageObject",
          "url": "https://example.com/photos/1x1/photo.jpg",
          "height": "406",
          "width": "305"
        }
      }, {
        "@type": "HowToStep",
        "name": "Prepare your and apply mortar (or choose adhesive tile)",
        "itemListElement": [{
          "@type": "HowToDirection",
          "text": "Follow the instructions on your thin-set mortar to determine the right amount of water to fill in your bucket. Once done, add the powder gradually and make sure it is thoroughly mixed."
        }, {
          "@type": "HowToDirection",
          "text": "Once mixed, let it stand for a few minutes before mixing it again. This time don't add more water. Double check your thin-set mortar instructions to make sure the consistency is right."
        }, {
          "@type": "HowToDirection",
          "text": "Spread the mortar on a small section of the wall with a trowel."
        }, {
          "@type": "HowToTip",
          "text": "Thinset and other adhesives set quickly so make sure to work in a small area."
        }, {
          "@type": "HowToDirection",
          "text": "Once it's applied, comb over it with a notched trowel."
        }],
        "image": {
          "@type": "ImageObject",
          "url": "https://example.com/photos/1x1/photo.jpg",
          "height": "406",
          "width": "305"
        }
      }, {
        "@type": "HowToStep",
        "name": "Add your tile to the wall",
        "itemListElement": [{
          "@type": "HowToDirection",
          "text": "Place the tile sheets along the wall, making sure to add spacers so the tiles remain lined up."
        }, {
          "@type": "HowToDirection",
          "text": "Press the first piece of tile into the wall with a little twist, leaving a small (usually one-eight inch) gap at the countertop to account for expansion. use a rubber float to press the tile and ensure it sets in the adhesive."
        }, {
          "@type": "HowToDirection",
          "text": "Repeat the mortar and tiling until your wall is completely tiled, Working in small sections."
        }],
        "image": {
          "@type": "ImageObject",
          "url": "https://example.com/photos/1x1/photo.jpg",
          "height": "406",
          "width": "305"
        }
      }, {
        "@type": "HowToStep",
        "name": "Apply the grout",
        "itemListElement": [{
          "@type": "HowToDirection",
          "text": "Allow the thin-set mortar to set. This usually takes about 12 hours. Don't mix the grout before the mortar is set, because you don't want the grout to dry out!"
        }, {
          "@type": "HowToDirection",
          "text": "To apply, cover the area thoroughly with grout and make sure you fill all the joints by spreading it across the tiles vertically, horizontally, and diagonally. Then fill any remaining voids with grout."
        }, {
          "@type": "HowToDirection",
          "text": "Then, with a moist sponge, sponge away the excess grout and then wipe clean with a towel. For easier maintenance in the future, think about applying a grout sealer."
        }],
        "image": {
          "@type": "ImageObject",
          "url": "https://example.com/photos/1x1/photo.jpg",
          "height": "406",
          "width": "305"
        }
      }
    ]

É uma matriz de elementos HowToSection que compõem todas as instruções deste HowTo. Exemplo:


"step":[
  {
    "@type": "HowToSection",
    "name": "Choose a Tie",
    "itemListElement": [
      {
        "@type": "HowToStep",
        "name": "Choose a color",
        "text": "Pick a tie that matches your shirt color. Contrasting colors can be fun!"
      },
      {
        "@type": "HowToStep",
        "name": "Choose a pattern",
        "text": "A tie with a pattern can add flare to your outfit. Make sure the pattern is not
                 too noisy against your shirt"
      }
    ]
  },
  {
    "@type": "HowToSection",
    "name": "Put on the Tie",
    "itemListElement": [
      {
        "@type": "HowToStep",
        "name": "Arrange the Tie",
        "text": "Stand in front of the mirror with the tie around your neck."
      },
      {
        "@type": "HowToStep",
        "name": "Tie the Tie",
        "text": "Use your hands to tie the tie into a neat knot around your neck. Looking sharp!"
      }
    ]
  }
]
Propriedades recomendadas
estimatedCost MonetaryAmount ou Text

É o custo estimado dos materiais consumidos ao seguir as instruções.

image ImageObject ou URL

É a imagem das instruções completas. 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.
supply HowToSupply ou Text

Indica um material usado nas instruções ou em uma orientação.

tool HowToTool ou Text

É um objeto usado (mas não consumido) nas instruções ou em uma orientação.

totalTime Duration

É o tempo necessário para seguir todas as instruções ou orientações, incluindo o período de preparação de materiais, no formato ISO 8601.

video VideoObject

É um vídeo de instruções. Siga a lista de propriedades de vídeo obrigatórias e recomendadas. Marque as etapas do vídeo com hasPart.


{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "video": {
    "@type": "VideoObject",
    "name": "Build a Trivia Game for the Google Assistant with No Code",
    "description": "Learn how to create a Trivia action for Assistant within minutes.",
    "thumbnailUrl": "https://example.com/photos/photo.jpg",
    "contentUrl": "https://www.youtube.com/watch?v=4AOI1tZrgMI",
    "embedUrl": "https://www.youtube.com/embed/4AOI1tZrgMI",
    "uploadDate": "2019-01-05T08:00:00+08:00",
    "duration": "P1MT10S",
    "hasPart": [
      {
        "@type": "Clip",
        "@id": "Clip1",
        "name": "Open Actions on Google Console",
        "startOffset": 29,
        "endOffset": 36,
        "url": "http://www.example.com/example?t=29"
      },
      {
        "@type": "Clip",
        "@id": "Clip2",
        "name": "Select Trivia Template",
        "startOffset": 36,
        "endOffset": 45,
        "url": "http://www.example.com/example?t=36"
      }
    ]
  }
}
video.hasPart

Clip

É um clipe que faz parte de todo o vídeo.

video.hasPart.endOffset

Number

É o horário de término do clipe exibido como o número em segundos em relação ao início do vídeo.

video.hasPart.name

Text

É o nome do clipe. Por exemplo, "Puxar e ajustar" pode ser o nome do clipe que mostra como puxar e ajustar uma gravata.

hasPart.startOffset

Number

É o horário de início do clipe exibido como o número em segundos no início do vídeo.

video.hasPart.url

URL

É um link para o horário de início do clipe. O horário de início precisa corresponder ao valor configurado em video.hasPart.startOffset. Exemplo:


"startOffset": 30,
"endOffset": 45,
"url": "http://www.example.com/example&t=30"

HowToSection

A definição completa de HowToSection está disponível em schema.org/HowToSection (em inglês).

O tipo HowToSection define uma seção de instruções e tem uma ou várias etapas. Não use HowToSection ao definir soluções diferentes para concluir uma tarefa. Use HowToSection como parte de uma única solução. Para listar maneiras diferentes de concluir uma tarefa, use vários objetos HowTo. Por exemplo, é possível listar diferentes maneiras de trocar um pneu furado como vários objetos HowTo, sem usar HowToSection.

Propriedades obrigatórias
itemListElement HowToStep

É uma lista de etapas detalhadas da seção.

name Text

É o nome da seção.

HowToStep

A definição completa de HowToStep está disponível em schema.org/HowToStep (em inglês).

O tipo HowToStep define a etapa textual simples das instruções e pode incluir uma imagem.

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. Drape the tie around your neck."
    }

    Recomendado:

    
    {
      "@type": "HowToStep",
      "text": "Drape the tie around your neck."
    }
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.
  • As imagens precisam estar em formato .jpg, .png ou .gif.
name Text

É uma palavra ou frase curta que resume a etapa (por exemplo, "Prender fios no poste" ou "Cavar"). 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 fixo.

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 obrigatórias e recomendadas.

Veja um exemplo com VideoObject:


{
  "@type": "HowToStep",
  "video": {
    "name": "Drape the tie",
    "description": "Drape the tie.",
    "thumbnailUrl": "https://example.com/photos/photo.jpg",
    "contentUrl": "http://www.example.com/videos/123_600x400.mp4",
    "embedUrl": "http://www.example.com/videoplayer?id=123",
    "uploadDate": "2019-01-05T08:00:00+08:00",
    "duration": "PT12S"
  }
}
          

Veja um exemplo com Clip:


{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Build a Trivia Game for the Google Assistant with No Code",
  "video": {
    "@type": "VideoObject",
    "name": "Build a Trivia Game for the Google Assistant with No Code",
    "description": "Learn how to create a Trivia action for Assistant within minutes.",
    "thumbnailUrl": "https://example.com/photos/photo.jpg",
    "contentUrl": "https://www.youtube.com/watch?v=4AOI1tZrgMI",
    "embedUrl": "https://www.youtube.com/embed/4AOI1tZrgMI",
    "uploadDate": "2019-01-05T08:00:00+08:00",
    "duration": "P1MT10S",
    "hasPart": [
      {
        "@type": "Clip",
        "@id": "Clip1",
        "name": "Open Actions on Google Console",
        "startOffset": 29,
        "endOffset": 36,
        "url": "http://www.example.com/example?t=29"
      },
      {
        "@type": "Clip",
        "@id": "Clip2",
        "name": "Select Trivia Template",
        "startOffset": 36,
        "endOffset": 45,
        "url": "http://www.example.com/example?t=36"
      }
    ]
  },
  "step": [
    {
      "@type": "HowToStep",
      "name": "Open Actions on Google Console",
      "video": { "@id": "Clip1" }
    },
    {
      "@type": "HowToStep",
      "name": "Select Trivia Template",
      "video": { "@id": "Clip2" }
    }
  ]
}
          

HowToSupply, HowToTool

As definições completas de HowToSupply e HowToTool estão disponíveis em schema.org/HowToSupply e schema.org/HowToTool (páginas em inglês).

HowToSupply e HowToTool são usados para completar HowTo. Eles têm as mesmas propriedades obrigatórias e recomendadas.

Propriedades obrigatórias
name Text

É o nome do material ou ferramenta.

Propriedades recomendadas
image ImageObject ou URL

É uma imagem do material ou ferramenta. 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.

HowToDirection, HowToTip

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

Use HowToDirection e HowToTip para descrever orientações ou dicas. Eles têm as mesmas propriedades obrigatórias e recomendadas.

Propriedades obrigatórias
text Text

É o texto da orientação ou dica.

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, haverá um aumento de páginas válidas e nenhum aumento de erros ou avisos. Se você encontrar problemas nos dados estruturados, faça o seguinte:

  1. Corrija os erros.
  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 erros e avisos de dados estruturados.
  • Caso você perceba um aumento nos erros, 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 erros), 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.