Dados estruturados de navegação estrutural (BreadcrumbList)

A navegação estrutural de uma página indica a posição dela na hierarquia do site e pode ajudar os usuários a entender e explorar o conteúdo on-line de maneira eficaz. O usuário pode percorrer todo o caminho na hierarquia, um nível por vez, desde a última localização na trilha de navegação estrutural.

Localização atual exibida em uma página da Web

How to add structured data

Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.

Here's an overview of how to build, test, and release structured data.

  1. Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
  2. Follow the guidelines.
  3. Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
  4. Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is accessible to Google and not blocked by a robots.txt file, the noindex tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs.
  5. To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.

Exemplos

A Pesquisa Google usa a marcação de localização atual no corpo de uma página da Web para categorizar as informações da página nos resultados da pesquisa. Geralmente, conforme ilustrado nos casos de uso a seguir, os usuários podem chegar a uma página a partir de tipos muito diferentes de consultas de pesquisa. Embora cada pesquisa possa retornar a mesma página da Web, a navegação estrutural categoriza o conteúdo dentro do contexto da consulta da Pesquisa Google. A página ancillaryjustice.html pode exibir as seguintes trilhas de navegação estrutural, dependendo do contexto da pesquisa:

Trilha de navegação estrutural única

Uma consulta de pesquisa de um prêmio com base em ano e gênero, como "Prêmio Nebula de Melhor Romance 2014", pode gerar a seguinte navegação estrutural:

Livros Ficção científica Vencedores de prêmios

JSON-LD

Veja um exemplo em JSON-LD compatível com essa navegação estrutural:


<html>
  <head>
    <title>Award Winners</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "BreadcrumbList",
      "itemListElement": [{
        "@type": "ListItem",
        "position": 1,
        "name": "Books",
        "item": "https://example.com/books"
      },{
        "@type": "ListItem",
        "position": 2,
        "name": "Science Fiction",
        "item": "https://example.com/books/sciencefiction"
      },{
        "@type": "ListItem",
        "position": 3,
        "name": "Award Winners"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa

Veja um exemplo de RDFa compatível com essa navegação estrutural:


<html>
  <head>
    <title>Award Winners</title>
  </head>
  <body>
    <ol vocab="https://schema.org/" typeof="BreadcrumbList">
      <li property="itemListElement" typeof="ListItem">
        <a property="item" typeof="WebPage"
            href="https://example.com/books">
          <span property="name">Books</span></a>
        <meta property="position" content="1">
      </li>
      ›
      <li property="itemListElement" typeof="ListItem">
        <a property="item" typeof="WebPage"
            href="https://example.com/books/sciencefiction">
          <span property="name">Science Fiction</span></a>
        <meta property="position" content="2">
      </li>
      ›
      <li property="itemListElement" typeof="ListItem">
        <span property="name">Award Winners</span>
        <meta property="position" content="3">
      </li>
    </ol>
  </body>
</html>

Microdados

Veja um exemplo em microdados compatível com essa navegação estrutural:


<html>
  <head>
    <title>Award Winners</title>
  </head>
  <body>
    <ol itemscope itemtype="https://schema.org/BreadcrumbList">
      <li itemprop="itemListElement" itemscope
          itemtype="https://schema.org/ListItem">
        <a itemprop="item" href="https://example.com/books">
            <span itemprop="name">Books</span></a>
        <meta itemprop="position" content="1" />
      </li>
      ›
      <li itemprop="itemListElement" itemscope
          itemtype="https://schema.org/ListItem">
        <a itemscope itemtype="https://schema.org/WebPage"
           itemprop="item" itemid="https://example.com/books/sciencefiction"
           href="https://example.com/books/sciencefiction">
          <span itemprop="name">Science Fiction</span></a>
        <meta itemprop="position" content="2" />
      </li>
      ›
      <li itemprop="itemListElement" itemscope
          itemtype="https://schema.org/ListItem">
        <span itemprop="name">Award winners</span>
        <meta itemprop="position" content="3" />
      </li>
    </ol>
  </body>
</html>

HTML

Veja um exemplo de um bloco de navegação estrutural em HTML na página como parte do design visual.

<html>
  <head>
    <title>Award Winners</title>
  </head>
  <body>
    <ol>
      <li>
        <a href="https://www.example.com/books">Books</a>
      </li>
      <li>
        <a href="https://www.example.com/sciencefiction">Science Fiction</a>
      </li>
      <li>
        Award Winners
      </li>
    </ol>
  </body>
</html>

Trilha de navegação estrutural múltipla

Se houver várias maneiras de navegar até uma página no site, especifique várias trilhas de navegação estrutural para uma única página. Veja um exemplo que leva a uma página de livros premiados:

Livros Ficção científica Vencedores de prêmios

Veja outra trilha de navegação estrutural que leva à mesma página:

Literatura Vencedores de prêmios

JSON-LD

Veja um exemplo de JSON-LD compatível com várias trilhas de navegação estrutural:


<html>
  <head>
    <title>Award Winners</title>
    <script type="application/ld+json">
    [{
      "@context": "https://schema.org",
      "@type": "BreadcrumbList",
      "itemListElement": [{
        "@type": "ListItem",
        "position": 1,
        "name": "Books",
        "item": "https://example.com/books"
      },{
        "@type": "ListItem",
        "position": 2,
        "name": "Science Fiction",
        "item": "https://example.com/books/sciencefiction"
      },{
        "@type": "ListItem",
        "position": 3,
        "name": "Award Winners"
      }]
    },
    {
      "@context": "https://schema.org",
      "@type": "BreadcrumbList",
      "itemListElement": [{
        "@type": "ListItem",
        "position": 1,
        "name": "Literature",
        "item": "https://example.com/literature"
      },{
        "@type": "ListItem",
        "position": 2,
        "name": "Award Winners"
      }]
    }]
    </script>
  </head>
  <body>
  </body>
</html>

RDFa

Veja um exemplo de RDFa compatível com várias trilhas de navegação estrutural:


<html>
  <head>
    <title>Award Winners</title>
  </head>
  <body>
    <ol vocab="https://schema.org/" typeof="BreadcrumbList">
      <li property="itemListElement" typeof="ListItem">
        <a property="item" typeof="WebPage"
            href="https://example.com/books">
          <span property="name">Books</span></a>
        <meta property="position" content="1">
      </li>
      ›
      <li property="itemListElement" typeof="ListItem">
        <a property="item" typeof="WebPage"
            href="https://example.com/books/sciencefiction">
          <span property="name">Science Fiction</span></a>
        <meta property="position" content="2">
      </li>
      ›
      <li property="itemListElement" typeof="ListItem">
        <a property="item" typeof="WebPage"
            href="https://example.com/books/sciencefiction/awardwinners">
          <span property="name">Award Winners</span></a>
        <meta property="position" content="3">
      </li>
    </ol>
    <ol vocab="https://schema.org/" typeof="BreadcrumbList">
      <li property="itemListElement" typeof="ListItem">
        <a property="item" typeof="WebPage"
            href="https://example.com/literature">
          <span property="name">Literature</span></a>
        <meta property="position" content="1">
      </li>
      ›
      <li property="itemListElement" typeof="ListItem">
        <span property="name">Award Winners</span>
        <meta property="position" content="2">
      </li>
    </ol>
  </body>
</html>

Microdados

Veja um exemplo de microdados compatíveis com trilhas de navegação estrutural múltiplas:


<html>
  <head>
    <title>Award Winners</title>
  </head>
  <body>
    <ol itemscope itemtype="https://schema.org/BreadcrumbList">
      <li itemprop="itemListElement" itemscope
          itemtype="https://schema.org/ListItem">
        <a itemprop="item" href="https://example.com/books">
            <span itemprop="name">Books</span></a>
        <meta itemprop="position" content="1" />
      </li>
      ›
      <li itemprop="itemListElement" itemscope
          itemtype="https://schema.org/ListItem">
        <a itemscope itemtype="https://schema.org/WebPage"
           itemprop="item" itemid="https://example.com/books/sciencefiction"
           href="https://example.com/books/sciencefiction">
          <span itemprop="name">Science Fiction</span></a>
        <meta itemprop="position" content="2" />
      </li>
      ›
      <li itemprop="itemListElement" itemscope
          itemtype="https://schema.org/ListItem">
        <a itemprop="item" href="https://example.com/books/sciencefiction/awardwinners">
          <span itemprop="name">Award Winners</span></a>
        <meta itemprop="position" content="3" />
      </li>
    </ol>
    <ol itemscope itemtype="https://schema.org/BreadcrumbList">
      <li itemprop="itemListElement" itemscope
          itemtype="https://schema.org/ListItem">
        <a itemprop="item" href="https://example.com/literature">
          <span itemprop="name">Literature</span></a>
        <meta itemprop="position" content="1" />
      </li>
      ›
      <li itemprop="itemListElement" itemscope
          itemtype="https://schema.org/ListItem">
        <span itemprop="name">Award Winners</span>
        <meta itemprop="position" content="2" />
      </li>
    </ol>
  </body>
</html>

HTML

Veja um exemplo de um bloco de navegação estrutural em HTML na página como parte do design visual.

<html>
  <head>
    <title>Award Winners</title>
  </head>
  <body>
    <ol>
      <li>
        <a href="https://www.example.com/books">Books</a>
      </li>
      <li>
        <a href="https://www.example.com/books/sciencefiction">Science Fiction</a>
      </li>
      <li>
        Award Winners
      </li>
    </ol>
    <ol>
      <li>
        <a href="https://www.example.com/literature">Literature</a>
      </li>
      <li>
        Award Winners
      </li>
    </ol>
  </body>
</html>

Diretrizes

Siga estas diretrizes e qualifique seu conteúdo para exibição com a localização atual na Pesquisa Google.

Recomendamos fornecer navegação estrutural que represente um caminho típico do usuário até uma página em vez de simplesmente espelhar a estrutura do URL. Algumas partes do caminho do URL não ajudam as pessoas a entender como a página se encaixa no site. Por exemplo, considerando o URL https://example.com/pages/books/catcher_in_the_rye.html, o caminho pages no URL não adiciona nenhuma informação, assim como o elemento de nível superior example.com.

Definições dos tipos de dados estruturados

Para especificar a navegação estrutural, defina um BreadcrumbList que contenha pelo menos dois ListItems. É necessário incluir as propriedades obrigatórias para que seu conteúdo esteja qualificado para exibição na navegação estrutural.

BreadcrumbList é o item de contêiner que tem todos os elementos da lista. A definição completa de BreadcrumbList está disponível em schema.org/BreadcrumbList (em inglês). Veja as propriedades aceitas pelo Google:

Propriedades obrigatórias
itemListElement

ListItem

É uma matriz de navegações estruturais listadas em uma ordem específica. Especifique cada navegação estrutural com um ListItem. Exemplo:

{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
  "itemListElement": [{
    "@type": "ListItem",
    "position": 1,
    "name": "Books",
    "item": "https://example.com/books"
  },{
    "@type": "ListItem",
    "position": 2,
    "name": "Authors",
    "item": "https://example.com/books/authors"
  },{
    "@type": "ListItem",
    "position": 3,
    "name": "Ann Leckie",
    "item": "https://example.com/books/authors/annleckie"
  }]
}

ListItem

ListItem contém detalhes sobre um item individual na lista. A definição completa de ListItem está disponível em schema.org/ListItem (em inglês). Veja as propriedades aceitas pelo Google:

Propriedades obrigatórias
item

URL ou um subtipo de Thing

É o URL da página da Web que representa a localização atual. Há duas maneiras de especificar item:

  • URL: especifique o URL da página. Exemplo:
    "item": "https://example.com/books"
  • Thing: use um código para especificar o URL com base no formato de marcação usado:
    • JSON-LD: use @id para especificar o URL.
    • Microdados: é possível usar href ou itemid para especificar o URL.
    • RDFa: é possível usar about, href ou resource para especificar o URL.

Se a localização atual é o último item na trilha, item não é obrigatório. Se item não for incluído no último item, o Google usará o URL da página que o contém.

name

Text

É o título da localização atual que aparece para o usuário. Se você usar Thing com name em vez de URL para especificar item, então name não é obrigatório.

position

Integer

É a posição da localização atual na trilha. A posição 1 é o começo da trilha.

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:

  1. After deploying structured data for the first time
  2. After releasing new templates or updating your code
  3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:

  1. Fix the invalid items.
  2. Inspect a live URL to check if the issue persists.
  3. Request validation using the status report.

After releasing new templates or updating your code

When you make significant changes to your website, monitor for increases in structured data invalid items.
  • If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
  • If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.

Solução de problemas

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