Dados estruturados de caixa de pesquisa de sitelinks (WebSite)

Uma caixa de pesquisa de sitelinks é uma maneira rápida de as pessoas pesquisarem no seu site ou app diretamente na página de resultados da pesquisa. Essa caixa implementa sugestões em tempo real e outros recursos.

A Pesquisa Google pode mostrar uma caixa de pesquisa com escopo definido para seu site automaticamente quando ele aparecer como um resultado da pesquisa, sem que você precise fazer mais nada para que isso aconteça. Essa caixa tem a tecnologia da Pesquisa Google. No entanto, você pode fornecer informações explicitamente adicionando os dados estruturados WebSite, o que pode ajudar o Google a entender melhor seu site.

Se a Pesquisa Google já exibiu uma caixa de pesquisa de sitelinks para seu site, é possível controlar alguns aspectos da caixa adicionando dados estruturados WebSite.

Importante: o Google não garante a exibição da caixa de pesquisa de sitelinks nos resultados. Além disso, o uso da marcação da caixa de pesquisa de sitelinks não aumenta a probabilidade de uma caixa ser exibida. Para ver uma lista de motivos comuns por que o Google pode não exibir dados estruturados nos resultados da pesquisa, leia as diretrizes gerais de dados estruturados.

Como implementar a caixa de pesquisa de sitelinks

Siga estas etapas para tornar seu site qualificado para exibição com uma caixa de pesquisa nos resultados da Pesquisa Google:

1. Instale um mecanismo de pesquisa ativo no seu site ou app para Android.

   As consultas de pesquisa de sitelinks levam o usuário à página de resultados da pesquisa no seu site ou app. Portanto, é necessário ter um mecanismo de pesquisa em funcionamento para ativar esse recurso.

   • Sites: configure um mecanismo de pesquisa no seu site. Esse recurso encaminha a consulta do usuário ao seu destino usando a sintaxe especificada nos dados estruturados. O mecanismo de pesquisa precisa ser compatível com consultas codificadas em UTF-8.
   • Apps: consulte a Visão geral da pesquisa no site do desenvolvedor Android e saiba como implementar um mecanismo de pesquisa em um app. O app para Android precisa ser compatível com uma intent ACTION_VIEW dos resultados da pesquisa, e o URI de dados correspondente precisa ser especificado na propriedade potentialAction.target da marcação.
2. Implemente o elemento de dados estruturados WebSite na página inicial do seu site. Para a ativação do recurso, é preciso que o app tenha um site associado, mesmo que seja um site de uma única página. Confira algumas outras diretrizes:
   • Adicione essa marcação somente à página inicial, não às outras páginas.
   • Se você já está implementando dados estruturados WebSite para o recurso de nomes de sites, aninhe as propriedades de nome do site no mesmo nó. Em outras palavras, evite criar outro bloco de dados estruturados WebSite na página inicial, se possível.
   • Sempre especifique um SearchAction para o site. Você pode especificar outro, se ele for compatível com a pesquisa em apps. É necessário sempre ter um SearchAction para o site, mesmo que o app seja o destino de pesquisa preferencial. Isso garantirá que o resultado da pesquisa direcione para o site se o usuário não estiver pesquisando em um smartphone Android ou não tiver o app Android instalado.
   • Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
   Usando um CMS? Talvez seja mais fácil usar um plug-in integrado ao CMS.
   Usando JavaScript? Saiba como gerar dados estruturados com JavaScript.
3. Siga as diretrizes.
4. Valide o código com o Teste de pesquisa aprimorada.
5. Verifique a implementação do mecanismo de pesquisa. Para isso, copie o URL WebSite.potentialAction.target dos dados estruturados, substitua {search_term_string} por uma consulta de teste e navegue até esse URL em um navegador da Web. Por exemplo, se o endereço do site for example.com e você quiser testar a consulta "kittens" (gatinhos), navegue até https://www.example.com/search/?q=kittens.
   Observação: neste documento, usamos q como a chave de parâmetro de URL para {search_term_string}, mas pode ser qualquer string permitida pela RFC 3986 no componente de consulta de um URL. Se você preferir, também pode usar cheesey_query={search_term_string}.
6. Defina um URL canônico preferencial para a página inicial do domínio usando o elemento do link rel="canonical" em todas as variantes dessa página. Isso ajuda a Pesquisa Google a escolher o URL correto para sua marcação. O servidor precisa ser compatível com a codificação de caracteres UTF-8.
7. Para apps, ative os filtros de intent necessários para que sejam compatíveis com o URL especificado no app de destino da sua marcação. Veja um exemplo de como criar filtros de intent para URLs da Pesquisa Google em Indexação de apps do Firebase para Android.
8. Implante algumas páginas que incluam seus dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Confirme 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.
   Observação: aguarde a conclusão do novo rastreamento e da reindexação. Pode levar vários dias depois da publicação de uma página para que o Google a localize e rastreie.
9. Para manter o Google informado sobre alterações futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.

Exemplo

Veja um exemplo de resultado da pesquisa para "Pinterest" no Google que retorna uma caixa de pesquisa de sitelinks para o site do Pinterest:

Observação: talvez a aparência real nos resultados da pesquisa seja diferente. É possível ver uma prévia da maioria dos recursos com o teste de pesquisa aprimorada.

Veja abaixo alguns exemplos de marcações que implementam uma caixa de pesquisa de sitelinks que usa um mecanismo de pesquisa personalizado do site:

JSON-LD

Veja um exemplo em JSON-LD:

<html> <head> <title>The title of the page</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebSite", "url": "https://www.example.com/", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://query.example.com/search?q={search_term_string}" }, "query-input": "required name=search_term_string" } } </script> </head> <body> </body> </html>

<html>
  <head>
    <title>The title of the page</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "WebSite",
      "url": "https://www.example.com/",
      "potentialAction": {
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://query.example.com/search?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Microdados

Veja um exemplo em microdados:

<div itemscope itemtype="https://schema.org/WebSite"> <meta itemprop="url" content="https://www.example.com/"/> <form itemprop="potentialAction" itemscope itemtype="https://schema.org/SearchAction"> <meta itemprop="target" content="https://query.example.com/search?q={search_term_string}"/> <input itemprop="query-input" type="text" name="search_term_string" required/> <input type="submit"/> </form> </div>

<div itemscope itemtype="https://schema.org/WebSite">
  <meta itemprop="url" content="https://www.example.com/"/>
  <form itemprop="potentialAction" itemscope itemtype="https://schema.org/SearchAction">
    <meta itemprop="target" content="https://query.example.com/search?q={search_term_string}"/>
    <input itemprop="query-input" type="text" name="search_term_string" required/>
    <input type="submit"/>
  </form>
</div>
  

Veja um exemplo de site e app em JSON-LD:

<html> <head> <title>The title of the page</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebSite", "url": "https://www.example.com/", "potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://query.example.com/search?q={search_term_string}" }, "query-input": "required name=search_term_string" },{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "android-app://com.example/https/query.example.com/search/?q={search_term_string}" }, "query-input": "required name=search_term_string" }] } </script> </head> <body> </body> </html>

<html>
  <head>
    <title>The title of the page</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "WebSite",
      "url": "https://www.example.com/",
      "potentialAction": [{
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://query.example.com/search?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      },{
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "android-app://com.example/https/query.example.com/search/?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Diretrizes

Siga estas diretrizes para qualificar o site para exibição na pesquisa aprimorada.

Aviso: caso seu site viole uma ou mais destas diretrizes, o Google poderá realizar ações manuais em relação a ele. Após solucionar o problema, envie o site para reconsideração.

• Fundamentos da Pesquisa
• Diretrizes gerais de dados estruturados

Impedir que uma caixa de pesquisa de sitelinks seja exibida

A Pesquisa Google pode adicionar uma caixa de pesquisa de sitelinks ao seu site mesmo que ele não inclua os dados estruturados descritos aqui. No entanto, é possível impedir esse comportamento adicionando a seguinte tag meta à sua página inicial:

<meta name="google" content="nositelinkssearchbox">

A caixa de pesquisa de sitelinks será desativada como parte do rastreamento e processamento normais da página feitos pelo Googlebot. Essa desativação pode demorar algumas semanas, dependendo do site e de outros fatores.

Definições de tipos de dados estruturados

Para tornar seu conteúdo qualificado para exibição com uma caixa de pesquisa de sitelinks, inclua as propriedades obrigatórias.

Tipo WebSite modificado

A Pesquisa Google usa um tipo de dados estruturados WebSite modificado para caixas de pesquisa de sites e apps. A definição completa de WebSite está disponível em schema.org (em inglês), mas o tipo que a Pesquisa Google utiliza é um pouco diferente do padrão. Veja as propriedades aceitas pelo Google:

Propriedades obrigatórias
potentialAction	Matriz de um ou dois objetos SearchAction Este objeto descreve o URI para enviar a consulta, bem como a sintaxe da solicitação enviada. É necessário implementar uma página da Web ou um gerenciador de intent que possa receber a solicitação e realizar uma pesquisa na string enviada. Se o usuário não estiver em um app Android (ou estiver, mas não houver um destino de intent do Android especificado), a caixa de pesquisa enviará a versão de site da consulta ao local especificado. Se o usuário estiver em um dispositivo Android e tiver especificado um URI de intent do Android, a caixa de pesquisa enviará essa intent. Crie um SearchAction de site para ativar o caso de pesquisa em computadores. Se você também oferecer compatibilidade com a pesquisa em apps, poderá especificar um objeto SearchAction para seu app. Cada objeto SearchAction precisa conter as seguintes propriedades aninhadas: potentialAction.@type potentialAction.target potentialAction.query-input Exemplo de site O exemplo a seguir envia uma solicitação GET para https://query.example.com/search?q=user%20search%20string. "potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://query.example.com/search?q={search_term_string}" }, "query-input": "required name=search_term_string" }] Exemplo de app O exemplo a seguir envia uma intent do Android para android-app://com.example/https/query.example.com/search/?q=user_search_string. "potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "android-app://com.example/https/query.example.com/search/?q={search_term_string}" }, "query-input": "required name=search_term_string" }]
potentialAction.query-input	Text Use a string literal required name = search-term ou qualquer marcador usado em target. Confira se os dois valores de marcador correspondem. Por exemplo, os dois valores de marcador nas propriedades target e query-input usam a string search-term: "potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://query.example.com/search?q={search-term}" }, "query-input": "required name=search-term" }] query-input é uma propriedade com anotação. Consulte a página Potential Actions para mais informações.
potentialAction.target	EntryPoint Um objeto EntryPoint com uma propriedade urlTemplate. O urlTemplate precisa ser uma string neste formato: search_handler_uri{search_term_string} Exemplo: https://query.example.com/search?q={search_term_string} search_handler_uri Para sites, é o URL do gerenciador que recebe e gerencia a consulta de pesquisa. Para apps, é o URI do gerenciador de intent do mecanismo de pesquisa que gerencia as consultas. search_term_string É uma string de marcador que é substituída pela consulta de pesquisa do usuário quando ele clica no botão "Pesquisar" da caixa de pesquisa. Todas as strings de marcador usadas aqui precisam corresponder ao valor do elemento name da propriedade query-input. O Google também é compatível com um formato abreviado dessa propriedade, em que você pode fornecer Text diretamente no potentialAction.target, e o Google o expande em urlTemplate. Por exemplo: "potentialAction": [{ "@type": "SearchAction", "target": "android-app://com.example/https/query.example.com/search/?q={search_term_string}", "query-input": "required name=search_term_string" }] Mas esse não é o padrão, e o Google aceita essa opção principalmente para simplificar os microdados. Para melhores resultados, inclua todo o objeto EntryPoint.
url	URL Especifica o URL do site que está sendo pesquisado. Defina como a página inicial canônica do seu site. Exemplo: https://www.example.org

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.

Aviso: não use links em cache para depurar as páginas. Em vez disso, utilize a Ferramenta de inspeção de URL, que tem a versão mais atualizada delas.

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.

问题排查

如果您在实施或调试结构化数据时遇到问题，请查看下面列出的一些实用资源。

• 如果您使用了内容管理系统 (CMS) 或其他人负责管理您的网站，请向其寻求帮助。请务必向其转发列明问题细节的任何 Search Console 消息。
• Google 不能保证使用结构化数据的功能一定会显示在搜索结果中。如需查看导致 Google 无法将您的内容显示为富媒体搜索结果的各种常见原因，请参阅结构化数据常规指南。
• 您的结构化数据可能存在错误。请参阅结构化数据错误列表。
• 如果您的网页受到结构化数据手动操作的影响，其中的结构化数据将会被忽略（但该网页仍可能会出现在 Google 搜索结果中）。如需修正结构化数据问题，请使用“人工处置措施”报告。
• 再次查看相关指南，确认您的内容是否未遵循指南。问题可能是因为出现垃圾内容或使用垃圾标记导致的。不过，问题可能不是语法问题，因此富媒体搜索结果测试无法识别这些问题。
• 针对富媒体搜索结果缺失/富媒体搜索结果总数下降进行问题排查。
• 请等待一段时间，以便 Google 重新抓取您的网页并重新将其编入索引。请注意，网页发布后，Google 可能需要几天时间才会找到和抓取该网页。有关抓取和索引编制的常见问题，请参阅 Google 搜索抓取和索引编制常见问题解答。
• 在 Google 搜索中心论坛中发帖提问。