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.

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

Caixa de pesquisa de sitelinks em uso

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

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>

Diretrizes

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

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

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:

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

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.

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.