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 vai 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. 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" }] No entanto, isso não é padrão. 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.

Solução de problemas

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

• Se você usa um sistema de gerenciamento de conteúdo (CMS) ou se alguém está cuidando do seu site, peça ajuda para o prestador de serviço. Não se esqueça de encaminhar todas as mensagens do Search Console com os detalhes do problema.
• O Google não garante que os recursos que consomem dados estruturados vão ser exibidos nos resultados da pesquisa. Para ver uma lista de motivos comuns por que o Google pode não exibir seu conteúdo na pesquisa aprimorada, consulte as diretrizes gerais de dados estruturados.
• Pode haver um erro nos dados estruturados. Confira a lista de erros de dados estruturados e o Relatório de dados estruturados que não podem ser analisados.
• Se você recebeu uma ação manual de dados estruturados relacionada à sua página, esses dados serão ignorados, embora a página ainda possa aparecer nos resultados da Pesquisa Google. Para corrigir problemas de dados estruturados, use o Relatório de ações manuais.
• Consulte as diretrizes novamente para identificar se o conteúdo não está em conformidade com elas. O problema pode ser causado por conteúdo com spam ou uso de marcação com spam. No entanto, talvez o problema não seja de sintaxe e, por isso, o teste de pesquisa aprimorada não poderá identificá-lo.
• Resolva problemas relacionados à ausência e à queda no total de pesquisas aprimoradas.
• Aguarde algum tempo antes de voltar a rastrear e reindexar. Pode levar vários dias depois da publicação de uma página para que o Google a localize e rastreie. Para perguntas gerais sobre rastreamento e indexação, consulte as Perguntas frequentes sobre rastreamento e indexação da Pesquisa Google.
• Poste uma pergunta no fórum da Central da Pesquisa Google